yp_first(3) [php man page]

YP_FIRST(3)								 1							       YP_FIRST(3)

yp_first - Returns the first key-value pair from the named map

SYNOPSIS

       array yp_first (string  $domain, string	$map)

DESCRIPTION

	Gets the first key-value pair from the named $map in the named $domain.

PARAMETERS

	      o $domain
		- The NIS domain name.

	      o $map
		- The NIS map.

RETURN VALUES

	Returns the first key-value pair as an array on success, or FALSE on errors.

EXAMPLES

       Example #1

	      Example for the NIS first

	      <?php
	      $entry = yp_first($domain, "passwd.byname");

	      $key = key($entry);
	      $value = $entry[$key];

	      echo "First entry in this map has key " . $key . " and value " . $value;
	      ?>

SEE ALSO

       yp_next(3), yp_get_default_domain(3).

PHP Documentation Group 													       YP_FIRST(3)

ypmatch(1)							   User Commands							ypmatch(1)

NAME

       ypmatch - print the value of one or more keys from a NIS map

SYNOPSIS

       ypmatch [-k] [-t] [-d domain] key [key...] mname

       ypmatch -x

DESCRIPTION

       ypmatch	prints	the values associated with one or more keys from the NIS's name services map specified by mname, which may be either a map
       name or a map nickname.

       Multiple keys can be specified; all keys will be searched for in the same map. The keys must be the same case and length. No pattern match-
       ing is available. If a key is not matched, a diagnostic message is produced.

OPTIONS

       The following options are supported:

       -k	       Before printing the value of a key, print the key itself, followed by a colon (:).

       -t	       Inhibit map nickname translation.

       -d domain       Specify a domain other than the default domain.

       -x	       Display	the  map nickname table. This lists the nicknames the command knows of, and indicates the map name associated with
		       each nickname.

OPERANDS

       The following operand is supported:

       mname	The NIS's name services map

EXIT STATUS

       The following exit values are returned:

       0	Successful operation.

       1	An error occurred.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWnisu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ypcat(1), ypfiles(4), attributes(5)

NOTES

       ypmatch will fail with an RPC error message on yp operation if enough file descriptors are not available. The number  of  file  descriptors
       should be increased if this occurs.

SunOS 5.10							    22 Aug 1997 							ypmatch(1)