1.\" Copyright (c) 1995, 1996 2.\" Bill Paul <wpaul@ctr.columbia.edu>. 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 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. 18.\" 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 29.\" SUCH DAMAGE. 30.\" 31.Dd June 23, 1996 32.Dt MKNETID 8 33.Os 34.Sh NAME 35.Nm mknetid 36.Nd "generate netid map data" 37.Sh SYNOPSIS 38.Nm 39.Op Fl q 40.Op Fl g Ar group_file 41.Op Fl p Ar passwd_file 42.Op Fl h Ar hosts_file 43.Op Fl n Ar netid_file 44.Op Fl d Ar domain 45.Sh DESCRIPTION 46The 47.Nm 48utility processes the contents of the 49.Xr group 5 , 50.Xr passwd 5 , 51.Xr hosts 5 52and 53.Xr netid 5 54files into the format used to generate the 55.Pa netid.byname 56.Tn NIS 57map. 58This map is used to hold credential information for both users 59and hosts in an operating system independent format. 60.Pp 61The 62.Nm 63utility checks for duplicate occurrences of netids and filters 64them out. 65.Pp 66The 67.Nm 68utility prints its results on the standard output. 69It is usually called 70only by 71.Pa /var/yp/Makefile 72when rebuilding the 73.Tn NIS 74maps. 75.Sh OPTIONS 76The 77.Nm 78utility supports the following options: 79.Bl -tag -width indent 80.It Fl q 81Normally, 82.Nm 83prints a warning message when it encounters a duplicate netid. 84This flag turns on 'quiet' mode, allowing the warnings to be 85suppressed. 86Other error messages may still be generated. 87.It Fl g Ar group_file 88Specify the location of the group information 89file. 90The compiled-in default is 91.Pa /etc/group . 92.It Fl p Ar passwd_file 93Specify the location of the passwd information 94file. 95The compiled-in default is 96.Pa /etc/passwd . 97.It Fl h Ar hosts_file 98Specify the location of the hosts database 99file. 100The compiled-in default is 101.Pa /etc/hosts . 102.It Fl n Ar netid_file 103Specify the location of the netid information 104file. 105The compiled-in default is 106.Pa /etc/netid . 107Note that no error is generated if the netid database cannot be 108found. 109The netid database is not likely to be present on most systems 110until 111.Tn Secure RPC 112support is added to 113.Fx . 114.It Fl d Ar domain 115By default, the 116.Nm 117utility uses the system domainname when generating netid records. 118If 119the system domainname is not set, the domain must be specified on the 120command line with the 121.Fl d 122flag. 123If the domainname is set, the 124.Fl d 125flag may be used to override it. 126.El 127.Sh FILES 128.Bl -tag -width /var/yp/Makefile -compact 129.It Pa /var/yp/Makefile 130the Makefile that calls 131.Nm yp_mkdb 132and 133.Nm 134to build the 135.Tn NIS 136databases 137.It Pa /etc/group 138the default group database file 139.It Pa /etc/passwd 140the default passwd database file 141.It Pa /etc/hosts 142the default hosts database file 143.It Pa /etc/netid 144the default netid database file 145.El 146.Sh SEE ALSO 147.Xr yp 8 , 148.Xr yp_mkdb 8 149.Sh AUTHORS 150.An Bill Paul Aq Mt wpaul@ctr.columbia.edu 151