xref: /openbsd/usr.sbin/ypserv/mknetid/mknetid.8 (revision 09467b48)
1.\"	$OpenBSD: mknetid.8,v 1.16 2013/07/16 11:13:34 schwarze Exp $
2.\"
3.\" Copyright (c) 1996 Mats O Jansson <moj@stacken.kth.se>
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
16.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
19.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25.\" SUCH DAMAGE.
26.\"
27.Dd $Mdocdate: July 16 2013 $
28.Dt MKNETID 8
29.Os
30.Sh NAME
31.Nm mknetid
32.Nd generate a YP map of group and domain memberships
33.Sh SYNOPSIS
34.Nm mknetid
35.Bk -words
36.Op Fl q
37.Op Fl d Ar domain
38.Op Fl g Ar groupfile
39.Op Fl h Ar hostfile
40.Op Fl m Ar netidfile
41.Op Fl P Ar master.passwdfile
42.Op Fl p Ar passwdfile
43.Ek
44.Sh DESCRIPTION
45The
46.Nm
47utility combines information from the
48.Xr passwd 5 ,
49.Xr group 5 ,
50.Xr hosts 5 ,
51and
52.Xr netid 5
53files, printing it in
54.Xr netid 5
55format to the standard output.
56If the
57.Xr passwd 5
58file is not available, the
59.Xr master.passwd 5
60file is used instead.
61The
62.Xr netid 5
63file is optional and does not need to exist.
64.Pp
65The most common application is to pass the output to
66.Xr makedbm 8
67in order to create a
68.Pa netid.byname
69map for the
70.Xr yp 8
71subsystem.
72.Pp
73The options are as follows:
74.Bl -tag -width Ds
75.It Fl d Ar domain
76Use
77.Ar domain
78instead of the default
79.Xr domainname 1 .
80.It Fl g Ar groupfile
81Use
82.Ar groupfile
83instead of
84.Pa /etc/group .
85.It Fl h Ar hostfile
86Use
87.Ar hostfile
88instead of
89.Pa /etc/hosts .
90.It Fl m Ar netidfile
91Use
92.Ar netidfile
93instead of
94.Pa /etc/netid .
95.It Fl P Ar master.passwdfile
96Use
97.Ar master.passwdfile
98instead of
99.Pa /etc/master.passwd .
100.It Fl p Ar passwdfile
101Use
102.Ar passwdfile
103instead of
104.Pa /etc/passwd .
105.It Fl q
106Keep quiet about multiple occurrences of a user ID.
107Ignore all but the first.
108.El
109.Sh FILES
110.Bl -tag -width /etc/master.passwd -compact
111.It Pa /etc/passwd
112.It Pa /etc/master.passwd
113.It Pa /etc/group
114.It Pa /etc/hosts
115.It Pa /etc/netid
116.El
117.Sh SEE ALSO
118.Xr domainname 1 ,
119.Xr group 5 ,
120.Xr hosts 5 ,
121.Xr netid 5 ,
122.Xr passwd 5 ,
123.Xr Makefile.yp 8
124.Sh AUTHORS
125.An Mats O Jansson Aq Mt moj@stacken.kth.se
126