libexec/mknetid/mknetid.8

   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 .Dd June 23, 1996
  32 .Dt MKNETID 8
  33 .Os
  34 .Sh NAME
  35 .Nm mknetid
  36 .Nd "generate netid map data"
  37 .Sh SYNOPSIS
  38 .Nm
  39 .Op Fl q
  40 .Op Fl g Ar group_file
  41 .Op Fl p Ar passwd_file
  42 .Op Fl h Ar hosts_file
  43 .Op Fl n Ar netid_file
  44 .Op Fl d Ar domain
  45 .Sh DESCRIPTION
  46 The
  47 .Nm
  48 utility processes the contents of the
  49 .Xr group 5 ,
  50 .Xr passwd 5 ,
  51 .Xr hosts 5
  52 and
  53 .Xr netid 5
  54 files into the format used to generate the
  55 .Pa netid.byname
  56 .Tn NIS
  57 map.
  58 This map is used to hold credential information for both users
  59 and hosts in an operating system independent format.
  60 .Pp
  61 The
  62 .Nm
  63 utility checks for duplicate occurrences of netids and filters
  64 them out.
  65 .Pp
  66 The
  67 .Nm
  68 utility prints its results on the standard output.
  69 It is usually called
  70 only by
  71 .Pa /var/yp/Makefile
  72 when rebuilding the
  73 .Tn NIS
  74 maps.
  75 .Sh OPTIONS
  76 The
  77 .Nm
  78 utility supports the following options:
  79 .Bl -tag -width indent
  80 .It Fl q
  81 Normally,
  82 .Nm
  83 prints a warning message when it encounters a duplicate netid.
  84 This flag turns on 'quiet' mode, allowing the warnings to be
  85 suppressed.
  86 Other error messages may still be generated.
  87 .It Fl g Ar group_file
  88 Specify the location of the group information
  89 file.
  90 The compiled-in default is
  91 .Pa /etc/group .
  92 .It Fl p Ar passwd_file
  93 Specify the location of the passwd information
  94 file.
  95 The compiled-in default is
  96 .Pa /etc/passwd .
  97 .It Fl h Ar hosts_file
  98 Specify the location of the hosts database
  99 file.
 100 The compiled-in default is
 101 .Pa /etc/hosts .
 102 .It Fl n Ar netid_file
 103 Specify the location of the netid information
 104 file.
 105 The compiled-in default is
 106 .Pa /etc/netid .
 107 Note that no error is generated if the netid database cannot be
 108 found.
 109 The netid database is not likely to be present on most systems
 110 until
 111 .Tn Secure RPC
 112 support is added to
 113 .Fx .
 114 .It Fl d Ar domain
 115 By default, the
 116 .Nm
 117 utility uses the system domainname when generating netid records.
 118 If
 119 the system domainname is not set, the domain must be specified on the
 120 command line with the
 121 .Fl d
 122 flag.
 123 If the domainname is set, the
 124 .Fl d
 125 flag may be used to override it.
 126 .El
 127 .Sh FILES
 128 .Bl -tag -width /var/yp/Makefile -compact
 129 .It Pa /var/yp/Makefile
 130 the Makefile that calls
 131 .Nm yp_mkdb
 132 and
 133 .Nm
 134 to build the
 135 .Tn NIS
 136 databases
 137 .It Pa /etc/group
 138 the default group database file
 139 .It Pa /etc/passwd
 140 the default passwd database file
 141 .It Pa /etc/hosts
 142 the default hosts database file
 143 .It Pa /etc/netid
 144 the default netid database file
 145 .El
 146 .Sh SEE ALSO
 147 .Xr yp 8 ,
 148 .Xr yp_mkdb 8
 149 .Sh AUTHORS
 150 .An Bill Paul Aq Mt wpaul@ctr.columbia.edu