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.Pp 77.Sh OPTIONS 78The 79.Nm 80command supports the following options: 81.Bl -tag -width indent 82.It Fl q 83Normally, 84.Nm 85prints a warning message when it encounters a duplicate netid. 86This flag turns on 'quiet' mode, allowing the warnings to be 87suppressed. 88Other error messages may still be generated. 89.It Fl g Ar group_file 90Specify the location of the group information 91file. 92The compiled-in default is 93.Pa /etc/group . 94.It Fl p Ar passwd_file 95Specify the location of the passwd information 96file. 97The compiled-in default is 98.Pa /etc/passwd . 99.It Fl h Ar hosts_file 100Specify the location of the hosts database 101file. 102The compiled-in default is 103.Pa /etc/hosts . 104.It Fl n Ar netid_file 105Specify the location of the netid information 106file. 107The compiled-in default is 108.Pa /etc/netid . 109Note that no error is generated if the netid database can't be 110found. 111The netid database is not likely to be present on most systems 112until 113.Tn Secure RPC 114support is added to 115.Fx . 116.It Fl d Ar domain 117By default, the 118.Nm 119command uses the system domainname when generating netid records. 120If 121the system domainname is not set, the domain must be specified on the 122command line with the 123.Fl d 124flag. 125If the domainname is set, the 126.Fl d 127flag may be used to override it. 128.El 129.Sh FILES 130.Bl -tag -width /var/yp/Makefile -compact 131.It Pa /var/yp/Makefile 132the Makefile that calls 133.Nm yp_mkdb 134and 135.Nm 136to build the 137.Tn NIS 138databases 139.It Pa /etc/group 140the default group database file 141.It Pa /etc/passwd 142the default passwd database file 143.It Pa /etc/hosts 144the default hosts database file 145.It Pa /etc/netid 146the default netid database file 147.El 148.Sh SEE ALSO 149.Xr yp 4 , 150.Xr yp_mkdb 8 151.Sh AUTHORS 152.An Bill Paul Aq wpaul@ctr.columbia.edu 153