xref: /netbsd/usr.sbin/ypserv/makedbm/makedbm.8 (revision bf9ec67e)
1.\"	$NetBSD: makedbm.8,v 1.9 2002/02/02 02:19:13 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.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"	This product includes software developed by Mats O Jansson
17.\" 4. The name of the author may not be used to endorse or promote products
18.\"    derived from this software without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
21.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
22.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
24.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.Dd July 19, 1994
33.Dt MAKEDBM 8
34.Os
35.Sh NAME
36.Nm makedbm
37.Nd create a YP database
38.Sh SYNOPSIS
39.Nm
40.Bk -words
41.Fl u Ar dbfile
42.Ek
43.Nm makedbm
44.Op Fl bls
45.Bk -words
46.Op Fl d Ar yp_domain_name
47.Ek
48.Bk -words
49.Op Fl i Ar yp_input_file
50.Ek
51.Bk -words
52.Op Fl m Ar yp_master_name
53.Ek
54.Bk -words
55.Op Fl o Ar yp_output_file
56.Ek
57.Ar infile outfile
58.Sh DESCRIPTION
59.Nm
60is the utility in
61.Tn YP
62that creates the
63.Xr db 3
64database file containing the
65.Tn YP
66map.
67.Pp
68.Ar infile
69is the pathname of the source file (where
70.Dq -
71is standard input).
72Each line consists of the key and the value, with a space separating
73the items.
74Blank lines are ignored, and a
75.Dq #
76is a comment character and indicates that the rest of the line should
77be ignored.
78.Pp
79.Ar outfile
80is the pathname of the generated database.
81.Pp
82The options are as follows:
83.Bl -tag -width indent
84.It Fl b
85Interdomain. Include an entry in the database informing a
86.Tn YP
87server to use
88DNS to get information about unknown hosts. This option will only have
89effect on the maps
90.Pa hosts.byname
91and
92.Pa hosts.byaddr .
93.It Fl l
94Lowercase. Convert all keys to lower case before adding them to the
95.Tn YP
96database.
97.It Fl s
98Secure map. Include an entry in the database informing
99.Xr ypxfr 8
100and
101.Xr ypserv 8
102that the
103.Tn YP
104map is going to be handled as secure (i.e., not served
105to clients that don't connect from a reserved port).
106.It Fl d Ar yp_domain_name
107Include an entry in the map with
108.Sq YP_DOMAIN_NAME
109as the key and
110.Ar yp_domain_name
111as the value.
112.It Fl i Ar yp_input_file
113Include an entry in the map with
114.Sq YP_INPUT_FILE
115as the key and
116.Ar yp_input_file
117as the value.
118.It Fl m Ar yp_master_name
119Include an entry in the map with
120.Sq YP_MASTER_NAME
121as the key and
122.Ar yp_master_name
123as the value.
124.It Fl o Ar yp_output_file
125Include an entry in the map with
126.Sq YP_OUTPUT_FILE
127as the key and
128.Ar yp_output_file
129as the value.
130.It Fl u Ar dbfile
131Dump the contents of
132.Ar dbfile
133to standard output, in a format suitable to be passed back into
134.Nm "" .
135.Ar dbfile
136is the pathname to the database.
137.El
138.Sh SEE ALSO
139.Xr db 3 ,
140.Xr yp 8 ,
141.Xr ypserv 8 ,
142.Xr ypxfr 8
143.Sh AUTHORS
144.An Mats O Jansson Aq moj@stacken.kth.se
145