]> git.ipfire.org Git - thirdparty/cups.git/commitdiff
Do some cleanup and generate the HTML version of the cupsd.conf man page.
authorMichael R Sweet <msweet@msweet.org>
Mon, 4 May 2026 11:55:19 +0000 (07:55 -0400)
committerMichael R Sweet <msweet@msweet.org>
Mon, 4 May 2026 11:55:19 +0000 (07:55 -0400)
doc/help/man-cupsd.conf.html
man/cupsd.conf.5
scheduler/conf.c
scheduler/dirsvc.c

index 09bab9937231b4d4bbb299a712c88e3105d4a560..ae3eba6b7df55e59334fa899604184d2663f663e 100644 (file)
@@ -50,6 +50,13 @@ The default is &quot;No&quot;.
 <br>
 Specifies the DNS-SD sub-types to advertise, separated by commas.
 The default is &quot;_cups,_print,_universal&quot; to advertise shared printers to CUPS, IPP Everywhere, and AirPrint clients, respectively.
+</p>
+    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseIPPSOnly Yes</strong><br>
+</p>
+    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseIPPSOnly No</strong><br>
+<br>
+Specifies whether the scheduler only advertises secure (IPPS) services for shared printers.
+The default is &quot;No&quot;.
 </p>
     <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseLocalProtocols all</strong><br>
 </p>
@@ -896,6 +903,6 @@ often belongs to a different set of subnets from its clients.
 CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
 </p>
     <h2 id="cupsd.conf-5.copyright">Copyright</h2>
-<p>Copyright &copy; 2020-2025 by OpenPrinting.
+<p>Copyright &copy; 2020-2026 by OpenPrinting.
   </body>
 </html>
index 94f7d2e32b02fce1c2b74df70c2e4d09942f6d2d..a34d16a08d042146c246330708c0e253a4c3fb83 100644 (file)
@@ -1,14 +1,14 @@
 .\"
 .\" cupsd.conf man page for CUPS.
 .\"
-.\" Copyright © 2020-2025 by OpenPrinting.
+.\" Copyright © 2020-2026 by OpenPrinting.
 .\" Copyright © 2007-2019 by Apple Inc.
 .\" Copyright © 1997-2006 by Easy Software Products.
 .\"
 .\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
 .\" information.
 .\"
-.TH cupsd.conf 5 "CUPS" "2025-04-14" "OpenPrinting"
+.TH cupsd.conf 5 "CUPS" "2026-05-04" "OpenPrinting"
 .SH NAME
 cupsd.conf \- server configuration file for cups
 .SH DESCRIPTION
@@ -51,6 +51,14 @@ The default is "No".
 .BI BrowseDNSSDSubTypes _subtype[,...]
 Specifies the DNS-SD sub-types to advertise, separated by commas.
 The default is "_cups,_print,_universal" to advertise shared printers to CUPS, IPP Everywhere, and AirPrint clients, respectively.
+.\"#BrowseIPPSOnly
+.TP 5
+\fBBrowseIPPSOnly Yes\fR
+.TP 5
+\fBBrowseIPPSOnly No\fR
+.br
+Specifies whether the scheduler only advertises secure (IPPS) services for shared printers.
+The default is "No".
 .\"#BrowseLocalProtocols
 .TP 5
 \fBBrowseLocalProtocols all\fR
@@ -68,14 +76,6 @@ The default is "dnssd" on systems that support DNS-SD and "none" otherwise.
 .br
 Specifies whether the CUPS web interface is advertised.
 The default is "No".
-.\"#BrowseIPPSOnly
-.TP 5
-\fBBrowseIPPSOnly Yes\fR
-.TP 5
-\fBBrowseIPPSOnly No\fR
-.br
-Specifies whether to only advertise IPPS services.
-The default is "No".
 .\"#Browsing
 .TP 5
 \fBBrowsing Yes\fR
@@ -939,4 +939,4 @@ Require authentication for accesses from outside the 10. network:
 .BR subscriptions.conf (5),
 CUPS Online Help (http://localhost:631/help)
 .SH COPYRIGHT
-Copyright \[co] 2020-2025 by OpenPrinting.
+Copyright \[co] 2020-2026 by OpenPrinting.
index 5d3bbc44734ece118584897748c6e7e0487fecb2..e55afdbd7ef13778cfed3ac48a23e44cdc86c123 100644 (file)
@@ -68,7 +68,7 @@ static const cupsd_var_t      cupsd_vars[] =
 {
   { "AutoPurgeJobs",           &JobAutoPurge,          CUPSD_VARTYPE_BOOLEAN },
   { "BrowseDNSSDSubTypes",     &DNSSDSubTypes,         CUPSD_VARTYPE_NULLSTRING },
-  { "BrowseIPPSOnly",  &BrowseIPPSOnly,        CUPSD_VARTYPE_BOOLEAN },
+  { "BrowseIPPSOnly",          &BrowseIPPSOnly,        CUPSD_VARTYPE_BOOLEAN },
   { "BrowseWebIF",             &BrowseWebIF,           CUPSD_VARTYPE_BOOLEAN },
   { "Browsing",                        &Browsing,              CUPSD_VARTYPE_BOOLEAN },
   { "Classification",          &Classification,        CUPSD_VARTYPE_STRING },
index 2d4622efc4ba6915758286a9b3810f8472c51afc..1c05c80ad699bec2e3a3a7ce370ee19c567f6b7b 100644 (file)
@@ -1,7 +1,7 @@
 /*
  * Directory services routines for the CUPS scheduler.
  *
- * Copyright © 2020-2025 by OpenPrinting.
+ * Copyright © 2020-2026 by OpenPrinting.
  * Copyright © 2007-2018 by Apple Inc.
  * Copyright © 1997-2007 by Easy Software Products, all rights reserved.
  *
@@ -43,8 +43,8 @@ cupsdDeregisterPrinter(
     int             removeit)          /* I - Printer being permanently removed */
 {
  /*
-   * Only deregister if browsing is enabled and it's a local printer...
-   */
+  * Only deregister if browsing is enabled and it's a local printer...
+  */
 
   cupsdLogMessage(CUPSD_LOG_DEBUG2, "cupsdDeregisterPrinter(p=%p(%s), removeit=%d)", (void *)p, p->name, removeit);
 
@@ -460,8 +460,8 @@ dnssdRegisterPrinter(
 {
   char         name[256],              /* Service name */
                regtype[256];           /* Registration type(s) */
-  int          num_txt = 0;            /* Number of IPP(S) TXT key/value pairs */
-  cups_option_t        *txt = NULL;            /* IPP(S) TXT key/value pairs */
+  int          num_txt;                /* Number of IPP(S) TXT key/value pairs */
+  cups_option_t        *txt;                   /* IPP(S) TXT key/value pairs */
   bool         status;                 /* Registration status */
 
 
@@ -477,7 +477,7 @@ dnssdRegisterPrinter(
 
   if (!p->shared)
     return;
-  
+
  /*
   * Set the registered name as needed; the registered name takes the form of
   * "<printer-info> @ <computer name>"...
@@ -519,29 +519,31 @@ dnssdRegisterPrinter(
   // LPD placeholder
   status &= cupsDNSSDServiceAdd(p->dnssd, "_printer._tcp", /*domain*/NULL, DNSSDHostName, /*port*/0, /*num_txt*/0, /*txt*/NULL);
 
-  // IPP service
+  // IPP/IPPS services
   num_txt = dnssdBuildTxtRecord(p, &txt);
+
   if (!BrowseIPPSOnly)
   {
-
+    // Add IPP service...
     if (p->type & CUPS_PTYPE_FAX)
-  {
-    if (DNSSDSubTypes)
-      snprintf(regtype, sizeof(regtype), "_fax-ipp._tcp,%s", DNSSDSubTypes);
-    else
-      cupsCopyString(regtype, "_fax-ipp._tcp", sizeof(regtype));
-  }
-  else
-  {
-    if (DNSSDSubTypes)
-      snprintf(regtype, sizeof(regtype), "_ipp._tcp,%s", DNSSDSubTypes);
+    {
+      if (DNSSDSubTypes)
+       snprintf(regtype, sizeof(regtype), "_fax-ipp._tcp,%s", DNSSDSubTypes);
+      else
+       cupsCopyString(regtype, "_fax-ipp._tcp", sizeof(regtype));
+    }
     else
-      cupsCopyString(regtype, "_ipp._tcp", sizeof(regtype));
-  }
+    {
+      if (DNSSDSubTypes)
+       snprintf(regtype, sizeof(regtype), "_ipp._tcp,%s", DNSSDSubTypes);
+      else
+       cupsCopyString(regtype, "_ipp._tcp", sizeof(regtype));
+    }
 
-  status &= cupsDNSSDServiceAdd(p->dnssd, regtype, /*domain*/NULL, DNSSDHostName, (uint16_t)DNSSDPort, num_txt, txt);
+    status &= cupsDNSSDServiceAdd(p->dnssd, regtype, /*domain*/NULL, DNSSDHostName, (uint16_t)DNSSDPort, num_txt, txt);
   }
-  // IPPS service
+
+  // Add IPPS service...
   if (DNSSDSubTypes)
     snprintf(regtype, sizeof(regtype), "_ipps._tcp,%s", DNSSDSubTypes);
   else
@@ -551,6 +553,7 @@ dnssdRegisterPrinter(
 
   cupsFreeOptions(num_txt, txt);
 
+  // Publish all services...
   status &= cupsDNSSDServicePublish(p->dnssd);
 
   if (status)