From ffa2ca90d54cee938def492abe97894f784d8a78 Mon Sep 17 00:00:00 2001 From: msweet Date: Mon, 8 Jul 2013 21:15:13 +0000 Subject: [PATCH] Update documentation to not embed unstable configuration values, now that man pages are part of the repository... git-svn-id: svn+ssh://src.apple.com/svn/cups/cups.org/trunk@11109 a1ca3aef-8c08-0410-bb20-df032aa958be --- configure.in | 1 - doc/Makefile | 1 - doc/help/man-client.conf.html | 11 +- doc/help/man-cups-deviced.html | 4 +- doc/help/man-cups-driverd.html | 6 +- doc/help/man-cups-files.conf.html | 2 +- doc/help/man-cups-lpd.html | 4 +- doc/help/man-cups-snmp.html | 5 +- doc/help/man-cupsaddsmb.html | 35 +----- doc/help/man-cupsd.conf.html | 4 +- doc/help/man-cupsd.html | 2 +- doc/help/man-lpoptions.html | 4 +- doc/help/ref-cups-files-conf.html.in | 47 +++---- doc/help/ref-cupsd-conf.html.in | 25 ++-- doc/help/standard.html.in | 181 --------------------------- man/client.conf.man.in | 6 +- man/cups-deviced.man.in | 6 +- man/cups-driverd.man.in | 10 +- man/cups-files.conf.man.in | 4 +- man/cups-lpd.man.in | 6 +- man/cups-snmp.man.in | 9 +- man/cupsaddsmb.man.in | 44 +------ man/cupsd.conf.man.in | 6 +- man/cupsd.man.in | 4 +- man/lpoptions.man.in | 6 +- 25 files changed, 89 insertions(+), 344 deletions(-) delete mode 100644 doc/help/standard.html.in diff --git a/configure.in b/configure.in index fd0e079db..c9bde6700 100644 --- a/configure.in +++ b/configure.in @@ -70,7 +70,6 @@ AC_OUTPUT(Makedefs desktop/cups.desktop doc/help/ref-cups-files-conf.html doc/help/ref-cupsd-conf.html - doc/help/standard.html doc/index.html man/client.conf.man man/cups-deviced.man diff --git a/doc/Makefile b/doc/Makefile index b6af04c1f..620ad128c 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -125,7 +125,6 @@ HELPFILES = \ help/spec-ppd.html \ help/spec-raster.html \ help/spec-stp.html \ - help/standard.html \ help/translation.html \ help/whatsnew.html diff --git a/doc/help/man-client.conf.html b/doc/help/man-client.conf.html index dfcac80f6..a18e8dca2 100644 --- a/doc/help/man-client.conf.html +++ b/doc/help/man-client.conf.html @@ -11,7 +11,7 @@ client.conf - client configuration file for cups

Description

The client.conf file configures the CUPS client and is -normally located in the /private/etc/cups or ~/.cups +normally located in the /etc/cups or ~/.cups directory. Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character. @@ -36,7 +36,7 @@ location.
Specifies the Kerberos service name that is used for authentication, typically "host", "http", or "ipp". CUPS adds the remote hostname ("name@server.example.com") for you. The default name is -"host". +"http".
ServerName hostname-or-ip-address[:port]
@@ -47,6 +47,13 @@ location.
Specifies the address and optionally the port to use when connecting to the server. Note: Not supported on OS X 10.7 or later.
+
ServerName hostname-or-ip-address[:port]/version=1.1 +
+
+
Specifies the address and optionally the port to use when connecting to a +server running CUPS 1.3.12 and earlier. Note: Not supported on OS X 10.7 or +later. +
User name
diff --git a/doc/help/man-cups-deviced.html b/doc/help/man-cups-deviced.html index a64b7a707..df2525085 100644 --- a/doc/help/man-cups-deviced.html +++ b/doc/help/man-cups-deviced.html @@ -14,8 +14,8 @@ cups-deviced - cups device daemon request-id limit user-id options

Description

cups-deviced polls the backends in -/usr/libexec/cups/backend for a list of available devices. -It is run by cupsd(8) in response to a +/usr/lib/cups/backend or /usr/libexec/cups/backend (OS X) for a +list of available devices. It is run by cupsd(8) in response to a CUPS-Get-Devices request. The output format is an IPP response message. The request-id argument is the request ID from the original IPP request, typically 1. The limit diff --git a/doc/help/man-cups-driverd.html b/doc/help/man-cups-driverd.html index 1fe857272..0fc9183a6 100644 --- a/doc/help/man-cups-driverd.html +++ b/doc/help/man-cups-driverd.html @@ -36,9 +36,9 @@ accordingly.

Drivers

Drivers can be static PPD files under the /usr/share/cups/model directory or programs under the -/usr/libexec/cups/driver directory. Static PPD files must -conform to the Adobe PPD File Format Specification version 4.3 -and may be compressed using the gzip(1) program. Driver +/usr/lib/cups/driver or /usr/libexec/cups/driver (OS X) directories. +Static PPD files must conform to the Adobe PPD File Format Specification version +4.3 and may be compressed using the gzip(1) program. Driver programs must implement the command-line interface shown in the next section.

Driver Programs

diff --git a/doc/help/man-cups-files.conf.html b/doc/help/man-cups-files.conf.html index 2d686e9e2..8c3a610fd 100644 --- a/doc/help/man-cups-files.conf.html +++ b/doc/help/man-cups-files.conf.html @@ -12,7 +12,7 @@ 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). It is normally located in the -/private/etc/cups directory. +/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.

Directives

diff --git a/doc/help/man-cups-lpd.html b/doc/help/man-cups-lpd.html index 69f098db4..fc891605a 100644 --- a/doc/help/man-cups-lpd.html +++ b/doc/help/man-cups-lpd.html @@ -27,7 +27,7 @@ add the following line to the inetd.conf file to enable the
 
-    printer stream tcp nowait lp /usr/libexec/cups/daemon/cups-lpd cups-lpd \
+    printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd \
         -o document-format=application/octet-stream
 

Note: If you are using Solaris 10 or higher, you must run @@ -46,7 +46,7 @@ named /etc/xinetd.d/cups containing the following lines: user = lp group = sys passenv = - server = /usr/libexec/cups/daemon/cups-lpd + server = /usr/lib/cups/daemon/cups-lpd server_args = -o document-format=application/octet-stream } diff --git a/doc/help/man-cups-snmp.html b/doc/help/man-cups-snmp.html index c354a6206..d3d1a6a7a 100644 --- a/doc/help/man-cups-snmp.html +++ b/doc/help/man-cups-snmp.html @@ -10,6 +10,9 @@

Name

snmp - cups snmp backend

Synopsis

+/usr/lib/cups/backend/snmp +ip-address-or-hostname +
/usr/libexec/cups/backend/snmp ip-address-or-hostname
@@ -34,7 +37,7 @@ The CUPS SNMP backend uses the information from the Host, Printer, and Port Monitor MIBs along with some vendor private MIBs and intelligent port probes to determine the correct device URI and make and model for each printer.

Configuration

-The SNMP backend reads the /private/etc/cups/snmp.conf configuration file, if +The SNMP backend reads the /etc/cups/snmp.conf configuration file, if present, to set the default broadcast address, community name, and logging level. The configuration file is documented in cups-snmp.conf(5). The DebugLevel value can be overridden using the CUPS_DEBUG_LEVEL environment diff --git a/doc/help/man-cupsaddsmb.html b/doc/help/man-cupsaddsmb.html index 37349460e..0bb0ddcd9 100644 --- a/doc/help/man-cupsaddsmb.html +++ b/doc/help/man-cupsaddsmb.html @@ -114,10 +114,7 @@ Windows 2000 or higher in the drivers and %WINDIR%\SYSTEM32\SPOOL\DRIVERS\X64\3 folder for 64-bit drivers. -

The CUPS printer driver is preferred over the Microsoft driver -since it supports the page-label, job-billing, and -job-hold-until options fully on all printers. However, currently -only Windows 2000 and higher is supported by the Microsoft +

However, currently only Windows 2000 and higher is supported by the Microsoft driver, so you will also need to get the Adobe driver to support Windows 95, 98, and Me clients. The Adobe and Microsoft drivers for Windows 2000 are identical. @@ -137,36 +134,6 @@ as named below: you use the lowercase filenames shown above, otherwise cupsaddsmb will fail to export the drivers. -

Cups Postscript Drivers For Windows

-cupsaddsmb can use the CUPS v6 PostScript printer driver -for Windows, which is available for download from the CUPS web -site. -

The CUPS printer driver is preferred over the Adobe and -Microsoft drivers since it supports the page-label, job-billing, -and job-hold-until options fully on all printers. However, -currently only Windows 2000 and higher is supported by the CUPS -driver, so you will also need to get the Adobe driver to support -Windows 95, 98, and Me clients. -

Once you have extracted the driver files, copy the 32-bit drivers -to the /usr/share/cups/drivers directory and the 64-bit -drivers to the /usr/share/cups/drivers/x64 directory exactly -as named below: -

-
-    [Windows 2000 and higher]
-    cups6.inf (from www.cups.org)
-    cups6.ini (from www.cups.org)
-    cupsps6.dll (from www.cups.org)
-    cupsui6.dll (from www.cups.org)
-    ps5ui.dll (from your Windows system)
-    pscript.hlp (from your Windows system)
-    pscript.ntf (from your Windows system)
-    pscript5.dll (from your Windows system)
-
-

Note: Unlike Windows, case is significant - make sure that -you use the lowercase filenames shown above, otherwise -cupsaddsmb will fail to export the drivers. -

Adobe Postscript Drivers For Windows 95, 98, And Me

cupsaddsmb can use the Adobe PostScript printer driver for Windows 95, 98, and ME, which are available for download from the diff --git a/doc/help/man-cupsd.conf.html b/doc/help/man-cupsd.conf.html index 032b8db87..227ccfe2f 100644 --- a/doc/help/man-cupsd.conf.html +++ b/doc/help/man-cupsd.conf.html @@ -11,7 +11,7 @@ cupsd.conf - server configuration file for cups

Description

The cupsd.conf file configures the CUPS scheduler, cupsd(8). It -is normally located in the /private/etc/cups directory. Note: +is normally located in the /etc/cups directory. Note: 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) instead in order to prevent certain types of privilege escalation attacks. @@ -242,7 +242,7 @@ are run to print a job.
Specifies the service name when using Kerberos authentication. The default -service name is "host". +service name is "http".
HostNameLookups On
diff --git a/doc/help/man-cupsd.html b/doc/help/man-cupsd.html index 6df5475fc..b292cba20 100644 --- a/doc/help/man-cupsd.html +++ b/doc/help/man-cupsd.html @@ -18,7 +18,7 @@ cupsd - cups scheduler cupsd is the scheduler for CUPS. It implements a printing system based upon the Internet Printing Protocol, version 2.1. If no options are specified on the command-line then the default configuration file -/private/etc/cups/cupsd.conf will be used. +/etc/cups/cupsd.conf will be used.

Options

-c config-file diff --git a/doc/help/man-lpoptions.html b/doc/help/man-lpoptions.html index c342652cc..c5c2fa7ca 100644 --- a/doc/help/man-lpoptions.html +++ b/doc/help/man-lpoptions.html @@ -118,14 +118,14 @@ standard output.

Root Account Options

When run by the root user, lpoptions gets and sets default options and instances for all users in the -/private/etc/cups/lpoptions file. +/etc/cups/lpoptions file.

Compatibility

The lpoptions command is unique to CUPS.

Files

~/.cups/lpoptions - user defaults and instances created by non-root users.
-/private/etc/cups/lpoptions - system-wide defaults and instances +/etc/cups/lpoptions - system-wide defaults and instances created by the root user.

See Also

cancel(1), lp(1), lpadmin(8), lpr(1), diff --git a/doc/help/ref-cups-files-conf.html.in b/doc/help/ref-cups-files-conf.html.in index fa922cb23..171950c54 100644 --- a/doc/help/ref-cups-files-conf.html.in +++ b/doc/help/ref-cups-files-conf.html.in @@ -37,7 +37,7 @@ server activity.

information to the system log instead of a plain file.

The default access log file is -@CUPS_LOGDIR@/access_log.

+/var/log/access_log.

CUPS 1.1.15ConfigFilePerm

@@ -51,7 +51,7 @@ ConfigFilePerm 0640

Description

-

The ConfigFilePerm directive specifies the permissions to use when the scheduler writes configuration and cache files, typically in response to IPP or HTTP requests. The default is @CUPS_CONFIG_FILE_PERM@.

+

The ConfigFilePerm directive specifies the permissions to use when the scheduler writes configuration and cache files, typically in response to IPP or HTTP requests. The default is 644 on OS X and 640 on all other operating systems.

Note: @@ -89,13 +89,13 @@ DocumentRoot /foo/bar/doc/cups of web content for the HTTP server in CUPS. If an absolute path is not specified then it is assumed to be relative to the ServerRoot directory. The -default directory is @CUPS_DOCROOT@.

+default directory is /usr/share/doc/cups.

Documents are first looked up in a sub-directory for the primary language requested by the client (e.g. -@CUPS_DOCROOT@/fr/...) and then directly under +/usr/share/doc/cups/fr/...) and then directly under the DocumentRoot directory (e.g. -@CUPS_DOCROOT@/...), so it is possible to +/usr/share/doc/cups/...), so it is possible to localize the web content by providing subdirectories for each language needed.

@@ -116,7 +116,7 @@ ErrorLog syslog log file. If the filename is not absolute then it is assumed to be relative to the ServerRoot directory. The -default error log file is @CUPS_LOGDIR@/error_log.

+default error log file is /var/log/cups/error_log.

The server name can be included in the filename by using %s in the name.

@@ -172,7 +172,7 @@ errors are fatal. The following kinds of errors are currently recognized:

Multiple errors can be listed, and the form "-kind" can be used with all to remove specific kinds of errors. The default setting is -@CUPS_FATAL_ERRORS@.

+config.

CUPS 1.1.18FileDevice

@@ -255,7 +255,7 @@ LogFilePerm 0600

The LogFilePerm directive specifies the permissions to use when writing log files. The default -is @CUPS_LOG_FILE_PERM@.

+is 644.

PageLog

@@ -274,7 +274,7 @@ PageLog syslog log file. If the filename is not absolute then it is assumed to be relative to the ServerRoot directory. The -default page log file is @CUPS_LOGDIR@/page_log.

+default page log file is /var/log/cups/page_log.

The server name can be included in the filename by using %s in the name.

@@ -296,17 +296,9 @@ Printcap /Library/Preferences/org.cups.printers.plist

Description

-

The Printcap directive controls whether or not a -printcap file is automatically generated and updated with a list -of available printers. If specified with no value, then no -printcap file will be generated. The default is to generate a -file named @CUPS_DEFAULT_PRINTCAP@.

+

The Printcap directive controls whether or not a printcap file is automatically generated and updated with a list of available printers. If specified with no value, then no printcap file will be generated. The default is to generate a file named /Library/Preferences.org.cups.printers.plist on OS X and /etc/printcap on all other operating systems.

-

When a filename is specified (e.g. @CUPS_DEFAULT_PRINTCAP@), -the printcap file is written whenever a printer is added or -removed. The printcap file can then be used by applications that -are hardcoded to look at the printcap file for the available -printers.

+

When a filename is specified (e.g. /etc/printcap), the printcap file is written whenever a printer is added or removed. The printcap file can then be used by applications that are hardcoded to look at the printcap file for the available printers.

PrintcapFormat

@@ -359,7 +351,7 @@ RequestRoot /foo/bar/spool/cups incoming IPP requests and HTML forms. If an absolute path is not provided then it is assumed to be relative to the ServerRoot directory. The -default request directory is @CUPS_REQUESTS@.

+default request directory is /var/spool/cups.

ServerBin

@@ -451,10 +443,7 @@ SystemGroup root lpadmin

Description

-

The SystemGroup directive specifies the system -administration group for System authentication. -Multiple groups can be listed, separated with spaces. The default -group list is @CUPS_SYSTEM_GROUPS@.

+

The SystemGroup directive specifies the system administration group for System authentication. Multiple groups can be listed, separated with spaces. The default group list is admin on OS X and lpadmin, root, sys, and/or system on other operating systems.

TempDir

@@ -470,7 +459,7 @@ TempDir /foo/bar/tmp

The TempDir directive specifies an absolute path for the directory to use for temporary files. The default -directory is @CUPS_REQUESTS@/tmp.

+directory is /var/spool/cups/tmp.

Temporary directories must be world-writable and should have the "sticky" permission bit enabled so that other users cannot @@ -483,6 +472,10 @@ an appropriate temporary directory called chmod a+rwxt /foo/bar/tmp +

Note: + +

The TempDir cannot be pointed at a standard system temporary directory such as /tmp or /var/tmp for security reasons.

+

User

@@ -495,9 +488,7 @@ User guest

Description

-

The User directive specifies the UNIX user that -filter and CGI programs run as. The default user is -@CUPS_USER@.

+

The User directive specifies the UNIX user that filter and CGI programs run as. The default user is _lp, lp, or nobody (whichever is found first).

Note: diff --git a/doc/help/ref-cupsd-conf.html.in b/doc/help/ref-cupsd-conf.html.in index 43ca20b64..dc9ee70cb 100644 --- a/doc/help/ref-cupsd-conf.html.in +++ b/doc/help/ref-cupsd-conf.html.in @@ -247,10 +247,7 @@ BrowseLocalProtocols dnssd

Description

-

The BrowseLocalProtocols directive specifies the -protocols to use when advertising local shared printers on the -network. Multiple protocols can be specified by separating them -with spaces. The default is "@CUPS_BROWSE_LOCAL_PROTOCOLS@".

+

The BrowseLocalProtocols directive specifies the protocols to use when advertising local shared printers on the network. Multiple protocols can be specified by separating them with spaces. The default is "dnssd" on systems that support Bonjour and "none" on all others.

BrowseWebIF

@@ -280,9 +277,7 @@ Browsing Off

Description

-

The Browsing directive controls whether or not -printer sharing is enabled. The default setting is -@CUPS_BROWSING@.

+

The Browsing directive controls whether or not printer sharing is enabled. The default setting is On.

CUPS 1.1.7Classification

@@ -430,15 +425,13 @@ and other job operations.

Examples

-DefaultShared yes
-DefaultShared no
+DefaultShared Yes
+DefaultShared No
 

Description

-

The DefaultShared directive specifies whether -printers are shared (published) by default. The default is -@CUPS_DEFAULT_SHARED@.

+

The DefaultShared directive specifies whether printers are shared (published) by default. The default is Yes.

Deny

@@ -628,7 +621,7 @@ GSSServiceName ipp

Description

-

The GSSServiceName directive sets the Kerberos service name to use. The default is @CUPS_DEFAULT_GSSSERVICE_NAME@ for compatibility with Microsoft Windows.

+

The GSSServiceName directive sets the Kerberos service name to use. The default is http for compatibility with Microsoft Windows.

HostNameLookups

@@ -2150,13 +2143,13 @@ to wait before an active HTTP or IPP request times out in seconds (no suffix), m

Examples

-WebInterface yes
-WebInterface no
+WebInterface Yes
+WebInterface No
 

Description

-

The WebInterface directive specifies whether the web interface is enabled. The default value is @CUPS_WEBIF@.

+

The WebInterface directive specifies whether the web interface is enabled. The default value is No on OS X and Yes on all other operating systems.

diff --git a/doc/help/standard.html.in b/doc/help/standard.html.in deleted file mode 100644 index f957fe249..000000000 --- a/doc/help/standard.html.in +++ /dev/null @@ -1,181 +0,0 @@ - - - - Standard Configuration - - - - -

Standard Configuration

- -

This document describes the standard configuration for this CUPS -server.

- -
Note: - - -

This file reflects the standard CUPS configuration as distributed -by Apple Inc, the developer of CUPS.

- -
- - -

cupsd Configuration

- -

cupsd(8) is configured by default to show -printers shared by other systems and only allow local access to -the system and its printers. Administration operations require -Basic authentication with membership in the group -"@CUPS_GROUP@".

- -

Connections are accepted via domain socket -(@CUPS_DEFAULT_DOMAINSOCKET@) or "localhost" -(127.0.0.1).

- -

Settings

- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Table 1: Default Values
DirectiveValue
Browsing@CUPS_BROWSING@
BrowseLocalProtocols@CUPS_BROWSE_LOCAL_PROTOCOLS@
BrowseRemoteProtocols@CUPS_BROWSE_REMOTE_PROTOCOLS@
BrowseShortNames@CUPS_BROWSE_SHORT_NAMES@
ConfigFilePerm@CUPS_CONFIG_FILE_PERM@
DefaultShared@CUPS_DEFAULT_SHARED@
ImplicitClasses@CUPS_IMPLICIT_CLASSES@
LogFilePerm@CUPS_LOG_FILE_PERM@
MaxCopies@CUPS_MAX_COPIES@
UseNetworkDefault@CUPS_USE_NETWORK_DEFAULT@
- - -

Directories

- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Table 2: Directories
DirectoryPurpose
@CUPS_SERVERROOT@The location of configuration files such as - printers.conf. Overridden by the ServerRoot - directive in cupsd.conf.
@bindir@The location of user programs.
@includedir@The location of CUPS include files.
@libdir@The location of CUPS library files.
@CUPS_SERVERBIN@The location of server programs such as backends and - filters. Overridden by the ServerBin - directive in cupsd.conf.
@sbindir@The location of administrator programs.
@CUPS_DATADIR@The location of data files such as fonts. Overridden - by the DataDir - directive in cupsd.conf.
@CUPS_DOCROOT@The location of documentation files. Overridden by - the DocumentRoot - directive in cupsd.conf.
@CUPS_LOCALEDIR@The location of localization files.
@CUPS_CACHEDIR@The location of cache files such as - ppds.dat and remote.cache. - Overridden by the CacheDir - directive in cupsd.conf.
@CUPS_LOGDIR@The location of the access_log, - error_log, and page_log files. - Overridden by the AccessLog, - ErrorLog, - PageLog, - directive in cupsd.conf.
@CUPS_STATEDIR@The location of the domain socket file and state data - such as authentication certificates. Overridden by the StateDir - directive in cupsd.conf.
@CUPS_REQUESTS@The location of spooled print jobs. Overridden by the - RequestRoot - directive in cupsd.conf.
- - - diff --git a/man/client.conf.man.in b/man/client.conf.man.in index 06a307d44..a078ac9df 100644 --- a/man/client.conf.man.in +++ b/man/client.conf.man.in @@ -12,12 +12,12 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH client.conf 5 "CUPS" "25 June 2013" "Apple Inc." +.TH client.conf 5 "CUPS" "8 July 2013" "Apple Inc." .SH NAME client.conf \- client configuration file for cups .SH DESCRIPTION The \fIclient.conf\fR file configures the CUPS client and is -normally located in the \fI@CUPS_SERVERROOT@\fR or \fI~/.cups\fR +normally located in the \fI/etc/cups\fR or \fI~/.cups\fR directory. Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character. @@ -38,7 +38,7 @@ GSSServiceName name Specifies the Kerberos service name that is used for authentication, typically "host", "http", or "ipp". CUPS adds the remote hostname ("name@server.example.com") for you. The default name is -"@CUPS_DEFAULT_GSSSERVICENAME@". +"http". .TP 5 ServerName hostname-or-ip-address[:port] .TP 5 diff --git a/man/cups-deviced.man.in b/man/cups-deviced.man.in index 62b248231..4aa8f432a 100644 --- a/man/cups-deviced.man.in +++ b/man/cups-deviced.man.in @@ -12,7 +12,7 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH cups-deviced 8 "CUPS" "16 June 2008" "Apple Inc." +.TH cups-deviced 8 "CUPS" "8 July 2013" "Apple Inc." .SH NAME cups-deviced \- cups device daemon .SH SYNOPSIS @@ -20,8 +20,8 @@ cups-deviced \- cups device daemon .I request-id limit user-id options .SH DESCRIPTION \fIcups-deviced\fR polls the backends in -\fI@CUPS_SERVERBIN@/backend\fR for a list of available devices. -It is run by \fIcupsd(8)\fR in response to a +\fI/usr/lib/cups/backend\fR or \fI/usr/libexec/cups/backend\fR (OS X) for a +list of available devices. It is run by \fIcupsd(8)\fR in response to a \fICUPS-Get-Devices\fR request. The output format is an IPP response message. The \fIrequest-id\fR argument is the request ID from the original IPP request, typically 1. The \fIlimit\fR diff --git a/man/cups-driverd.man.in b/man/cups-driverd.man.in index 802a58ce9..3cb3fef00 100644 --- a/man/cups-driverd.man.in +++ b/man/cups-driverd.man.in @@ -12,7 +12,7 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH cups-driverd 8 "CUPS" "6 January 2011" "Apple Inc." +.TH cups-driverd 8 "CUPS" "8 July 2013" "Apple Inc." .SH NAME cups-driverd \- cups driver daemon .SH SYNOPSIS @@ -42,10 +42,10 @@ is a space-delimited list of attributes ("name=value name=value accordingly. .SH DRIVERS Drivers can be static PPD files under the -\fI@CUPS_DATADIR@/model\fR directory or programs under the -\fI@CUPS_SERVERBIN@/driver\fR directory. Static PPD files must -conform to the Adobe PPD File Format Specification version 4.3 -and may be compressed using the \fIgzip(1)\fR program. Driver +\fI/usr/share/cups/model\fR directory or programs under the +\fI/usr/lib/cups/driver\fR or \fI/usr/libexec/cups/driver\fR (OS X) directories. +Static PPD files must conform to the Adobe PPD File Format Specification version +4.3 and may be compressed using the \fIgzip(1)\fR program. Driver programs must implement the command-line interface shown in the next section. .SS DRIVER PROGRAMS diff --git a/man/cups-files.conf.man.in b/man/cups-files.conf.man.in index 7682533c2..294dc0b33 100644 --- a/man/cups-files.conf.man.in +++ b/man/cups-files.conf.man.in @@ -12,13 +12,13 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH cups-files.conf 5 "CUPS" "19 November 2012" "Apple Inc." +.TH cups-files.conf 5 "CUPS" "8 July 2013" "Apple Inc." .SH NAME cups-files.conf \- file and directory configuration file for cups .SH DESCRIPTION The \fIcups-files.conf\fR file configures the files and directories used by the CUPS scheduler, \fIcupsd(8)\fR. It is normally located in the -\fI@CUPS_SERVERROOT@\fR directory. +\fI/etc/cups\fR directory. .LP Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character. diff --git a/man/cups-lpd.man.in b/man/cups-lpd.man.in index b7e45ec20..e49c2ba54 100644 --- a/man/cups-lpd.man.in +++ b/man/cups-lpd.man.in @@ -12,7 +12,7 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH cups-lpd 8 "CUPS" "4 August 2008" "Apple Inc." +.TH cups-lpd 8 "CUPS" "8 July 2013" "Apple Inc." .SH NAME cups-lpd \- receive print jobs and report printer status to lpd clients .SH SYNOPSIS @@ -33,7 +33,7 @@ add the following line to the \fIinetd.conf\fR file to enable the .br .nf - printer stream tcp nowait lp @CUPS_SERVERBIN@/daemon/cups-lpd cups-lpd \\ + printer stream tcp nowait lp /usr/lib/cups/daemon/cups-lpd cups-lpd \\ -o document-format=application/octet-stream .fi .LP @@ -55,7 +55,7 @@ named \fI/etc/xinetd.d/cups\fR containing the following lines: user = lp group = sys passenv = - server = @CUPS_SERVERBIN@/daemon/cups-lpd + server = /usr/lib/cups/daemon/cups-lpd server_args = -o document-format=application/octet-stream } .fi diff --git a/man/cups-snmp.man.in b/man/cups-snmp.man.in index e6f6c7448..ae07f248d 100644 --- a/man/cups-snmp.man.in +++ b/man/cups-snmp.man.in @@ -11,11 +11,14 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH cups-snmp 8 "CUPS" "23 April 2012" "Apple Inc." +.TH cups-snmp 8 "CUPS" "8 July 2013" "Apple Inc." .SH NAME snmp \- cups snmp backend .SH SYNOPSIS -.B @CUPS_SERVERBIN@/backend/snmp +.B /usr/lib/cups/backend/snmp +.I ip-address-or-hostname +.br +.B /usr/libexec/cups/backend/snmp .I ip-address-or-hostname .br .B lpinfo -v --include-schemes snmp @@ -41,7 +44,7 @@ The CUPS SNMP backend uses the information from the Host, Printer, and Port Monitor MIBs along with some vendor private MIBs and intelligent port probes to determine the correct device URI and make and model for each printer. .SH CONFIGURATION -The SNMP backend reads the @CUPS_SERVERROOT@/snmp.conf configuration file, if +The SNMP backend reads the /etc/cups/snmp.conf configuration file, if present, to set the default broadcast address, community name, and logging level. The configuration file is documented in \fIcups-snmp.conf(5)\fR. The DebugLevel value can be overridden using the CUPS_DEBUG_LEVEL environment diff --git a/man/cupsaddsmb.man.in b/man/cupsaddsmb.man.in index 447dfa467..ee0d0adb3 100644 --- a/man/cupsaddsmb.man.in +++ b/man/cupsaddsmb.man.in @@ -12,7 +12,7 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH cupsaddsmb 8 "CUPS" "25 July 2007" "Apple Inc." +.TH cupsaddsmb 8 "CUPS" "8 July 2013" "Apple Inc." .SH NAME cupsaddsmb \- export printers to samba for windows clients @@ -115,17 +115,14 @@ drivers and %WINDIR%\\SYSTEM32\\SPOOL\\DRIVERS\\X64\\3 folder for 64-bit drivers. .LP -The CUPS printer driver is preferred over the Microsoft driver -since it supports the page-label, job-billing, and -job-hold-until options fully on all printers. However, currently -only Windows 2000 and higher is supported by the Microsoft +However, currently only Windows 2000 and higher is supported by the Microsoft driver, so you will also need to get the Adobe driver to support Windows 95, 98, and Me clients. The Adobe and Microsoft drivers for Windows 2000 are identical. .LP Once you have extracted the driver files, copy the 32-bit drivers -to the \fI@CUPS_DATADIR@/drivers\fR directory and the 64-bit -drivers to the \fI@CUPS_DATADIR@/drivers/x64\fR directory exactly +to the \fI/usr/share/cups/drivers\fR directory and the 64-bit +drivers to the \fI/usr/share/cups/drivers/x64\fR directory exactly as named below: .nf @@ -140,39 +137,6 @@ as named below: you use the lowercase filenames shown above, otherwise \fIcupsaddsmb\fR will fail to export the drivers. -.SH CUPS POSTSCRIPT DRIVERS FOR WINDOWS -\fIcupsaddsmb\fR can use the CUPS v6 PostScript printer driver -for Windows, which is available for download from the CUPS web -site. -.LP -The CUPS printer driver is preferred over the Adobe and -Microsoft drivers since it supports the page-label, job-billing, -and job-hold-until options fully on all printers. However, -currently only Windows 2000 and higher is supported by the CUPS -driver, so you will also need to get the Adobe driver to support -Windows 95, 98, and Me clients. -.LP -Once you have extracted the driver files, copy the 32-bit drivers -to the \fI@CUPS_DATADIR@/drivers\fR directory and the 64-bit -drivers to the \fI@CUPS_DATADIR@/drivers/x64\fR directory exactly -as named below: -.nf - - [Windows 2000 and higher] - cups6.inf (from www.cups.org) - cups6.ini (from www.cups.org) - cupsps6.dll (from www.cups.org) - cupsui6.dll (from www.cups.org) - ps5ui.dll (from your Windows system) - pscript.hlp (from your Windows system) - pscript.ntf (from your Windows system) - pscript5.dll (from your Windows system) -.fi -.LP -\fBNote:\fR Unlike Windows, case is significant - make sure that -you use the lowercase filenames shown above, otherwise -\fIcupsaddsmb\fR will fail to export the drivers. - .SH ADOBE POSTSCRIPT DRIVERS FOR WINDOWS 95, 98, AND ME \fIcupsaddsmb\fR can use the Adobe PostScript printer driver for Windows 95, 98, and ME, which are available for download from the diff --git a/man/cupsd.conf.man.in b/man/cupsd.conf.man.in index e98148d6c..60c61f7da 100644 --- a/man/cupsd.conf.man.in +++ b/man/cupsd.conf.man.in @@ -12,12 +12,12 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH cupsd.conf 5 "CUPS" "19 November 2012" "Apple Inc." +.TH cupsd.conf 5 "CUPS" "8 July 2013" "Apple Inc." .SH NAME cupsd.conf \- server configuration file for cups .SH DESCRIPTION The \fIcupsd.conf\fR file configures the CUPS scheduler, \fIcupsd(8)\fR. It -is normally located in the \fI@CUPS_SERVERROOT@\fR directory. \fBNote:\fR +is normally located in the \fI/etc/cups\fR directory. \fBNote:\fR File, directory, and user configuration directives that used to be allowed in the \fIcupsd.conf\fR file are now stored in the \fIcups-files.conf(5)\fR instead in order to prevent certain types of privilege escalation attacks. @@ -192,7 +192,7 @@ are run to print a job. GSSServiceName name .br Specifies the service name when using Kerberos authentication. The default -service name is "@CUPS_DEFAULT_GSSSERVICENAME@". +service name is "http". .TP 5 HostNameLookups On .TP 5 diff --git a/man/cupsd.man.in b/man/cupsd.man.in index 66e39fcd2..9fdcc2227 100644 --- a/man/cupsd.man.in +++ b/man/cupsd.man.in @@ -12,7 +12,7 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH cupsd 8 "CUPS" "9 March 2009" "Apple Inc." +.TH cupsd 8 "CUPS" "8 July 2013" "Apple Inc." .SH NAME cupsd \- cups scheduler .SH SYNOPSIS @@ -24,7 +24,7 @@ cupsd \- cups scheduler \fIcupsd\fR is the scheduler for CUPS. It implements a printing system based upon the Internet Printing Protocol, version 2.1. If no options are specified on the command-line then the default configuration file -\fI@CUPS_SERVERROOT@/cupsd.conf\fR will be used. +\fI/etc/cups/cupsd.conf\fR will be used. .SH OPTIONS .TP 5 -c config-file diff --git a/man/lpoptions.man.in b/man/lpoptions.man.in index 860d8bf0a..e04365b45 100644 --- a/man/lpoptions.man.in +++ b/man/lpoptions.man.in @@ -12,7 +12,7 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH lpoptions 1 "CUPS" "29 August 2008" "Apple Inc." +.TH lpoptions 1 "CUPS" "8 July 2013" "Apple Inc." .SH NAME lpoptions \- display or set printer options and defaults .SH SYNOPSIS @@ -115,14 +115,14 @@ Options set with the \fIlpoptions\fR command are used by the .SH ROOT ACCOUNT OPTIONS When run by the root user, \fIlpoptions\fR gets and sets default options and instances for \fIall users\fR in the -@CUPS_SERVERROOT@/lpoptions file. +/etc/cups/lpoptions file. .SH COMPATIBILITY The \fIlpoptions\fR command is unique to CUPS. .SH FILES ~/.cups/lpoptions - user defaults and instances created by non-root users. .br -@CUPS_SERVERROOT@/lpoptions - system-wide defaults and instances +/etc/cups/lpoptions - system-wide defaults and instances created by the root user. .SH SEE ALSO \fIcancel(1)\fR, \fIlp(1)\fR, \fIlpadmin(8)\fR, \fIlpr(1)\fR, -- 2.39.2