man: document --prefix option in chage, chpasswd and passwd

Support for `--prefix` was added in
https://github.com/shadow-maint/shadow/pull/714 and is available since
shadow 4.14.0.

Close https://github.com/shadow-maint/shadow/issues/822

Cherry-picked-from: 01f6258df744 ("man: document --prefix option in chage, chpasswd and passwd")
Link: <https://github.com/shadow-maint/shadow/pull/823>
Suggested-by: Michael Vetter <jubalh@iodoru.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

diff --git a/man/chage.1.xml b/man/chage.1.xml
index 055c1ed60fb45a1555c78a9392db5a25d4f640e0..060409b83a78c506850f736434f96d635d7da9b8 100644 (file)
--- a/man/chage.1.xml
+++ b/man/chage.1.xml
@@ -198,6 +198,21 @@
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term>
+         <option>-P</option>, <option>--prefix</option>&nbsp;<replaceable>PREFIX_DIR</replaceable>
+       </term>
+       <listitem>
+         <para>
+           Apply changes to configuration files under the root filesystem
+           found under the directory <replaceable>PREFIX_DIR</replaceable>.
+           This option does not chroot and is intended for preparing a cross-compilation
+           target.  Some limitations: NIS and LDAP users/groups are
+           not verified.  PAM authentication is using the host files.
+           No SELINUX support.
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term>
          <option>-W</option>, <option>--warndays</option>&nbsp;<replaceable>WARN_DAYS</replaceable>

diff --git a/man/chpasswd.8.xml b/man/chpasswd.8.xml
index 6353419c63e84788f1f50dd490f1aebcf05a9daf..1984573ab6e0aaf75d38068050997be419060396 100644 (file)
--- a/man/chpasswd.8.xml
+++ b/man/chpasswd.8.xml
@@ -173,6 +173,21 @@
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term>
+         <option>-P</option>, <option>--prefix</option>&nbsp;<replaceable>PREFIX_DIR</replaceable>
+       </term>
+       <listitem>
+         <para>
+           Apply changes to configuration files under the root filesystem
+           found under the directory <replaceable>PREFIX_DIR</replaceable>.
+           This option does not chroot and is intended for preparing a cross-compilation
+           target.  Some limitations: NIS and LDAP users/groups are
+           not verified.  PAM authentication is using the host files.
+           No SELINUX support.
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry condition="sha_crypt">
        <term>
          <option>-s</option>, <option>--sha-rounds</option>&nbsp;<replaceable>ROUNDS</replaceable>

diff --git a/man/passwd.1.xml b/man/passwd.1.xml
index 5491ded661dd117fae79c70df2748e699fc9e956..5fbfa6d178291adce1485f18a9599f65cec4fd30 100644 (file)
--- a/man/passwd.1.xml
+++ b/man/passwd.1.xml
@@ -280,6 +280,21 @@
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term>
+         <option>-P</option>, <option>--prefix</option>&nbsp;<replaceable>PREFIX_DIR</replaceable>
+       </term>
+       <listitem>
+         <para>
+           Apply changes to configuration files under the root filesystem
+           found under the directory <replaceable>PREFIX_DIR</replaceable>.
+           This option does not chroot and is intended for preparing a cross-compilation
+           target.  Some limitations: NIS and LDAP users/groups are
+           not verified.  PAM authentication is using the host files.
+           No SELINUX support.
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term>
          <option>-S</option>, <option>--status</option>