xref: /netbsd-src/usr.sbin/ypserv/makedbm/makedbm.8 (revision 6cb10275d08f045e872662c371fe2f2724f2f6e6)
1.\"	$NetBSD: makedbm.8,v 1.16 2014/03/18 18:20:47 riastradh 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.Fl u Ar dbfile
36.Nm makedbm
37.Op Fl bls
38.Op Fl d Ar yp_domain_name
39.Op Fl i Ar yp_input_file
40.Op Fl m Ar yp_master_name
41.Op Fl o Ar yp_output_file
42.Ar infile outfile
43.Sh DESCRIPTION
44.Nm
45is the utility in
46.Tn NIS
47that creates the
48.Xr db 3
49database file containing the
50.Tn NIS
51map.
52.Pp
53.Ar infile
54is the pathname of the source file (where
55.Dq -
56is standard input).
57Each line consists of the key and the value, with a space separating
58the items.
59Blank lines are ignored, and a
60.Dq #
61is a comment character and indicates that the rest of the line should
62be ignored.
63.Pp
64.Ar outfile
65is the pathname of the generated database.
66.Pp
67The options are as follows:
68.Bl -tag -width indent
69.It Fl b
70Interdomain. Include an entry in the database informing a
71.Tn NIS
72server 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
80.Tn NIS
81database.
82.It Fl s
83Secure map. Include an entry in the database informing
84.Xr ypxfr 8
85and
86.Xr ypserv 8
87that the
88.Tn NIS
89map is going to be handled as secure (i.e., not served
90to clients that don't connect from a reserved port).
91.It Fl d Ar yp_domain_name
92Include an entry in the map with
93.Sq YP_DOMAIN_NAME
94as the key and
95.Ar yp_domain_name
96as the value.
97.It Fl i Ar yp_input_file
98Include an entry in the map with
99.Sq YP_INPUT_FILE
100as the key and
101.Ar yp_input_file
102as the value.
103.It Fl m Ar yp_master_name
104Include an entry in the map with
105.Sq YP_MASTER_NAME
106as the key and
107.Ar yp_master_name
108as the value.
109.It Fl o Ar yp_output_file
110Include an entry in the map with
111.Sq YP_OUTPUT_FILE
112as the key and
113.Ar yp_output_file
114as the value.
115.It Fl u Ar dbfile
116Dump the contents of
117.Ar dbfile
118to standard output, in a format suitable to be passed back into
119.Nm .
120.Ar dbfile
121is the pathname to the database.
122.El
123.Sh SEE ALSO
124.Xr db 3 ,
125.Xr nis 8 ,
126.Xr ypserv 8 ,
127.Xr ypxfr 8
128.Sh AUTHORS
129.An Mats O Jansson Aq Mt moj@stacken.kth.se
130