xref: /freebsd/libexec/mknetid/netid.5 (revision 61e21613)
1.\" Copyright (c) 1996 Mats O Jansson <moj@stacken.kth.se>
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\"    must display the following acknowledgement:
14.\"      This product includes software developed by Mats O Jansson
15.\" 4. The name of the author may not be used to endorse or promote products
16.\"    derived from this software without specific prior written permission.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
19.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
20.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
22.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE.
29.\"
30.Dd January 13, 1996
31.Dt NETID 5
32.Os
33.Sh NAME
34.Nm netid
35.Nd
36.Tn YP
37network credential file
38.Sh DESCRIPTION
39Files in
40.Nm
41format are rare.
42One lives in the
43.Tn YP
44map
45.Pa netid.byname .
46The format is rather simple.
47Each row consists of two items: a key and a value.
48When created by
49.Xr mknetid 8
50there are three types of records.
51.Pp
52The first type is information about which GIDs a UID has:
53.Pp
54.Sm off
55.Li unix . Ao Ar uid Ac @ Aq Ar yp-domain
56.Sm on
57.Sm off
58.Ao Ar uid Ac : Ao Ar gid Ac , Aq Ar gid
59.Sm on
60.Pp
61The second type contains information about hosts:
62.Pp
63.Sm off
64.Li unix . Ao Ar hostname Ac @ Aq Ar yp-domain
65.Sm on
66.Sm off
67.Li 0 : Aq Ar hostname
68.Sm on
69.Pp
70The third type refers to records from a
71.Nm
72file other than the two types above.
73.Sh FILES
74.Bl -tag -width ".Pa /etc/netid" -compact
75.It Pa /etc/netid
76for lines not generated automatically by
77.Xr mknetid 8
78.El
79.Sh EXAMPLES
80A configuration file might look like the following:
81.Bd -literal
82unix.10714@kaka 10714:400,10
83unix.jodie@kaka 0:jodie
84.Ed
85.Sh SEE ALSO
86.Xr mknetid 8 ,
87.Xr yp 8
88.Sh AUTHORS
89.An Mats O Jansson Aq Mt moj@stacken.kth.se
90