diff options
Diffstat (limited to 'libexec/mknetid/mknetid.8')
-rw-r--r-- | libexec/mknetid/mknetid.8 | 141 |
1 files changed, 141 insertions, 0 deletions
diff --git a/libexec/mknetid/mknetid.8 b/libexec/mknetid/mknetid.8 new file mode 100644 index 0000000..5b7ff6d --- /dev/null +++ b/libexec/mknetid/mknetid.8 @@ -0,0 +1,141 @@ +.\" 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> |