Blame SOURCES/ypbind-2.5-helpman.patch

6c4d24
diff -up ypbind-mt-2.5/man/ypbind.8.xml.helpman ypbind-mt-2.5/man/ypbind.8.xml
6c4d24
--- ypbind-mt-2.5/man/ypbind.8.xml.helpman	2018-06-04 15:30:38.000000000 +0200
6c4d24
+++ ypbind-mt-2.5/man/ypbind.8.xml	2018-06-07 16:16:56.967024495 +0200
6c4d24
@@ -39,21 +39,33 @@
6c4d24
   <refsynopsisdiv id='synopsis'>
6c4d24
   <cmdsynopsis>
6c4d24
     <command>ypbind</command>
6c4d24
-      <arg choice='opt'>-c </arg>
6c4d24
-      <group choice='opt'><arg choice='plain'>-d </arg><arg choice='plain'>-debug </arg></group>
6c4d24
-      <arg choice='opt'>-verbose </arg>
6c4d24
-      <group choice='opt'><arg choice='plain'>-n </arg><arg choice='plain'>-forground </arg></group>
6c4d24
-      <arg choice='opt'>-broadcast </arg>
6c4d24
-      <arg choice='opt'>-broken-server </arg>
6c4d24
-      <arg choice='opt'>-ypset </arg>
6c4d24
-      <arg choice='opt'>-ypsetme </arg>
6c4d24
-      <arg choice='opt'>-no-ping </arg>
6c4d24
+      <group choice='opt'>
6c4d24
+          <arg choice='plain'>-broadcast </arg>
6c4d24
+          <arg choice='plain'>-ypset </arg>
6c4d24
+          <arg choice='plain'>-ypsetme </arg>
6c4d24
+      </group>
6c4d24
       <arg choice='opt'>-f <replaceable>configfile</replaceable></arg>
6c4d24
+      <arg choice='opt'>-no-ping </arg>
6c4d24
+      <arg choice='opt'>-broken-server </arg>
6c4d24
       <arg choice='opt'>-local-only </arg>
6c4d24
-      <arg choice='opt'>-ping-interval <replaceable>ping-interval</replaceable></arg>
6c4d24
+
6c4d24
+      <group choice='opt'>
6c4d24
+          <arg choice='plain'>-ping-interval <replaceable>ping-interval</replaceable></arg>
6c4d24
+          <arg choice='plain'>-i <replaceable>ping-interval</replaceable></arg>
6c4d24
+      </group>
6c4d24
+
6c4d24
+      <group choice='opt'><arg choice='plain'>-d </arg><arg choice='plain'>-debug </arg></group>
6c4d24
+      <group choice='opt'><arg choice='plain'>-v </arg><arg choice='plain'>-verbose </arg></group>
6c4d24
+      <group choice='opt'><arg choice='plain'>-n </arg><arg choice='plain'>-foreground </arg></group>
6c4d24
+      <arg choice='opt'>-p <replaceable>port</replaceable></arg>
6c4d24
   </cmdsynopsis>
6c4d24
   <cmdsynopsis>
6c4d24
     <command>ypbind</command>
6c4d24
+      <arg choice='plain'>-c </arg>
6c4d24
+      <arg choice='opt'>-f <replaceable>configfile</replaceable></arg>
6c4d24
+    </cmdsynopsis>
6c4d24
+  <cmdsynopsis>
6c4d24
+    <command>ypbind</command>
6c4d24
       <arg choice='plain'>--version </arg>
6c4d24
     </cmdsynopsis>
6c4d24
   </refsynopsisdiv>
6c4d24
@@ -88,6 +100,8 @@
6c4d24
 
6c4d24
     <para>Unless the option
6c4d24
 <option>-debug</option>
6c4d24
+or
6c4d24
+<option>-foreground</option>
6c4d24
 is used, ypbind detaches itself from the controlling terminal and puts
6c4d24
 itself into background.
6c4d24
 <command>ypbind</command>
6c4d24
@@ -132,6 +146,57 @@ If the file does not exist or if there a
6c4d24
 <command>ypbind</command>
6c4d24
 exit.</para>
6c4d24
 
6c4d24
+<para>
6c4d24
+In Fedora we use systemd for starting services. We need to finish starting
6c4d24
+process of <command>ypbind</command> service not before service is fully
6c4d24
+started, which means <command>ypbind</command> daemon is prepared to answer.
6c4d24
+There is a test script <filename>/usr/libexec/ypbind-post-waitbind</filename>
6c4d24
+used in ypbind.service, that waits for <command>ypbind</command> daemon to be
6c4d24
+fully connected to NIS server and waits by default up to 45s.  Sometimes this
6c4d24
+is not enough, because network set up can take longer than 45s during boot, so
6c4d24
+starting ypbind.service fails. User can increase the timeout by setting an
6c4d24
+environment variable NISTIMEOUT in <filename>/etc/sysconfig/ypbind</filename>.
6c4d24
+For example NISTIMEOUT=180 means <command>ypbind</command> will wait up to 180
6c4d24
+seconds for binding to a NIS server.  Another option is to enable
6c4d24
+NetworkManager-wait- online.service, which will make <command>ypbind</command>
6c4d24
+to wait until network is properly set up.
6c4d24
+</para>
6c4d24
+
6c4d24
+<para>
6c4d24
+In case something needs to be changed in the ypbind.service, it is adviced not
6c4d24
+to change the ypbind.service directly, but rather to create a new file under
6c4d24
+<filename>/etc/systemd/system/ypbind.service.d/</filename>, i.e. if we need to
6c4d24
+start <command>ypbind</command> before service foo.service, we can create file
6c4d24
+<filename>/etc/systemd/system/ypbind.service.d/wait-foo.conf</filename> with
6c4d24
+the following content:
6c4d24
+</para>
6c4d24
+
6c4d24
+<para>
6c4d24
+<programlisting>
6c4d24
+[Service]
6c4d24
+Before=foo.service
6c4d24
+</programlisting>
6c4d24
+</para>
6c4d24
+<para>
6c4d24
+If you need to pass other arguments to <command>ypbind</command> daemon withing
6c4d24
+systemd unit file, you can set these arguments as OTHER_YPBIND_OPTS environment
6c4d24
+variable in <filename>/etc/sysconfig/ypbind</filename>. For example in order to
6c4d24
+set a fixed port <command>ypbind</command> should run on, you can specify
6c4d24
+OTHER_YPBIND_OPTS="-p 876" in <filename>/etc/sysconfig/ypbind</filename>.
6c4d24
+</para>
6c4d24
+
6c4d24
+<para>
6c4d24
+DHCP client by defualt changes <filename>/etc/yp.conf</filename> in case DHCP
6c4d24
+server sends NIS configuration in the respond. In that case
6c4d24
+<filename>/etc/dhcp/dhclient.d/nis.sh</filename> changes
6c4d24
+<filename>/etc/yp.conf</filename> according such configuration and creates a
6c4d24
+back-up copy of the original configuration file into
6c4d24
+<filename>/var/lib/dhclient/nis.conf.predhclient.$interface</filename>.  In
6c4d24
+order to disable changing <filename>/etc/yp.conf</filename> by DHCP client, add
6c4d24
+PEERNIS=no into <filename>/etc/sysconfig/network</filename>.
6c4d24
+</para>
6c4d24
+
6c4d24
+
6c4d24
   </refsect1>
6c4d24
 
6c4d24
   <refsect1 id='options'>
6c4d24
@@ -256,6 +321,15 @@ With this options another frequency in s
6c4d24
   </listitem>
6c4d24
   </varlistentry>
6c4d24
   <varlistentry>
6c4d24
+  <term><option>-p</option> port</term>
6c4d24
+  <listitem>
6c4d24
+<para>Lets
6c4d24
+<command>ypbind</command>
6c4d24
+listen on a specified port number, rather than asking portmapper to assingn a
6c4d24
+port for it.</para>
6c4d24
+  </listitem>
6c4d24
+  </varlistentry>
6c4d24
+  <varlistentry>
6c4d24
   <term><option>--version</option></term>
6c4d24
   <listitem>
6c4d24
 <para>Prints the version number</para>
6c4d24
diff -up ypbind-mt-2.5/man/yp.conf.5.xml.helpman ypbind-mt-2.5/man/yp.conf.5.xml
6c4d24
--- ypbind-mt-2.5/man/yp.conf.5.xml.helpman	2018-06-07 16:29:01.853560699 +0200
6c4d24
+++ ypbind-mt-2.5/man/yp.conf.5.xml	2018-06-07 16:33:59.302833043 +0200
6c4d24
@@ -97,6 +97,14 @@
6c4d24
       first the given servers before falling back to broadcasting
6c4d24
       for a running server.
6c4d24
     </para>
6c4d24
+    <para>
6c4d24
+      Content of <filename>/etc/yp.conf</filename> can be changed by DHCP client,
6c4d24
+      for more info see
6c4d24
+      <citerefentry>
6c4d24
+          <refentrytitle>ypbind</refentrytitle>
6c4d24
+          <manvolnum>8</manvolnum>
6c4d24
+      </citerefentry>.
6c4d24
+    </para>
6c4d24
   </refsect1>
6c4d24
 
6c4d24
   <refsect1 id='see_also'>