From: Michael R Sweet Date: Sat, 28 Nov 2020 13:55:31 +0000 (-0500) Subject: Update cupsd.conf man page to talk about Listen * vs Listen address (Issue #53) X-Git-Tag: v2.3.3op2~22 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fc9167da38318860b7fec1df6e2e44bf3f4198c8;p=thirdparty%2Fcups.git Update cupsd.conf man page to talk about Listen * vs Listen address (Issue #53) --- diff --git a/CHANGES-OPENPRINTING.md b/CHANGES-OPENPRINTING.md index de619311ff..fc249f69f8 100644 --- a/CHANGES-OPENPRINTING.md +++ b/CHANGES-OPENPRINTING.md @@ -1,6 +1,12 @@ OpenPrinting CUPS Changes ========================= +Changes in CUPS v2.3.3op2 +------------------------- + +- Clarified the documentation for the "Listen" directive (Issue #53) + + Changes in CUPS v2.3.3op1 ------------------------- diff --git a/doc/help/man-cups-files.conf.html b/doc/help/man-cups-files.conf.html index 08d886d83f..a429e0283f 100644 --- a/doc/help/man-cups-files.conf.html +++ b/doc/help/man-cups-files.conf.html @@ -213,6 +213,7 @@ command is used instead. CUPS Online Help (http://localhost:631/help)

Copyright

Copyright © 2020 by Michael R Sweet +
Copyright © 2007-2019 by Apple Inc. diff --git a/doc/help/man-cupsd.conf.html b/doc/help/man-cupsd.conf.html index 1668eee8af..453e3006c9 100644 --- a/doc/help/man-cupsd.conf.html +++ b/doc/help/man-cupsd.conf.html @@ -163,6 +163,7 @@ The default is "0" which disables the limit check.
Listens to the specified address and port or domain socket path for connections. Multiple Listen directives can be provided to listen on multiple addresses. The Listen directive is similar to the Port directive but allows you to restrict access to specific interfaces or networks. +Note: "Listen *:port" and "Port port" effectively listen on all IP addresses, so you cannot combine them with Listen directives for explicit IPv4 or IPv6 addresses on the same port.
ListenBackLog number
Specifies the number of pending connections that will be allowed. This normally only affects very busy servers that have reached the MaxClients limit, but can also be triggered by large numbers of simultaneous connections. @@ -624,6 +625,8 @@ Require authentication for accesses from outside the 10. network: subscriptions.conf(5), CUPS Online Help (http://localhost:631/help)

Copyright

+Copyright © 2020 by Michael R Sweet +
Copyright © 2007-2019 by Apple Inc. diff --git a/man/cups-files.conf.5 b/man/cups-files.conf.5 index 97c4e70591..1cfb6273cc 100644 --- a/man/cups-files.conf.5 +++ b/man/cups-files.conf.5 @@ -295,4 +295,5 @@ command is used instead. CUPS Online Help (http://localhost:631/help) .SH COPYRIGHT Copyright \[co] 2020 by Michael R Sweet +.br Copyright \[co] 2007-2019 by Apple Inc. diff --git a/man/cupsd.conf.5 b/man/cupsd.conf.5 index 00b1a22d66..49ab745c62 100644 --- a/man/cupsd.conf.5 +++ b/man/cupsd.conf.5 @@ -1,13 +1,14 @@ .\" .\" cupsd.conf man page for CUPS. .\" +.\" Copyright © 2020 by Michael R Sweet .\" 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" "16 July 2019" "Apple Inc." +.TH cupsd.conf 5 "CUPS" "28 November 2020" "Apple Inc." .SH NAME cupsd.conf \- server configuration file for cups .SH DESCRIPTION @@ -245,6 +246,7 @@ The default is "0" which disables the limit check. Listens to the specified address and port or domain socket path for connections. Multiple Listen directives can be provided to listen on multiple addresses. The Listen directive is similar to the Port directive but allows you to restrict access to specific interfaces or networks. +Note: "Listen *:\fIport\fR" and "Port \fIport\fR" effectively listen on all IP addresses, so you cannot combine them with Listen directives for explicit IPv4 or IPv6 addresses on the same port. .\"#ListenBackLog .TP 5 \fBListenBackLog \fInumber\fR @@ -902,4 +904,6 @@ 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 by Michael R Sweet +.br Copyright \[co] 2007-2019 by Apple Inc.