summaryrefslogtreecommitdiff
path: root/makedbm/makedbm.8.xml
blob: 6e51e92613a10424bc89b2a75ca801ff57fc4864 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">

<refentry id='makedbm'>

  <refmeta>
    <refentrytitle>makedbm</refentrytitle>
    <manvolnum>8</manvolnum>
    <refmiscinfo class='setdesc'>NIS Reference Manual</refmiscinfo>
  </refmeta>

  <refnamediv id='name'>
    <refname>makedbm</refname>
    <refpurpose>create or dump a ypserv database file</refpurpose>
  </refnamediv>

<!-- body begins here -->
  <refsynopsisdiv id='synopsis'>
    <cmdsynopsis>
      <command>/usr/lib/yp/makedbm</command>    
      <group choice='opt'><arg choice='plain'>-a </arg><arg choice='plain'>-r </arg></group>
      <arg choice='opt'>-b </arg>
      <arg choice='opt'>-c </arg>
      <arg choice='opt'>-s </arg>
      <arg choice='opt'>-l </arg>
      <arg choice='opt'>-i <replaceable>YP_INPUT_NAME</replaceable></arg>
      <arg choice='opt'>-o <replaceable>YP_OUTPUT_NAME</replaceable></arg>
      <arg choice='opt'>-m <replaceable>YP_MASTER_NAME</replaceable></arg>
      <arg choice='plain'><replaceable>inputfile</replaceable></arg>
      <arg choice='plain'><replaceable>dbname</replaceable></arg>
    </cmdsynopsis>
    <cmdsynopsis>
      <command>/usr/lib/yp/makedbm</command>    
      <arg choice='plain'>-u <replaceable>dbname</replaceable></arg>
    </cmdsynopsis>
    <cmdsynopsis>
      <command>/usr/lib/yp/makedbm</command>    
      <arg choice='plain'>-c </arg>
    </cmdsynopsis>
    <cmdsynopsis>
      <command>/usr/lib/yp/makedbm</command>    
      <arg choice='plain'>--version </arg>
    </cmdsynopsis>
  </refsynopsisdiv>


<refsect1 id='description'><title>DESCRIPTION</title>
<para><emphasis remap='B'>makedbm</emphasis>
takes the inputfile and converts it to a ypserv database file. In the
moment, GDBM is used as database. Each line of the input file is converted
to a single record. All characters up to the first TAB or SPACE are the key,
and the rest of the line is the data.
<emphasis remap='B'>makedbm</emphasis>
does not treat `#' as a special character.</para>
</refsect1>

<refsect1 id='options'><title>OPTIONS</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><option>-a</option></term>
  <listitem>
<para>Special support for mail aliases. We couldn't use sendmail for it, since
sendmail uses db, but ypserv gdbm as database format.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-b</option></term>
  <listitem>
<para>Insert the
<emphasis remap='B'>YP_INTERDOMAIN</emphasis>
into the output.  This key causes
<citerefentry><refentrytitle>ypserv</refentrytitle><manvolnum>8</manvolnum></citerefentry>
to use
<emphasis remap='B'>DNS</emphasis>
for host name and address lookups for hosts not found in the maps.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-c</option></term>
  <listitem>
<para>send a
<emphasis remap='B'>YPPROC_CLEAR</emphasis>
to the local
<citerefentry><refentrytitle>ypserv</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
This causes ypserv to invalidate all cached entries.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-l</option></term>
  <listitem>
<para>Convert the keys of the given map to lower case.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-i</option><replaceable> YP_INPUT_NAME</replaceable></term>
  <listitem>
<para>Create a special entry with the key
<emphasis remap='B'>YP_INPUT_NAME</emphasis>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-m</option><replaceable> YP_MASTER_NAME</replaceable></term>
  <listitem>
<para>Create a special entry with the key
<emphasis remap='B'>YP_MASTER_NAME</emphasis>.
If no master host name is specified,
<emphasis remap='B'>YP_MASTER_NAME</emphasis>
will be set to the local host name.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-o</option><replaceable> YP_OUTPUT_NAME</replaceable></term>
  <listitem>
<para>Create a special entry with the key
<emphasis remap='B'>YP_OUTPUT_NAME</emphasis>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-r</option></term>
  <listitem>
<para>Handle `#' as comment sign and remove the comment.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-s</option></term>
  <listitem>
<para>Secure map. Accept connections from secure
<emphasis remap='B'>NIS</emphasis>
networks only (reserved ports).</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-u</option><replaceable> dbname</replaceable></term>
  <listitem>
<para>Dump a ypserv database file. Prints out the file in text format, one entry
per line, with a single space separating keys from values.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>--no-limit-check</option></term>
  <listitem>
<para>Don't check for NIS key and data limit.</para>
  </listitem>
  </varlistentry>
</variablelist>
</refsect1>

<refsect1 id='see_also'><title>SEE ALSO</title>
<para><citerefentry><refentrytitle>ypserv</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>
</refsect1>

  <refsect1 id='author'>
    <title>AUTHOR</title>
    <para>
      <command>makedbm</command> was written by
      Thorsten Kukuk &lt;kukuk@linux-nis.org&gt;.
    </para>
  </refsect1>
</refentry>