summaryrefslogtreecommitdiff
path: root/mknetid/mknetid.8.xml
blob: 5ea566b79a8acd5638416e5a78eff975b5504a60 (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
<?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='mknetid'>

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

  <refnamediv id='name'>
    <refname>mknetid</refname>
    <refpurpose>generate data for netid map</refpurpose>
  </refnamediv>

<!-- body begins here -->

  <refsynopsisdiv id='synopsis'>
    <cmdsynopsis>
      <command>/usr/lib/yp/mknetid</command>
      <arg choice='opt'>-q </arg>
      <arg choice='opt'>-h <replaceable>hosts</replaceable></arg>
      <arg choice='opt'>-p <replaceable>passwd</replaceable></arg>
      <arg choice='opt'>-g <replaceable>group</replaceable></arg>
      <arg choice='opt'>-d <replaceable>domain</replaceable></arg>
      <arg choice='opt'>-n <replaceable>netid</replaceable></arg>
    </cmdsynopsis>
    <cmdsynopsis>
      <command>/usr/lib/yp/mknetid</command>
      <arg choice='plain'>--version </arg>
    </cmdsynopsis>
  </refsynopsisdiv>


<refsect1 id='description'><title>DESCRIPTION</title>
<para><emphasis remap='B'>mknetid</emphasis>
generates the <emphasis remap='I'>netid.byname</emphasis> NIS map from the contents of the
group(5), passwd(5), hosts(5) and netid files. It checks for multiple
entrys of netids and warn for them or filters them out. It is only
called by
<filename>/var/yp/Makefile</filename>
when rebuilding the NIS map.</para>
</refsect1>

<refsect1 id='options'><title>OPTIONS</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><option>-q</option></term>
  <listitem>
<para>This flag turns on 'quiet' mode, don't print a warning message when
finding an duplicate netid entry.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-h</option><replaceable> hosts</replaceable></term>
  <listitem>
<para>The
<option>-h</option>
flag can be used to specify the use of another hosts file
than the default <filename>/etc/hosts</filename>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-p</option><replaceable> passwd</replaceable></term>
  <listitem>
<para>The
<option>-p</option>
flag can be used to specify the use of another passwd file
than the default <filename>/etc/passwd</filename>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-g</option><replaceable> group</replaceable></term>
  <listitem>
<para>The
<option>-g</option>
flag can be used to specify the use of another group file
than the default <filename>/etc/group</filename>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-n</option><replaceable> netid</replaceable></term>
  <listitem>
<para>The
<option>-n</option>
flag can be used to specify the use of another netid file
than the default <filename>/etc/netid</filename>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-d</option><replaceable> domain</replaceable></term>
  <listitem>
<para>The
<emphasis remap='B'>mknetid</emphasis>
command uses the system domainname by default. If it is not set
or you whish to override it, you must use the
<option>-d</option>
parameter.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>--version</option></term>
  <listitem>
<para>Prints the version number</para>
  </listitem>
  </varlistentry>
</variablelist>
</refsect1>

<refsect1 id='files'><title>FILES</title>
<!-- .PD 0 -->
<variablelist remap='TP'>
  <varlistentry>
  <term><filename>/etc/group</filename></term>
  <listitem>
<para>groups file</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><filename>/etc/hosts</filename></term>
  <listitem>
<para>hosts database</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><filename>/etc/netid</filename></term>
  <listitem>
<para>netname database</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><filename>/etc/passwd</filename></term>
  <listitem>
<para>password file</para>
<!-- .PD -->
  </listitem>
  </varlistentry>
</variablelist>
</refsect1>

<refsect1 id='see_also'><title>SEE ALSO</title>
<para><citerefentry><refentrytitle>passwd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>group</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>hosts</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>passwd</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>

</refsect1>

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