usr.sbin/ypserv/mknetid/mknetid.8

   1 .\"     $NetBSD: mknetid.8,v 1.10 2005/02/26 16:32:04 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1996 Mats O Jansson <moj@stacken.kth.se>
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
  16 .\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  17 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  18 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
  19 .\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  20 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  21 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  22 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  23 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  24 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  25 .\" SUCH DAMAGE.
  26 .\"
  27 .Dd February 26, 2005
  28 .Dt MKNETID 8
  29 .Os
  30 .Sh NAME
  31 .Nm mknetid
  32 .Nd a NIS filter program
  33 .Sh SYNOPSIS
  34 .Nm
  35 .Op Fl q
  36 .Bk -words
  37 .Op Fl d Ar domain
  38 .Ek
  39 .Bk -words
  40 .Op Fl p Ar passwdfile
  41 .Ek
  42 .Bk -words
  43 .Op Fl g Ar groupfile
  44 .Ek
  45 .Bk -words
  46 .Op Fl h Ar hostfile
  47 .Ek
  48 .Bk -words
  49 .Op Fl m Ar netidfile
  50 .Ek
  51 .Sh DESCRIPTION
  52 .Nm
  53 is used to create a map named
  54 .Pa netid.byname .
  55 The map consists of information from
  56 .Xr passwd 5 ,
  57 .Xr group 5
  58 and
  59 .Xr hosts 5
  60 eventually concatenated with a
  61 .Xr netid 5
  62 file.
  63 .Pp
  64 The options are as follows:
  65 .Bl -tag -width "-p passwdfile"
  66 .It Fl d Ar domain
  67 .Tn NIS
  68 domain to use instead of the default domain.
  69 .It Fl g Ar groupfile
  70 Alternate
  71 .Xr group 5
  72 file.
  73 Default is
  74 .Pa /etc/group .
  75 .It Fl h Ar hostfile
  76 Alternate
  77 .Xr hosts 5
  78 file.
  79 Default is
  80 .Pa /etc/hosts .
  81 .It Fl m Ar netidfile
  82 Alternate
  83 .Xr netid 5
  84 file.
  85 Default is
  86 .Pa /etc/netid .
  87 .It Fl p Ar passwdfile
  88 Alternate
  89 .Xr passwd 5
  90 file.
  91 Default is
  92 .Pa /etc/passwd .
  93 .It Fl q
  94 Keep quiet about multiple occurrences of a uid; ignore all but the first.
  95 .El
  96 .Sh FILES
  97 .Bl -tag -width "/etc/passwd" -compact
  98 .It Pa /etc/group
  99 .It Pa /etc/hosts
 100 .It Pa /etc/netid
 101 .It Pa /etc/passwd
 102 .El
 103 .Sh SEE ALSO
 104 .Xr domainname 1 ,
 105 .Xr group 5 ,
 106 .Xr hosts 5 ,
 107 .Xr netid 5 ,
 108 .Xr passwd 5 ,
 109 .Xr nis 8
 110 .Sh AUTHORS
 111 .An Mats O Jansson Aq moj@stacken.kth.se