1 .\" Copyright (c) 1995, 1996
2 .\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
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 Bill Paul.
15 .\" 4. Neither the name of the University nor the names of its contributors
16 .\" may be used to endorse or promote products derived from this software
17 .\" without specific prior written permission.
19 .\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 .\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE
23 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38 .Nd "generate netid map data"
42 .Op Fl g Ar group_file
43 .Op Fl p Ar passwd_file
44 .Op Fl h Ar hosts_file
45 .Op Fl n Ar netid_file
50 utility processes the contents of the
56 files into the format used to generate the
60 This map is used to hold credential information for both users
61 and hosts in a operating system independent format.
65 utility checks for duplicate occurrences of netids and filters
70 utility prints its results on the standard output.
80 utility supports the following options:
81 .Bl -tag -width indent
85 prints a warning message when it encounters a duplicate netid.
86 This flag turns on 'quiet' mode, allowing the warnings to be
88 Other error messages may still be generated.
89 .It Fl g Ar group_file
90 Specify the location of the group information
92 The compiled-in default is
94 .It Fl p Ar passwd_file
95 Specify the location of the passwd information
97 The compiled-in default is
99 .It Fl h Ar hosts_file
100 Specify the location of the hosts database
102 The compiled-in default is
104 .It Fl n Ar netid_file
105 Specify the location of the netid information
107 The compiled-in default is
109 Note that no error is generated if the netid database can't be
111 The netid database is not likely to be present on most systems
119 utility uses the system domainname when generating netid records.
121 the system domainname is not set, the domain must be specified on the
122 command line with the
125 If the domainname is set, the
127 flag may be used to override it.
130 .Bl -tag -width /var/yp/Makefile -compact
131 .It Pa /var/yp/Makefile
132 the Makefile that calls
140 the default group database file
142 the default passwd database file
144 the default hosts database file
146 the default netid database file
152 .An Bill Paul Aq wpaul@ctr.columbia.edu