Returns the first key-value pair from the named Network Information Services (NIS) map in the named domain.
C Library (libc.a)
The yp_first routine returns the first key-value pair from the named NIS map in the named domain.
Item | Description |
---|---|
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. |
outkey | Specifies the address of the uninitialized string pointer where the first key is returned. Memory is allocated by the NIS client using the malloc subroutine, and may be freed by the application. |
outkeylen | Returns the length, in bytes, of the outkey parameter. |
outval | Specifies the address of the uninitialized string pointer where the value associated with the key is returned. Memory is allocated by the NIS client using the malloc subroutine, and may be freed by the application. |
outvallen | Returns the length, in bytes, of the outval parameter. |
Upon successful completion, this subroutine returns a value of 0. If unsuccessful, it returns an error as described in the rpcsvc/yp_prot.h file.