Attachment 18775 Details for Bug 15809 – patch for 4.23 and 4.22

[patch] patch for 4.23 and 4.22

0001-docs-xml-Improve-the-samba-bgqd-manpage.patch (text/plain), 2.99 KB, created by Andreas Schneider on 2025-11-17 09:16:17 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Andreas Schneider

Created: 2025-11-17 09:16:17 UTC

Size: 2.99 KB

patch

obsolete

>From 3ed6cac7c689b638c91e560d7e0cc6f87ba1d823 Mon Sep 17 00:00:00 2001
>From: Andreas Schneider <asn@samba.org>
>Date: Thu, 23 Oct 2025 11:00:38 +0200
>Subject: [PATCH] docs-xml: Improve the samba-bgqd manpage
>
>BUG: https://bugzilla.samba.org/show_bug.cgi?id=15809
>
>Signed-off-by: Andreas Schneider <asn@samba.org>
>Reviewed-by: Anoop C S <anoopcs@samba.org>
>
>Autobuild-User(master): Andreas Schneider <asn@cryptomilk.org>
>Autobuild-Date(master): Fri Nov 14 15:05:11 UTC 2025 on atb-devel-224
>
>(cherry picked from commit 9322231f716237abba8627acda62c279c6a90f4f)
>---
> docs-xml/manpages/samba-bgqd.8.xml | 37 +++++++++++++++++++++++++-----
> 1 file changed, 31 insertions(+), 6 deletions(-)
>
>diff --git a/docs-xml/manpages/samba-bgqd.8.xml b/docs-xml/manpages/samba-bgqd.8.xml
>index ef50a542a9e..9a16a2aaad0 100644
>--- a/docs-xml/manpages/samba-bgqd.8.xml
>+++ b/docs-xml/manpages/samba-bgqd.8.xml
>@@ -14,28 +14,53 @@
> <refnamediv>
> 	<refname>samba-bgqd</refname>
> 	<refpurpose>This is an internal helper program performing
>-	asynchronous printing-related jobs.</refpurpose>
>+	asynchronous printing-related tasks</refpurpose>
> </refnamediv>
> 
> <refsynopsisdiv>
> 	<cmdsynopsis>
> 		<command>samba-bgqd</command>
>+		<arg choice="opt">-D|--daemon</arg>
>+		<arg choice="opt">-i|--interactive</arg>
>+		<arg choice="opt">-F|--foreground</arg>
>+		<arg choice="opt">--no-process-group</arg>
>+		<arg choice="opt">-d &lt;debug level&gt;</arg>
>+		<arg choice="opt">--debug-stdout</arg>
>+		<arg choice="opt">--configfile=&lt;configuration file&gt;</arg>
>+		<arg choice="opt">--option=&lt;name&gt;=&lt;value&gt;</arg>
>+		<arg choice="opt">-l|--log-basename &lt;log directory&gt;</arg>
>+		<arg choice="opt">--ready-signal-fd &lt;fd&gt;</arg>
>+		<arg choice="opt">--parent-watch-fd &lt;fd&gt;</arg>
> 	</cmdsynopsis>
> </refsynopsisdiv>
> 
> <refsect1>
> 	<title>DESCRIPTION</title>
> 
>-	<para>This tool is part of the
>+	<para>This program is part of the
> 	<citerefentry><refentrytitle>samba</refentrytitle>
> 	<manvolnum>7</manvolnum></citerefentry> suite.</para>
> 
>-	<para>samba-bgqd is an helper program to be spawned by smbd or
>-	spoolssd to perform jobs like updating the printer list or
>-	other management tasks asynchronously on demand. It is not
>-	intended to be called by users or administrators.</para>
>+	<para><command>samba-bgqd</command> is not intended to be invoked
>+	directly by users.</para>
>+
>+	<para>Likewise, while <command>samba-bgqd</command> is also not
>+	intended to be run manually by system administrators, on systems with a
>+	large number of printers configured via CUPS, it is recommended to run
>+	<command>samba-bgqd</command> as a systemd service to improve
>+	performance and responsiveness of printing operations.</para>
> </refsect1>
> 
>+<refsect1>
>+	<title>SEE ALSO</title>
>+
>+	<para>
>+	<citerefentry><refentrytitle>smbd</refentrytitle>
>+	<manvolnum>8</manvolnum></citerefentry>, and
>+	<citerefentry><refentrytitle>smb.conf</refentrytitle>
>+	<manvolnum>5</manvolnum></citerefentry>.
>+	</para>
>+</refsect1>
> <refsect1>
> 	<title>AUTHOR</title>
> 
>-- 
>2.51.1
>

Flags:

ab: review+

Actions: View

Attachments on bug 15809: 18775