yp_master Subroutine

Communications Technical Reference, Volume 1

yp_master Subroutine

Purpose

Returns the machine name of the Network Information Services (NIS) master server for a map.

Library

C Library (libc.a)

Syntax

#include <rpcsvc/ypclnt.h>
#include <rpcsvc/yp_prot.h>

yp_master (indomain, inmap, outname)
char *indomain;
char *inmap;
char **outname;

Description

The yp_master subroutine returns the machine name of the NIS master server for a map.

Parameters

indomain	Points to the name of the domain used as input to the subroutine.
inmap	Points to the name of the map used as input to the subroutine.
outname	Specifies the address of the uninitialized string pointer where the name of the domain's yp_master server is returned. Memory is allocated by the NIS client using the malloc subroutine, and may be freed by the application.

Return Values

Upon successful completion, this subroutine returns a value of 0. If unsuccessful, it returns one of the error codes described in the rpcsvc/yp_prot.h file.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The malloc subroutine.

Network Information Service (NIS) Overview for System Management in AIX Version 4.3 System Management Guide: Communications and Networks.

List of NIS Programming References and Remote Procedure Call (RPC) Overview for Programming in AIX Version 4.3 Communications Programming Concepts.