freebsd-dev/libexec/mknetid/mknetid.8
1997-02-22 14:22:49 +00:00

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$
.\"
.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>