NETID(5)                  OpenBSD Programmer's Manual                 NETID(5)

NAME
     netid - YP network credential file

DESCRIPTION
     The file /etc/netid consists of newline separated ASCII records.  Each
     record consists of a key, a single blank character, and a value.  The key
     and the value may be arbitrary strings except that neither may contain
     blank characters.

     Records in the file /etc/netid and in the netid.byname YP map are ignored
     by the system unless they have the following form:

     unix.<uid>@<yp-domain> <uid>:<gid>,<gid>,...

     When YP is enabled in the group(5) file, such records specify that the
     function getgrouplist(3) shall return the specified groups in addition to
     the groups found in the group file.  The file /etc/netid is parsed before
     the netid.byname YP map.  Only the first matching record is used.

     The main use of the /etc/netid file is to allow certain users to log in
     even while YP is enabled but temporarily unavailable.  These users must
     also be listed in the local master.passwd(5) file.  If consistency of
     group membership information is required while YP is enabled and avail-
     able, all records in the /etc/netid file must agree with records in the
     netid.byname YP map, although the latter may contain additional records.
     If consistency of group membership information is required even while YP
     is enabled but unavailable, the records in the /etc/netid file must not
     grant more group memberships than the group(5) file, and users having
     their own record in the /etc/netid file must not show up in the
     group.byname and group.bygid YP maps.

     On a YP master server, Makefile.yp(8) uses the mknetid(8) utility to gen-
     erate the netid.byname YP map.  In this case, the YP map will also con-
     tain records of the following form:

     unix.<hostname>@<yp-domain> 0:<hostname>

     Such records are ignored by the system.

FILES
     /etc/netid

EXAMPLES
     A netid file or YP map might look like the following:

           unix.10714@kaka 10714:400,10
           unix.jodie@kaka 0:jodie

SEE ALSO
     getgrouplist(3), group(5), Makefile.yp(8), mknetid(8), yp(8)

AUTHORS
     Mats O Jansson <moj@stacken.kth.se>

OpenBSD 4.7                     March 27, 2009                               1
