usr.sbin/ypserv/makedbm/makedbm.8

   1 .\"     $NetBSD: makedbm.8,v 1.12 2005/02/26 16:24:24 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1994 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 MAKEDBM 8
  29 .Os
  30 .Sh NAME
  31 .Nm makedbm
  32 .Nd create a NIS database
  33 .Sh SYNOPSIS
  34 .Nm
  35 .Bk -words
  36 .Fl u Ar dbfile
  37 .Ek
  38 .Nm makedbm
  39 .Op Fl bls
  40 .Bk -words
  41 .Op Fl d Ar yp_domain_name
  42 .Ek
  43 .Bk -words
  44 .Op Fl i Ar yp_input_file
  45 .Ek
  46 .Bk -words
  47 .Op Fl m Ar yp_master_name
  48 .Ek
  49 .Bk -words
  50 .Op Fl o Ar yp_output_file
  51 .Ek
  52 .Ar infile outfile
  53 .Sh DESCRIPTION
  54 .Nm
  55 is the utility in
  56 .Tn NIS
  57 that creates the
  58 .Xr db 3
  59 database file containing the
  60 .Tn NIS
  61 map.
  62 .Pp
  63 .Ar infile
  64 is the pathname of the source file (where
  65 .Dq -
  66 is standard input).
  67 Each line consists of the key and the value, with a space separating
  68 the items.
  69 Blank lines are ignored, and a
  70 .Dq #
  71 is a comment character and indicates that the rest of the line should
  72 be ignored.
  73 .Pp
  74 .Ar outfile
  75 is the pathname of the generated database.
  76 .Pp
  77 The options are as follows:
  78 .Bl -tag -width indent
  79 .It Fl b
  80 Interdomain. Include an entry in the database informing a
  81 .Tn NIS
  82 server to use
  83 DNS to get information about unknown hosts. This option will only have
  84 effect on the maps
  85 .Pa hosts.byname
  86 and
  87 .Pa hosts.byaddr .
  88 .It Fl l
  89 Lowercase. Convert all keys to lower case before adding them to the
  90 .Tn NIS
  91 database.
  92 .It Fl s
  93 Secure map. Include an entry in the database informing
  94 .Xr ypxfr 8
  95 and
  96 .Xr ypserv 8
  97 that the
  98 .Tn NIS
  99 map is going to be handled as secure (i.e., not served
 100 to clients that don't connect from a reserved port).
 101 .It Fl d Ar yp_domain_name
 102 Include an entry in the map with
 103 .Sq YP_DOMAIN_NAME
 104 as the key and
 105 .Ar yp_domain_name
 106 as the value.
 107 .It Fl i Ar yp_input_file
 108 Include an entry in the map with
 109 .Sq YP_INPUT_FILE
 110 as the key and
 111 .Ar yp_input_file
 112 as the value.
 113 .It Fl m Ar yp_master_name
 114 Include an entry in the map with
 115 .Sq YP_MASTER_NAME
 116 as the key and
 117 .Ar yp_master_name
 118 as the value.
 119 .It Fl o Ar yp_output_file
 120 Include an entry in the map with
 121 .Sq YP_OUTPUT_FILE
 122 as the key and
 123 .Ar yp_output_file
 124 as the value.
 125 .It Fl u Ar dbfile
 126 Dump the contents of
 127 .Ar dbfile
 128 to standard output, in a format suitable to be passed back into
 129 .Nm .
 130 .Ar dbfile
 131 is the pathname to the database.
 132 .El
 133 .Sh SEE ALSO
 134 .Xr db 3 ,
 135 .Xr nis 8 ,
 136 .Xr ypserv 8 ,
 137 .Xr ypxfr 8
 138 .Sh AUTHORS
 139 .An Mats O Jansson Aq moj@stacken.kth.se