diff --git a/doc/help/man-backend.html b/doc/help/man-backend.html index b1a0385d5..953a26789 100644 --- a/doc/help/man-backend.html +++ b/doc/help/man-backend.html @@ -178,7 +178,7 @@

Notes

lpinfo(8) to query for available printers using the backend. The one exception is the SNMP backend - see -cups-snmp(8) +cups-snmp(8) for more information.

Notes

CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS. diff --git a/doc/help/man-cancel.html b/doc/help/man-cancel.html index ef6f3f45d..c02f6f1ef 100644 --- a/doc/help/man-cancel.html +++ b/doc/help/man-cancel.html @@ -75,9 +75,9 @@

Examples

Notes

Administrators wishing to prevent unauthorized cancellation of jobs via the -u option should require authentication for Cancel-Jobs operations in -cupsd.conf(5). +cupsd.conf(5).

See Also

-cupsd.conf(5), +cupsd.conf(5), lp(1), lpmove(8), lpstat(1), diff --git a/doc/help/man-classes.conf.html b/doc/help/man-classes.conf.html index da5126d60..f30ec909e 100644 --- a/doc/help/man-classes.conf.html +++ b/doc/help/man-classes.conf.html @@ -12,14 +12,14 @@

Name

Description

The classes.conf file defines the local printer classes that are available. It is normally located in the /etc/cups directory and is maintained by the -cupsd(8) +cupsd(8) program. This file is not intended to be edited or managed manually.

Notes

The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.

See Also

-cupsd(8), -cupsd.conf(5), +cupsd(8), +cupsd.conf(5), mime.convs(5), mime.types(5), printers.conf(5), diff --git a/doc/help/man-cups-files.conf.html b/doc/help/man-cups-files.conf.html index 27a1b60da..c567cbba7 100644 --- a/doc/help/man-cups-files.conf.html +++ b/doc/help/man-cups-files.conf.html @@ -11,7 +11,7 @@

Name

cups-files.conf - file and directory configuration file for cups

Description

The cups-files.conf file configures the files and directories used by the CUPS scheduler, -cupsd(8). +cupsd(8). It is normally located in the /etc/cups directory.

Each line in the file can be a configuration directive, a blank line, or a comment. Configuration directives typically consist of a name and zero or more values separated by whitespace. @@ -19,7 +19,7 @@

Description

Comment lines start with the # character.

Directives

The following directives are understood by -cupsd(8): +cupsd(8):
AccessLog
AccessLog filename @@ -201,8 +201,8 @@

Notes

See Also

classes.conf(5), cups(1), -cupsd(8), -cupsd.conf(5), +cupsd(8), +cupsd.conf(5), mime.convs(5), mime.types(5), printers.conf(5), diff --git a/doc/help/man-cups-lpd.html b/doc/help/man-cups-lpd.html index 7283d7563..ad0e68ed0 100644 --- a/doc/help/man-cups-lpd.html +++ b/doc/help/man-cups-lpd.html @@ -103,7 +103,7 @@

Example

service using the corresponding control program.

See Also

cups(1), -cupsd(8), +cupsd(8), inetconv(1m), inetd(8), launchd(8), diff --git a/doc/help/man-cups-snmp.conf.html b/doc/help/man-cups-snmp.conf.html index fbd2dc4eb..d61d8340f 100644 --- a/doc/help/man-cups-snmp.conf.html +++ b/doc/help/man-cups-snmp.conf.html @@ -15,7 +15,7 @@

Description

file configures how the standard CUPS network backends (http, https, ipp, ipps, lpd, snmp, and socket) access printer information using SNMPv1 and is normally located in the /etc/cups directory. Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.

The Community and DebugLevel directives are used by all backends. The remainder apply only to the SNMP backend - -cups-snmp(8). +cups-snmp(8).

Directives

The following directives are understood by the CUPS network backends:
@@ -51,7 +51,7 @@

Notes

Printers that do not support IPP can be supported using applications such as ippeveprinter(1).

See Also

-cups-snmp(8), +cups-snmp(8), CUPS Online Help (http://localhost:631/help)

Copyright

Copyright © 2007-2019 by Apple Inc. diff --git a/doc/help/man-cups-snmp.html b/doc/help/man-cups-snmp.html index 9ff2b9aef..c7c17f7f4 100644 --- a/doc/help/man-cups-snmp.html +++ b/doc/help/man-cups-snmp.html @@ -47,7 +47,7 @@

Conforming To

See Also

backend(7), cups-snmp.conf(5), -cupsd(8), +cupsd(8), lpinfo(8), CUPS Online Help (http://localhost:631/help)

Copyright

diff --git a/doc/help/man-cups.html b/doc/help/man-cups.html index 769ffe64c..d75ddc5b0 100644 --- a/doc/help/man-cups.html +++ b/doc/help/man-cups.html @@ -102,13 +102,13 @@

Notes

ippeveprinter(1).

See Also

cancel(1), -client.conf(7), +client.conf(7), cupsctl(8), -cupsd(8), +cupsd(8), lp(1), lpadmin(8), lpinfo(8), -lpoptions(1), +lpoptions(1), lpr(1), lprm(1), lpq(1), diff --git a/doc/help/man-cupsctl.html b/doc/help/man-cupsctl.html index 897b0541e..c52125fc7 100644 --- a/doc/help/man-cupsctl.html +++ b/doc/help/man-cupsctl.html @@ -83,8 +83,8 @@

Examples

Known Issues

You cannot set the Listen or Port directives using cupsctl.

See Also

-cupsd.conf(5), -cupsd(8), +cupsd.conf(5), +cupsd(8),
CUPS Online Help (http://localhost:631/help)

Copyright

diff --git a/doc/help/man-cupsd-helper.html b/doc/help/man-cupsd-helper.html index 308a3a236..e701445d6 100644 --- a/doc/help/man-cupsd-helper.html +++ b/doc/help/man-cupsd-helper.html @@ -44,7 +44,7 @@

Synopsis

argvN

Description

The cupsd-helper programs perform long-running operations on behalf of the scheduler, -cupsd(8). +cupsd(8). The cups-deviced helper program runs each CUPS backend(7) with no arguments in order to discover the available printers. @@ -76,8 +76,8 @@

Notes

See Also

backend(7), cups(1), -cupsd(8), -cupsd.conf(5), +cupsd(8), +cupsd.conf(5), filter(7), ppdcfile(5), CUPS Online Help (http://localhost:631/help) diff --git a/doc/help/man-cupsd-logs.html b/doc/help/man-cupsd-logs.html index 42d06faad..11aac7a76 100644 --- a/doc/help/man-cupsd-logs.html +++ b/doc/help/man-cupsd-logs.html @@ -10,12 +10,12 @@

cupsd-logs(5)

Name

cupsd-logs - cupsd log files (access_log, error_log, and page_log)

Description

-cupsd(8) +cupsd(8) normally maintains three log files: access_log to track requests that are submitted to the scheduler, error_log to track progress and errors, and page_log to track pages that are printed. Configuration directives in -cupsd.conf(5) +cupsd.conf(5) and -cups-files.conf(5) +cups-files.conf(5) control what information is logged and where it is stored.

Access Log File Format

The access_log file lists each HTTP resource that is accessed by a web browser or client. @@ -93,7 +93,7 @@

Access Log File Format

The ipp-status field contains either "-" for non-IPP requests or the IPP status code name for POST requests containing an IPP response.

Error Log File Format

The error_log file lists messages from the scheduler - errors, warnings, etc. The LogLevel directive in the -cupsd.conf(5) +cupsd.conf(5) file controls which messages are logged: 
 
@@ -158,7 +158,7 @@ 
Page Log File Format
The PageLogFormat directive in the -cupsd.conf(5) +cupsd.conf(5) file can be used to change this information.

The printer field contains the name of the printer that printed the page. If you send a job to a printer class, this field will contain the name of the printer that was assigned the job. @@ -173,9 +173,9 @@

Page Log File Format

The media field contains a copy of the media or media-col/media-size attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.

The sides field contains a copy of the sides attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.

See Also

-cupsd(8), -cupsd.conf(5), -cups-files.conf(5), +cupsd(8), +cupsd.conf(5), +cups-files.conf(5), CUPS Online Help (http://localhost:631/help)

Copyright

Copyright © 2007-2019 by Apple Inc. diff --git a/doc/help/man-cupsd.conf.html b/doc/help/man-cupsd.conf.html index 6252546c5..70e00b5be 100644 --- a/doc/help/man-cupsd.conf.html +++ b/doc/help/man-cupsd.conf.html @@ -13,7 +13,7 @@

Description

The cupsd.conf file configures the CUPS scheduler, -cupsd(8). +cupsd(8). It is normally located in the /etc/cups directory. @@ -23,7 +23,7 @@

Description

Comment lines start with the # character.

Top-level Directives

The following top-level directives are understood by -cupsd(8): +cupsd(8):
AccessLogLevel config
AccessLogLevel actions @@ -119,7 +119,7 @@

Top-level Directives

HostNameLookups Double
Specifies whether to do reverse lookups on connecting clients. The "Double" setting causes -cupsd(8) +cupsd(8) to verify that the hostname resolved from the address matches one of the addresses returned for that hostname. Double lookups also prevent clients with unregistered addresses from connecting to your server. The default is "Off" to avoid the potential server performance problems with hostname lookups. @@ -128,7 +128,7 @@

Top-level Directives

Specifies the length of time to wait before shutting down due to inactivity. The default is "60" seconds. Note: Only applicable when -cupsd(8) +cupsd(8) is run on-demand (e.g., with -l).
JobKillDelay seconds
Specifies the number of seconds to wait before killing the filters and backend associated with a canceled or held job. @@ -160,11 +160,6 @@

Top-level Directives

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. -
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. -When the limit is reached, the operating system will refuse additional connections until the scheduler can accept the pending ones. -The default is the OS-defined default limit, typically either "5" for older operating systems or "128" for newer operating systems.
<Location /path> ... </Location>
Specifies access control for the named location. Paths are documented below in the section "LOCATION PATHS". @@ -304,7 +299,7 @@

Top-level Directives

Http Method Names

The following HTTP methods are supported by -cupsd(8): +cupsd(8):
GET
Used by a client to download icons and other printer resources and to access the CUPS web interface. @@ -319,7 +314,7 @@

Http Method Names

Ipp Operation Names

The following IPP operations are supported by -cupsd(8): +cupsd(8):
CUPS-Accept-Jobs
Allows a printer to accept new jobs. @@ -412,7 +407,7 @@

Ipp Operation Names

Location Paths

The following paths are commonly used when configuring -cupsd(8): +cupsd(8):
/
The path for all get operations (get-printers, get-jobs, etc.) @@ -492,7 +487,7 @@

Directives Val
Require user {user-name|@group-name} ...
Specifies that an authenticated user must match one of the named users or be a member of one of the named groups. The group name "@SYSTEM" corresponds to the list of groups defined by the SystemGroup directive in the -cups-files.conf(5) +cups-files.conf(5) file. The group name "@OWNER" corresponds to the owner of the resource, for example the person that submitted a print job. Note: The 'root' user is not special and must be granted privileges like any other user account. @@ -515,7 +510,7 @@

Directives Valid Within Po "@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values. "@OWNER" maps to the job's owner. "@SYSTEM" maps to the groups listed for the SystemGroup directive in the -cups-files.conf(5) +cups-files.conf(5) file.
JobPrivateValues all
JobPrivateValues default @@ -531,7 +526,7 @@

Directives Valid Within Po "@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values. "@OWNER" maps to the job's owner. "@SYSTEM" maps to the groups listed for the SystemGroup directive in the -cups-files.conf(5) +cups-files.conf(5) file.
SubscriptionPrivateValues all
SubscriptionPrivateValues default @@ -553,6 +548,9 @@

Deprecated Directives


Specifies whether users may override the classification (cover page) of individual print jobs using the "job-sheets" option. The default is "No". +
ListenBackLog number +
Specified the number of pending connections that will be allowed. +The scheduler now uses the value "128" on all platforms.
PageLogFormat format-string
Specifies the format of PageLog lines. Sequences beginning with percent (%) characters are replaced with the corresponding information, while all other characters are copied literally. @@ -578,7 +576,7 @@

Deprecated Directives

Notes

File, directory, and user configuration directives that used to be allowed in the cupsd.conf file are now stored in the -cups-files.conf(5) +cups-files.conf(5) file instead in order to prevent certain types of privilege escalation attacks.

The scheduler MUST be restarted manually after making changes to the cupsd.conf file. On Linux this is typically done using the @@ -613,15 +611,15 @@

Examples

See Also

classes.conf(5), -cups-files.conf(5), -cupsd(8), +cups-files.conf(5), +cupsd(8), mime.convs(5), mime.types(5), printers.conf(5), subscriptions.conf(5), CUPS Online Help (http://localhost:631/help)

Copyright

-Copyright © 2007-2019 by Apple Inc. +Copyright © 2007-2021 by Apple Inc. diff --git a/doc/help/man-cupsd.html b/doc/help/man-cupsd.html index d99136a1b..589207103 100644 --- a/doc/help/man-cupsd.html +++ b/doc/help/man-cupsd.html @@ -104,9 +104,9 @@

See Also

backend(7), classes.conf(5), cups(1), -cups-files.conf(5), -cups-lpd(8), -cupsd.conf(5), +cups-files.conf(5), +cups-lpd(8), +cupsd.conf(5), cupsd-helper(8), cupsd-logs(8), filter(7), diff --git a/doc/help/man-cupsfilter.html b/doc/help/man-cupsfilter.html index 6e9d81d89..bce2134db 100644 --- a/doc/help/man-cupsfilter.html +++ b/doc/help/man-cupsfilter.html @@ -117,7 +117,7 @@

Example

See Also

cups(1), -cupsd.conf(5), +cupsd.conf(5), filter(7), mime.convs(7), mime.types(7), diff --git a/doc/help/man-filter.html b/doc/help/man-filter.html index c8070497b..65d896b57 100644 --- a/doc/help/man-filter.html +++ b/doc/help/man-filter.html @@ -177,8 +177,8 @@

Notes

See Also

backend(7), cups(1), -cups-files.conf(5), -cupsd(8), +cups-files.conf(5), +cupsd(8), cupsfilter(8),
CUPS Online Help (http://localhost:631/help) diff --git a/doc/help/man-lp.html b/doc/help/man-lp.html index 09b921fb3..ba221270f 100644 --- a/doc/help/man-lp.html +++ b/doc/help/man-lp.html @@ -86,7 +86,7 @@

Description

The Default Destination

CUPS provides many ways to set the default destination. The LPDEST and PRINTER environment variables are consulted first. If neither are set, the current default set using the -lpoptions(1) +lpoptions(1) command is used, followed by the default set using the lpadmin(8) command. @@ -138,7 +138,7 @@

Options

Common Job Options

Aside from the printer-specific options reported by the -lpoptions(1) +lpoptions(1) command, the following generic options are available:
-o job-sheets=name @@ -190,7 +190,7 @@

Examples

See Also

cancel(1), lpadmin(8), -lpoptions(1), +lpoptions(1), lpq(1), lpr(1), lprm(1), diff --git a/doc/help/man-lpadmin.html b/doc/help/man-lpadmin.html index 1ce68ab29..755bf2fd9 100644 --- a/doc/help/man-lpadmin.html +++ b/doc/help/man-lpadmin.html @@ -60,7 +60,7 @@

Description

or lpr(1) commands will use this destination unless the user specifies otherwise with the -lpoptions(1) +lpoptions(1) command.

The second form of the command (-p) configures the named printer or class. The additional options are described below.

The third form of the command (-x) deletes the printer or class destination. @@ -99,7 +99,7 @@

Options

-o name=value
Sets a PPD option for the printer. PPD options can be listed using the -l option with the -lpoptions(1) +lpoptions(1) command.
-o name-default=value
Sets a default server-side option for the destination. @@ -189,7 +189,7 @@

See Also

cupsaccept(8), cupsenable(8), lpinfo(8), -lpoptions(1), +lpoptions(1), CUPS Online Help (http://localhost:631/help)

Copyright

Copyright © 2007-2019 by Apple Inc. diff --git a/doc/help/man-lpr.html b/doc/help/man-lpr.html index 37970b408..c945ea9c8 100644 --- a/doc/help/man-lpr.html +++ b/doc/help/man-lpr.html @@ -56,7 +56,7 @@

Description

The Default Destination

CUPS provides many ways to set the default destination. The LPDEST and PRINTER environment variables are consulted first. If neither are set, the current default set using the -lpoptions(1) +lpoptions(1) command is used, followed by the default set using the lpadmin(8) command. @@ -97,7 +97,7 @@

Options

Common Job Options

Aside from the printer-specific options reported by the -lpoptions(1) +lpoptions(1) command, the following generic options are available:
-o job-sheets=name @@ -148,7 +148,7 @@

See Also

cancel(1), lp(1), lpadmin(8), -lpoptions(1), +lpoptions(1), lpq(1), lprm(1), lpstat(1), diff --git a/doc/help/man-mailto.conf.html b/doc/help/man-mailto.conf.html index 47dc7a455..8f5b87cbb 100644 --- a/doc/help/man-mailto.conf.html +++ b/doc/help/man-mailto.conf.html @@ -33,7 +33,7 @@

Directives

Specifies a prefix string for the subject line of an email notification.

See Also

-cupsd(8), +cupsd(8), CUPS Online Help (http://localhost:631/help)

Copyright

Copyright © 2007-2019 by Apple Inc. diff --git a/doc/help/man-mime.convs.html b/doc/help/man-mime.convs.html index 6afbc71a3..e4d8813c8 100644 --- a/doc/help/man-mime.convs.html +++ b/doc/help/man-mime.convs.html @@ -46,9 +46,9 @@

Notes

Printers that do not support IPP can be supported using applications such as ippeveprinter(1).

See Also

-cups-files.conf(5), -cupsd.conf(5), -cupsd(8), +cups-files.conf(5), +cupsd.conf(5), +cupsd(8), cupsfilter(8), mime.types(5), CUPS Online Help (http://localhost:631/help) diff --git a/doc/help/man-mime.types.html b/doc/help/man-mime.types.html index 28d166cac..cc4393ef8 100644 --- a/doc/help/man-mime.types.html +++ b/doc/help/man-mime.types.html @@ -84,9 +84,9 @@

Examples

string(4,PwgRaster<00>) priority(150)

See Also

-cups-files.conf(5), -cupsd.conf(5), -cupsd(8), +cups-files.conf(5), +cupsd.conf(5), +cupsd(8), cupsfilter(8), mime.convs(5), CUPS Online Help (http://localhost:631/help) diff --git a/doc/help/man-notifier.html b/doc/help/man-notifier.html index 27e051fdb..d8d96d36c 100644 --- a/doc/help/man-notifier.html +++ b/doc/help/man-notifier.html @@ -27,7 +27,7 @@

Description

Notifiers inherit the environment and can use the logging mechanism documented in filter(7).

See Also

-cupsd(8), +cupsd(8), filter(7), CUPS Online Help (http://localhost:631/help)

Copyright

diff --git a/doc/help/man-printers.conf.html b/doc/help/man-printers.conf.html index a2f8ba68e..4a3123ea5 100644 --- a/doc/help/man-printers.conf.html +++ b/doc/help/man-printers.conf.html @@ -11,15 +11,15 @@

Name

printers.conf - printer configuration file for cups

Description

The printers.conf file defines the local printers that are available. It is normally located in the /etc/cups directory and is maintained by the -cupsd(8) +cupsd(8) program. This file is not intended to be edited or managed manually.

Notes

The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.

See Also

classes.conf(5), -cups-files.conf(5), -cupsd(8), -cupsd.conf(5), +cups-files.conf(5), +cupsd(8), +cupsd.conf(5), mime.convs(5), mime.types(5), subscriptions.conf(5), diff --git a/doc/help/man-subscriptions.conf.html b/doc/help/man-subscriptions.conf.html index fb7ec0287..325f2cd28 100644 --- a/doc/help/man-subscriptions.conf.html +++ b/doc/help/man-subscriptions.conf.html @@ -12,16 +12,16 @@

Name

Description

The subscriptions.conf file defines the local event notification subscriptions that are active. It is normally located in the /etc/cups directory and is maintained by the -cupsd(8) +cupsd(8) program. This file is not intended to be edited or managed manually.

Notes

The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.

See Also

classes.conf(5), -cups-files.conf(5), -cupsd(8), -cupsd.conf(5), +cups-files.conf(5), +cupsd(8), +cupsd.conf(5), mime.convs(5), mime.types(5), printers.conf(5), diff --git a/man/cupsd.conf.5 b/man/cupsd.conf.5 index 643651269..beeccc69a 100644 --- a/man/cupsd.conf.5 +++ b/man/cupsd.conf.5 @@ -1,13 +1,13 @@ .\" .\" cupsd.conf man page for CUPS. .\" -.\" Copyright © 2007-2019 by Apple Inc. +.\" Copyright © 2007-2021 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" "1 October 2021" "Apple Inc." .SH NAME cupsd.conf \- server configuration file for cups .SH DESCRIPTION @@ -240,13 +240,6 @@ 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. -.\"#ListenBackLog -.TP 5 -\fBListenBackLog \fInumber\fR -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. -When the limit is reached, the operating system will refuse additional connections until the scheduler can accept the pending ones. -The default is the OS-defined default limit, typically either "5" for older operating systems or "128" for newer operating systems. .\"#Location .TP 5 \fB \fR... \fB\fR @@ -824,6 +817,11 @@ The default is no classification banner. .br Specifies whether users may override the classification (cover page) of individual print jobs using the "job-sheets" option. The default is "No". +.\"#ListenBackLog +.TP 5 +\fBListenBackLog \fInumber\fR +Specified the number of pending connections that will be allowed. +The scheduler now uses the value "128" on all platforms. .\"#PageLogFormat .TP 5 \fBPageLogFormat \fIformat-string\fR @@ -897,4 +895,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] 2007-2019 by Apple Inc. +Copyright \[co] 2007-2021 by Apple Inc.