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