xref: /netbsd-src/usr.sbin/ypserv/makedbm/makedbm.8 (revision 1897181a7231d5fc7ab48994d1447fcbc4e13a49)
1.\"	$NetBSD: makedbm.8,v 1.13 2009/10/20 00:51:14 snj 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
55is the utility in
56.Tn NIS
57that creates the
58.Xr db 3
59database file containing the
60.Tn NIS
61map.
62.Pp
63.Ar infile
64is the pathname of the source file (where
65.Dq -
66is standard input).
67Each line consists of the key and the value, with a space separating
68the items.
69Blank lines are ignored, and a
70.Dq #
71is a comment character and indicates that the rest of the line should
72be ignored.
73.Pp
74.Ar outfile
75is the pathname of the generated database.
76.Pp
77The options are as follows:
78.Bl -tag -width indent
79.It Fl b
80Interdomain. Include an entry in the database informing a
81.Tn NIS
82server to use
83DNS to get information about unknown hosts. This option will only have
84effect on the maps
85.Pa hosts.byname
86and
87.Pa hosts.byaddr .
88.It Fl l
89Lowercase. Convert all keys to lower case before adding them to the
90.Tn NIS
91database.
92.It Fl s
93Secure map. Include an entry in the database informing
94.Xr ypxfr 8
95and
96.Xr ypserv 8
97that the
98.Tn NIS
99map is going to be handled as secure (i.e., not served
100to clients that don't connect from a reserved port).
101.It Fl d Ar yp_domain_name
102Include an entry in the map with
103.Sq YP_DOMAIN_NAME
104as the key and
105.Ar yp_domain_name
106as the value.
107.It Fl i Ar yp_input_file
108Include an entry in the map with
109.Sq YP_INPUT_FILE
110as the key and
111.Ar yp_input_file
112as the value.
113.It Fl m Ar yp_master_name
114Include an entry in the map with
115.Sq YP_MASTER_NAME
116as the key and
117.Ar yp_master_name
118as the value.
119.It Fl o Ar yp_output_file
120Include an entry in the map with
121.Sq YP_OUTPUT_FILE
122as the key and
123.Ar yp_output_file
124as the value.
125.It Fl u Ar dbfile
126Dump the contents of
127.Ar dbfile
128to standard output, in a format suitable to be passed back into
129.Nm .
130.Ar dbfile
131is 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
140