From: Jennifer Sutton <jennifersutton@catalyst.net.nz>
Date: Mon, 3 Nov 2025 03:50:52 +0000 (+1300)
Subject: docs-xml: Document samba-tool subcommand to generate Certificate Signing Requests
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d3aa479f962574c56f754bc407763f9a7ec9778c;p=thirdparty%2Fsamba.git

docs-xml: Document samba-tool subcommand to generate Certificate Signing Requests

Signed-off-by: Jennifer Sutton <jennifersutton@catalyst.net.nz>
Reviewed-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
Reviewed-by: Gary Lockyer <gary@catalyst.net.nz>

Autobuild-User(master): Douglas Bagnall <dbagnall@samba.org>
Autobuild-Date(master): Wed Nov  5 05:13:01 UTC 2025 on atb-devel-224
---

diff --git a/docs-xml/manpages/samba-tool.8.xml b/docs-xml/manpages/samba-tool.8.xml
index b27b168f471..9f6deee342e 100644
--- a/docs-xml/manpages/samba-tool.8.xml
+++ b/docs-xml/manpages/samba-tool.8.xml
@@ -384,6 +384,26 @@ The <constant>--verbose</constant> includes more, probably useless, information.
 </variablelist>
 </refsect3>
 
+<refsect3>
+	<title>computer generate-csr <replaceable>computername</replaceable>
+	<replaceable>subject_name</replaceable>
+	<replaceable>private_key_filename</replaceable>
+	<replaceable>output_filename</replaceable> [options]</title>
+	<para>Generate a PEM‐encoded Certificate Signing Request for a computer.</para>
+
+	<variablelist>
+	<!--Options-->
+	  <varlistentry>
+	    <term>--private-key-encoding</term>
+	    <listitem><para>Specify which encoding the private key uses. Default is 'auto'.</para></listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term>--private-key-pass</term>
+	    <listitem><para>Provide a password to decrypt the private key.</para></listitem>
+	  </varlistentry>
+	</variablelist>
+</refsect3>
+
 
 <refsect2>
 	<title>contact</title>
@@ -4482,6 +4502,26 @@ The <constant>--verbose</constant> includes more, probably useless, information.
 </variablelist>
 </refsect3>
 
+<refsect3>
+	<title>user generate-csr <replaceable>username</replaceable>
+	<replaceable>subject_name</replaceable>
+	<replaceable>private_key_filename</replaceable>
+	<replaceable>output_filename</replaceable> [options]</title>
+	<para>Generate a PEM‐encoded Certificate Signing Request for a user.</para>
+
+	<variablelist>
+	<!--Options-->
+	  <varlistentry>
+	    <term>--private-key-encoding</term>
+	    <listitem><para>Specify which encoding the private key uses. Default is 'auto'.</para></listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term>--private-key-pass</term>
+	    <listitem><para>Provide a password to decrypt the private key.</para></listitem>
+	  </varlistentry>
+	</variablelist>
+</refsect3>
+
 
 <refsect2>
 	<title>vampire [options] <replaceable>domain</replaceable></title>