ca09eb424c
the Himalayas and become a hermit.) Import new mknetid program. This replaces the crufty, soon to be defunct mknetid script packaged with ypserv. This program parses the group, passwd, hosts and netid databases into the netid.byname map. Duplicate checking is performed using hash tables. Testing on my 486DX2/66 with FreeBSD 2.1.0 showed that this program can process a 30,000-entry passwd database into a netid map (along with assorted group and hosts information) in about 22 seconds. On my SPARC IPX with SunOS 4.1.3, it takes about 15 seconds. This compares favorably with the SunOS mknetid program, which parses the same database(s) in 13 seconds. (With smaller databases, my program is actually slightly faster. Go figure.)
142 lines
4.3 KiB
Groff
142 lines
4.3 KiB
Groff
.\" Copyright (c) 1995, 1996
|
|
.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by Bill Paul.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" $Id: mknetid.8,v 1.2 1996/06/25 02:53:44 wpaul Exp $
|
|
.\"
|
|
.Dd June 23, 1996
|
|
.Dt MKNETID 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm mknetid
|
|
.Nd "generate netid map data"
|
|
.Sh SYNOPSIS
|
|
.Nm mknetid
|
|
.Op Fl q
|
|
.Op Fl g Ar group_file
|
|
.Op Fl p Ar passwd_file
|
|
.Op Fl h Ar hosts_file
|
|
.Op Fl n Ar netid_file
|
|
.Op Fl d Ar domain
|
|
.Sh DESCRIPTION
|
|
.Nm Mknetid
|
|
processes the contents of the
|
|
.Xr group 5 ,
|
|
.Xr passwd 5 ,
|
|
.Xr hosts 5 and
|
|
.Xr netid 5
|
|
files into the format used to generate the
|
|
.Pa netid.byname
|
|
NIS map. This map is used to hold credential information for both users
|
|
and hosts in a operating system independent format.
|
|
.Pp
|
|
The
|
|
.Nm mknetid
|
|
command checks for duplicate occurances of netids and filters
|
|
them out.
|
|
.Pp
|
|
The
|
|
.Nm mknetid
|
|
command prints its results on the standard output. It is usually called
|
|
only by
|
|
.Nm /var/yp/Makefile
|
|
when rebuilding the NIS maps.
|
|
.Pp
|
|
.Sh OPTIONS
|
|
The
|
|
.Nm mknetid
|
|
command supports the following options:
|
|
.Bl -tag -width flag
|
|
.It Fl q
|
|
Normally,
|
|
.Nm mknetid
|
|
prints a warning message when it encounters a duplicate netid.
|
|
This flag turns on 'quiet' mode, allowing the warnings to be
|
|
surpressed. Other error messages may still be generated.
|
|
.It Fl g Ar group-file
|
|
The
|
|
.Fl g
|
|
flag can be used to specify the location of the group information
|
|
file. The compiled-in default is
|
|
.Pa /etc/group .
|
|
.It Fl p Ar passwd-file
|
|
The
|
|
.Fl p
|
|
flag can be used to specify the location of the passwd information
|
|
file. The compiled-in default is
|
|
.Pa /etc/passwd .
|
|
.It Fl h Ar group-file
|
|
The
|
|
.Fl h
|
|
flag can be used to specify the location of the hosts database
|
|
file. The compiled-in default is
|
|
.Pa /etc/hosts .
|
|
.It Fl n Ar netid-file
|
|
The
|
|
.Fl n
|
|
flag can be used to specify the location of the netid information
|
|
file. The compiled-in default is
|
|
.Pa /etc/netid .
|
|
Note that no error is generated if the netid database can't be
|
|
found. The netid database is not likely to be present on most systems
|
|
until Secure RPC support is added to FreeBSD.
|
|
.It Fl d Ar domain
|
|
By default, the
|
|
.Nm mknetid
|
|
command uses the system domainname when generating netid records. If
|
|
the system domainnameis not set, the domain must be specified on the
|
|
command line with the
|
|
.Fl d
|
|
flag. If the domainname is set, the
|
|
.Fl d
|
|
flag may be used to override it.
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width Pa -compact
|
|
.It Pa /var/yp/Makefile
|
|
The Makefile that calls
|
|
.Nm yp_mkdb
|
|
and
|
|
.Nm mknetid
|
|
to build the NIS databases.
|
|
.It Pa /etc/group
|
|
The default group database file.
|
|
.It Pa /etc/passwd
|
|
The default passwd database file.
|
|
.It Pa /etc/hosts
|
|
The default hosts database file.
|
|
.It Pa /etc/netid
|
|
The default netid database file.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr yp 4 ,
|
|
.Xr yp_mkdb 8
|
|
.Sh AUTHOR
|
|
Bill Paul <wpaul@ctr.columbia.edu>
|