usr/src/man/man1m/makedbm.1m

   1 '\" te
   2 .\"  Copyright (c) 1999, Sun Microsystems, Inc.  Copyright 1989 AT&T  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH MAKEDBM 1M "Aug 17, 1999"
   7 .SH NAME
   8 makedbm \- make a dbm file, or get a text file from a dbm file
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBmakedbm\fR [\fB-b\fR] [\fB-l\fR] [\fB-s\fR] [\fB-E\fR] [\fB-i\fR \fIyp_input_file\fR]
  13      [\fB-o\fR \fIyp_output_name\fR] [\fB-d\fR \fIyp_domain_name\fR]
  14      [\fB-m\fR \fIyp_master_name\fR] [\fB-S\fR \fIdelimiter\fR]
  15      [\fB-D\fR \fInumber_of_delimiters\fR] \fIinfile\fR \fIoutfile\fR
  16 .fi
  17
  18 .LP
  19 .nf
  20 \fBmakedbm\fR [\fB-u\fR \fIdbmfilename\fR]
  21 .fi
  22
  23 .SH DESCRIPTION
  24 .sp
  25 .LP
  26 The \fBmakedbm\fR utility takes the  \fIinfile\fR and converts it to a pair of
  27 files in \fBndbm\fR format (see \fBndbm\fR(3C)), namely
  28 \fIoutfile\fR\fB\&.pag\fR and \fIoutfile\fR\fB\&.dir.\fR Each line of the input
  29 file is converted to a single \fBdbm\fR record. All characters up to the first
  30 \fBTAB\fR or \fBSPACE\fR form the key, and the rest of the line is the data. If
  31 a line ends with `\e' (backslash), the data for that record is continued on to
  32 the next line. \fBmakedbm\fR does not treat `#' (pound-sign) as a special
  33 character.
  34 .sp
  35 .LP
  36 Because  \fBmakedbm\fR is mainly used in generating \fBdbm\fR files for the
  37 \fBNIS\fR name service, it generates a special entry with the key
  38 \fIyp_last_modified\fR, which is the date of \fIinfile\fR (or the current time,
  39 if \fIinfile\fR is `\(mi').  The entries that have keys with the prefix
  40 \fIyp_\fR are interpreted by \fBNIS\fR server utilities.
  41 .SH OPTIONS
  42 .sp
  43 .LP
  44 The following options are supported:
  45 .sp
  46 .ne 2
  47 .na
  48 \fB\fB-b\fR\fR
  49 .ad
  50 .RS 27n
  51 Insert the  \fBYP_INTERDOMAIN\fR into the output.  This key causes
  52 \fBypserv\fR(1M) to use  \fBDNS\fR for host name and address lookups for hosts
  53 not found in the maps.
  54 .RE
  55
  56 .sp
  57 .ne 2
  58 .na
  59 \fB\fB-d\fR\fI yp_domain_name\fR\fR
  60 .ad
  61 .RS 27n
  62 Create a special entry with the key \fIyp_domain_name\fR.
  63 .RE
  64
  65 .sp
  66 .ne 2
  67 .na
  68 \fB\fB-D\fR \fInumber_of delimiters\fR\fR
  69 .ad
  70 .RS 27n
  71 Specify \fInumber_of_delimiters\fR to skip before forming the key.
  72 .RE
  73
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fB-E\fR\fR
  78 .ad
  79 .RS 27n
  80 Delimiters are escaped.
  81 .RE
  82
  83 .sp
  84 .ne 2
  85 .na
  86 \fB\fB-i\fR\fI yp_input_file\fR\fR
  87 .ad
  88 .RS 27n
  89 Create a special entry with the key \fIyp_input_file\fR.
  90 .RE
  91
  92 .sp
  93 .ne 2
  94 .na
  95 \fB\fB-l\fR\fR
  96 .ad
  97 .RS 27n
  98 Lower case. Convert the keys of the given map to lower case, so that, for
  99 example, host name matches succeed independent of upper or lower case
 100 distinctions.
 101 .RE
 102
 103 .sp
 104 .ne 2
 105 .na
 106 \fB\fB-m\fR\fI yp_master_name\fR\fR
 107 .ad
 108 .RS 27n
 109 Create a special entry with the key \fIyp_master_name\fR. If no master host
 110 name is specified, \fIyp_master_name\fR is set to the local host name.
 111 .RE
 112
 113 .sp
 114 .ne 2
 115 .na
 116 \fB\fB-o\fR\fI yp_output_name\fR\fR
 117 .ad
 118 .RS 27n
 119 Create a special entry with the key \fIyp_output_name\fR.
 120 .RE
 121
 122 .sp
 123 .ne 2
 124 .na
 125 \fB\fB-s\fR\fR
 126 .ad
 127 .RS 27n
 128 Secure map. Accept connections from secure  \fBNIS\fR networks only.
 129 .RE
 130
 131 .sp
 132 .ne 2
 133 .na
 134 \fB\fB-S\fR \fIdelimiter\fR\fR
 135 .ad
 136 .RS 27n
 137 Specify the \fIdelimiter\fR to use instead of the default delimiter for forming
 138 the key.
 139 .RE
 140
 141 .sp
 142 .ne 2
 143 .na
 144 \fB\fB-u\fR\fI dbmfilename\fR\fR
 145 .ad
 146 .RS 27n
 147 Undo a \fBdbm\fR file.  Prints out the file in text format, one entry per line,
 148 with a single space separating keys from values.
 149 .RE
 150
 151 .SH OPERANDS
 152 .sp
 153 .LP
 154 The following operands are supported:
 155 .sp
 156 .ne 2
 157 .na
 158 \fB\fIinfile\fR\fR
 159 .ad
 160 .RS 11n
 161 Input file for \fBmakedbm\fR. If \fIinfile\fR is `\fB\(mi\fR\&' (dash), the
 162 standard input is read.
 163 .RE
 164
 165 .sp
 166 .ne 2
 167 .na
 168 \fB\fIoutfile\fR\fR
 169 .ad
 170 .RS 11n
 171 One of two output files in \fBndbm\fR format: \fIoutfile\fR\fB\&.pag\fR and
 172 \fIoutfile\fR\fB\&.dir.\fR
 173 .RE
 174
 175 .SH SEE ALSO
 176 .sp
 177 .LP
 178 \fBypserv\fR(1M), \fBndbm\fR(3C), \fBattributes\fR(5)