freebsd-skq/libexec/mknetid/mknetid.8

143 lines
4.2 KiB
Groff
Raw Normal View History

.\" 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.5 1998/03/19 07:37:10 charnier 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 ,
1997-11-24 07:31:31 +00:00
.Xr hosts 5
and
.Xr netid 5
files into the format used to generate the
.Pa netid.byname
1997-11-24 07:31:31 +00:00
.Tn NIS
map. This map is used to hold credential information for both users
and hosts in a operating system independent format.
.Pp
The
1997-11-24 07:31:31 +00:00
.Nm
command checks for duplicate occurances of netids and filters
them out.
.Pp
The
1997-11-24 07:31:31 +00:00
.Nm
command prints its results on the standard output. It is usually called
only by
1997-11-24 07:31:31 +00:00
.Pa /var/yp/Makefile
when rebuilding the
.Tn NIS
maps.
.Pp
.Sh OPTIONS
The
1997-11-24 07:31:31 +00:00
.Nm
command supports the following options:
1997-11-24 07:31:31 +00:00
.Bl -tag -width indent
.It Fl q
Normally,
1997-11-24 07:31:31 +00:00
.Nm
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.
1997-11-24 07:31:31 +00:00
.It Fl g Ar group_file
Specify the location of the group information
file. The compiled-in default is
.Pa /etc/group .
1997-11-24 07:31:31 +00:00
.It Fl p Ar passwd_file
Specify the location of the passwd information
file. The compiled-in default is
.Pa /etc/passwd .
.It Fl h Ar hosts_file
1997-11-24 07:31:31 +00:00
Specify the location of the hosts database
file. The compiled-in default is
.Pa /etc/hosts .
1997-11-24 07:31:31 +00:00
.It Fl n Ar netid_file
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
1997-11-24 07:31:31 +00:00
until
.Tn Secure RPC
support is added to
.Bx Free .
.It Fl d Ar domain
By default, the
1997-11-24 07:31:31 +00:00
.Nm
command uses the system domainname when generating netid records. If
1997-11-24 07:31:31 +00:00
the system domainname is 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
1997-11-24 07:31:31 +00:00
.Bl -tag -width /var/yp/Makefile -compact
.It Pa /var/yp/Makefile
1997-11-24 07:31:31 +00:00
the Makefile that calls
.Nm yp_mkdb
and
.Nm mknetid
1997-11-24 07:31:31 +00:00
to build the
.Tn NIS
databases
.It Pa /etc/group
1997-11-24 07:31:31 +00:00
the default group database file
.It Pa /etc/passwd
1997-11-24 07:31:31 +00:00
the default passwd database file
.It Pa /etc/hosts
1997-11-24 07:31:31 +00:00
the default hosts database file
.It Pa /etc/netid
1997-11-24 07:31:31 +00:00
the default netid database file
.El
.Sh SEE ALSO
.Xr yp 4 ,
.Xr yp_mkdb 8
.Sh AUTHORS
1997-11-24 07:31:31 +00:00
.An Bill Paul Aq wpaul@ctr.columbia.edu