netid(4) [opensolaris man page]

netid(4)							   File Formats 							  netid(4)

NAME

       netid - netname database

SYNOPSIS

       /etc/netid

DESCRIPTION

       The  netid file is a local source of information on mappings between netnames (see secure_rpc(3NSL)) and user ids or hostnames in the local
       domain. The netid file can be used in conjunction with, or instead of, the  network source: NIS or  NIS+. The  publickey entry in the  nss-
       witch.conf (see	nsswitch.conf(4)) file determines which of these sources will be queried by the system to translate netnames to local user
       ids or hostnames.

       Each entry in the netid file is a single line of the form:

	 netname uid:gid, gid, gid...

       or

	 netname       0:hostname

       The first entry associates a local user id with a netname. The second entry associates a hostname with a netname.

       The  netid file field descriptions are as follows:

       netname	   The operating system independent network name for the user or host. netname has one of two formats.	The format used to specify
		   a host is of the form:

		   unix.hostname@domain

		   where  hostname is the name of the host and	domain is the network domain name.

		   The format used to specify a user id is of the form:

		   unix.uid@domain

		   where uid is the numerical id of the user and domain is the network domain name.

       uid	   The numerical id of the user (see   passwd(4)). When specifying a host name, uid is always zero.

       group	   The	numerical  id  of  the group the user belongs to (see  group(4)). Several groups, separated by commas, may be listed for a
		   single uid.

       hostname    The local hostname (see  hosts(4)).

       Blank lines are ignored.  Any part of a line to the right of a `#' symbol is treated as a comment.

EXAMPLES

       Example 1 A sample netid file.

       Here is a sample netid file:

	 unix.789@West.Sun.COM	  789:30,65
	 unix.123@Bldg_xy.Sun.COM 123:20,1521
	 unix.candlestick@campus1.bayarea.EDU	 0:candlestick

FILES

       /etc/group	 groups file

       /etc/hosts	 hosts database

       /etc/netid	 netname database

       /etc/passwd	 password file

       /etc/publickey	 public key database

SEE ALSO

       netname2user(3NSL), secure_rpc(3NSL), group(4), hosts(4), nsswitch.conf(4), passwd(4), publickey(4)

SunOS 5.11							    23 May 1994 							  netid(4)

getpublickey(3NSL)				       Networking Services Library Functions					getpublickey(3NSL)

NAME

       getpublickey, getsecretkey, publickey - retrieve public or secret key

SYNOPSIS

       #include <rpc/rpc.h>
       #include <rpc/key_prot.h>

       int getpublickey(const char netname[MAXNETNAMELEN], char publickey[HEXKEYBYTES+1]);

       int getsecretkey(const char netname[MAXNETNAMELEN], char secretkey[HEXKEYBYTES+1], const char *passwd);

DESCRIPTION

       getpublickey() and getsecretkey() get public and secret keys for netname. The key may come from one of the following sources:

	 o  the /etc/publickey file. See publickey(4).

	 o  the NIS map ``publickey.byname'' or the NIS+ table ``cred.org_dir''. The sources and their lookup order are specified in the /etc/nss-
	    witch.conf file. See nsswitch.conf(4).

       getsecretkey() has an extra argument, passwd, which is used to decrypt the encrypted secret key stored in the database.

RETURN VALUES

       Both routines return 1 if they are successful in finding the key. Otherwise, the routines return 0. The keys are  returned  as  null-termi-
       nated,  hexadecimal  strings. If the password supplied to getsecretkey() fails to decrypt the secret key, the routine will return 1 but the
       secretkey [0] will be set to NULL.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       secure_rpc(3NSL), nsswitch.conf(4), publickey(4), attributes(5)

WARNINGS

       If getpublickey() gets the public key from any source other than NIS+, all authenticated NIS+ operations may fail. To ensure that this does
       not happen, edit the nsswitch.conf(4) file to make sure that the public key is obtained from NIS+.

   NOTES
       NIS+  might  not  be  supported in future releases of the SolarisTM Operating Environment. Tools to aid the migration from NIS+ to LDAP are
       available in the Solaris 9 operating environment. For more information, visit http://www.sun.com/directory/nisplus/transition.html.

SunOS 5.10							    18 Dec 2001 						getpublickey(3NSL)