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 mknetid 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. This map is used to hold credential information for both users 59and hosts in a operating system independent format. 60.Pp 61The 62.Nm 63command checks for duplicate occurances of netids and filters 64them out. 65.Pp 66The 67.Nm 68command prints its results on the standard output. It is usually called 69only by 70.Pa /var/yp/Makefile 71when rebuilding the 72.Tn NIS 73maps. 74.Pp 75.Sh OPTIONS 76The 77.Nm 78command 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 85surpressed. Other error messages may still be generated. 86.It Fl g Ar group_file 87Specify the location of the group information 88file. The compiled-in default is 89.Pa /etc/group . 90.It Fl p Ar passwd_file 91Specify the location of the passwd information 92file. The compiled-in default is 93.Pa /etc/passwd . 94.It Fl h Ar hosts_file 95Specify the location of the hosts database 96file. The compiled-in default is 97.Pa /etc/hosts . 98.It Fl n Ar netid_file 99Specify the location of the netid information 100file. The compiled-in default is 101.Pa /etc/netid . 102Note that no error is generated if the netid database can't be 103found. The netid database is not likely to be present on most systems 104until 105.Tn Secure RPC 106support is added to 107.Bx Free . 108.It Fl d Ar domain 109By default, the 110.Nm 111command uses the system domainname when generating netid records. If 112the system domainname is not set, the domain must be specified on the 113command line with the 114.Fl d 115flag. If the domainname is set, the 116.Fl d 117flag may be used to override it. 118.El 119.Sh FILES 120.Bl -tag -width /var/yp/Makefile -compact 121.It Pa /var/yp/Makefile 122the Makefile that calls 123.Nm yp_mkdb 124and 125.Nm mknetid 126to build the 127.Tn NIS 128databases 129.It Pa /etc/group 130the default group database file 131.It Pa /etc/passwd 132the default passwd database file 133.It Pa /etc/hosts 134the default hosts database file 135.It Pa /etc/netid 136the default netid database file 137.El 138.Sh SEE ALSO 139.Xr yp 4 , 140.Xr yp_mkdb 8 141.Sh AUTHORS 142.An Bill Paul Aq wpaul@ctr.columbia.edu 143