xref: /netbsd-src/usr.sbin/ypserv/makedbm/makedbm.8 (revision f5d3fbbc6ff4a77159fb268d247bd94cb7d7e332)
1.\"	$NetBSD: makedbm.8,v 1.4 1997/10/13 03:47:07 lukem 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.Fl u Ar dbfile
41.Nm makedbm
42.Op Fl bls
43.Op Fl d Ar yp_domain_name
44.Op Fl i Ar yp_input_file
45.Op Fl m Ar yp_master_name
46.Op Fl o Ar yp_output_file
47.Ar infile
48.Ar outfile
49.Sh DESCRIPTION
50.Nm
51is the utility in YP that creates the
52.Xr db 3
53database file containing the YP map.
54.Pp
55.Ar infile
56is the pathname of the source file (where
57.Dq -
58is standard input).
59Each line consists of the key and the value, with a space separating
60the items.
61Blank lines are ignored, and a
62.Dq #
63is a comment character and indicates that the rest of the line should
64be ignored.
65.Pp
66.Ar outfile
67is the pathname of the generated databases.
68.Pp
69The options are as follows:
70.Bl -tag -width indent
71.It Fl b
72Interdomain. Include an entry in the database informing a YP server to use
73DNS to get information about unknown hosts. This option will only have
74effect on the maps
75.Pa hosts.byname
76and
77.Pa hosts.byaddr .
78.It Fl l
79Lowercase. Convert all keys to lower case before adding them to the YP
80database.
81.It Fl s
82Secure map. Include an entry in the database informing
83.Xr ypxfr 8
84and
85.Xr ypserv 8
86that the YP map is going to be handled as secure (i.e., not served
87to clients that don't connect from a reserved port).
88.It Fl d Ar yp_domain_name
89Include an entry in the map with the key YP_DOMAIN_NAME and the argument
90as value.
91.It Fl i Ar yp_input_file
92Include an entry in the map with the key YP_INPUT_FILE and the argument
93as value.
94.It Fl m Ar yp_master_name
95Include an entry in the map with the key YP_MASTER_NAME and the argument
96as value.
97.It Fl o Ar yp_output_file
98Include an entry in the map with the key YP_OUTPUT_FILE and the argument
99as value.
100.It Fl u Ar dbfile
101Dump the contents of
102.Ar dbfile
103to standard output, in a format suitable to be passed back into
104.Nm "" .
105.Ar dbfile
106is the pathname to the database.
107.El
108.Sh SEE ALSO
109.Xr db 3 ,
110.Xr yp 8 ,
111.Xr ypxfr 8 ,
112.Xr ypserv 8
113.Sh AUTHOR
114Mats O Jansson <moj@stacken.kth.se>
115