From: mike
Date: Thu, 24 Jan 2002 18:51:13 +0000 (+0000)
Subject: Generate cupsd.conf so that the defaults reflect what has been
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e193bc2c16f672d88c6bebda5d356cce4e94ffbf;p=thirdparty%2Fcups.git
Generate cupsd.conf so that the defaults reflect what has been
configured...
Add missing structures to SPM.
Fix links in SAM and SPM.
Fix *BSD DSO build stuff.
git-svn-id: svn+ssh://src.apple.com/svn/cups/cups.org/trunk@2064 7a7537e8-13f0-0310-91df-b6672ffda945
---
diff --git a/Makefile b/Makefile
index dd3c466dc9..c561c4f95b 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,5 @@
#
-# "$Id: Makefile,v 1.40 2002/01/02 17:58:33 mike Exp $"
+# "$Id: Makefile,v 1.41 2002/01/24 18:51:04 mike Exp $"
#
# Top-level Makefile for the Common UNIX Printing System (CUPS).
#
@@ -36,6 +36,7 @@ DIRS = cups backend berkeley cgi-bin filter man pdftops pstoraster \
#
all:
+ chmod +x cups-config
for dir in $(DIRS); do\
echo Making all in $$dir... ;\
(cd $$dir ; $(MAKE) $(MFLAGS)) || exit 1;\
@@ -143,5 +144,5 @@ tardist:
epm $(EPMFLAGS) -f tardist cups
#
-# End of "$Id: Makefile,v 1.40 2002/01/02 17:58:33 mike Exp $".
+# End of "$Id: Makefile,v 1.41 2002/01/24 18:51:04 mike Exp $".
#
diff --git a/conf/cupsd.conf b/conf/cupsd.conf.in
similarity index 94%
rename from conf/cupsd.conf
rename to conf/cupsd.conf.in
index 21b3c02ae3..25a1f0a19f 100644
--- a/conf/cupsd.conf
+++ b/conf/cupsd.conf.in
@@ -1,5 +1,5 @@
#
-# "$Id: cupsd.conf,v 1.38 2002/01/23 17:25:33 mike Exp $"
+# "$Id: cupsd.conf.in,v 1.1 2002/01/24 18:51:04 mike Exp $"
#
# Sample configuration file for the Common UNIX Printing System (CUPS)
# scheduler.
@@ -63,13 +63,13 @@
#
# AccessLog: the access log file; if this does not start with a leading /
# then it is assumed to be relative to ServerRoot. By default set to
-# "/var/log/cups/access_log"
+# "@CUPS_LOGDIR@/access_log"
#
# You can also use the special name "syslog" to send the output to the
# syslog file or daemon.
#
-#AccessLog /var/log/cups/access_log
+#AccessLog @CUPS_LOGDIR@/access_log
#
# Classification: the classification level of the server. If set, this
@@ -118,28 +118,28 @@
#
# DocumentRoot: the root directory for HTTP documents that are served.
-# By default the compiled in directory.
+# By default @CUPS_DOCROOT@.
#
-#DocumentRoot /usr/share/doc/cups
+#DocumentRoot @CUPS_DOCROOT@
#
# ErrorLog: the error log file; if this does not start with a leading /
# then it is assumed to be relative to ServerRoot. By default set to
-# "/var/log/cups/error_log"
+# "@CUPS_LOGDIR@/error_log"
#
# You can also use the special name "syslog" to send the output to the
# syslog file or daemon.
#
-#ErrorLog /var/log/cups/error_log
+#ErrorLog @CUPS_LOGDIR@/error_log
#
# FontPath: the path to locate all font files (currently only for pstoraster)
-# By default /usr/share/cups/fonts.
+# By default @CUPS_FONTPATH@.
#
-#FontPath /usr/share/cups/fonts
+#FontPath @CUPS_FONTPATH@
#
# LogLevel: controls the number of messages logged to the ErrorLog
@@ -165,13 +165,13 @@ LogLevel info
#
# PageLog: the page log file; if this does not start with a leading /
# then it is assumed to be relative to ServerRoot. By default set to
-# "/var/log/cups/page_log"
+# "@CUPS_LOGDIR@/page_log"
#
# You can also use the special name "syslog" to send the output to the
# syslog file or daemon.
#
-#PageLog /var/log/cups/page_log
+#PageLog @CUPS_LOGDIR@/page_log
#
# PreserveJobHistory: whether or not to preserve the job history after a
@@ -230,10 +230,10 @@ LogLevel info
#
# RequestRoot: the directory where request files are stored.
-# By default /var/spool/cups.
+# By default @CUPS_REQUESTS@.
#
-#RequestRoot /var/spool/cups
+#RequestRoot @CUPS_REQUESTS@
#
# RemoteRoot: the name of the user assigned to unauthenticated accesses
@@ -244,17 +244,17 @@ LogLevel info
#
# ServerBin: the root directory for the scheduler executables.
-# By default /usr/lib/cups or /usr/lib32/cups (IRIX 6.5).
+# By default @CUPS_SERVERBIN@.
#
-#ServerBin /usr/lib/cups
+#ServerBin @CUPS_SERVERBIN@
#
# ServerRoot: the root directory for the scheduler.
-# By default /etc/cups.
+# By default @CUPS_SERVERROOT@.
#
-#ServerRoot /etc/cups
+#ServerRoot @CUPS_SERVERROOT@
########
@@ -263,17 +263,17 @@ LogLevel info
#
# ServerCertificate: the file to read containing the server's certificate.
-# Defaults to "/etc/cups/ssl/server.crt".
+# Defaults to "@CUPS_SERVERROOT@/ssl/server.crt".
#
-#ServerCertificate /etc/cups/ssl/server.crt
+#ServerCertificate @CUPS_SERVERROOT@/ssl/server.crt
#
# ServerKey: the file to read containing the server's key.
-# Defaults to "/etc/cups/ssl/server.key".
+# Defaults to "@CUPS_SERVERROOT@/ssl/server.key".
#
-#ServerKey /etc/cups/ssl/server.key
+#ServerKey @CUPS_SERVERROOT@/ssl/server.key
########
@@ -303,12 +303,12 @@ LogLevel info
#RIPCache 8m
#
-# TempDir: the directory to put temporary files in. This directory must be
-# writable by the user defined above! Defaults to "/var/spool/cups/tmp" or
+# TempDir: the directory to put temporary files in. This directory must be
+# writable by the user defined above! Defaults to "@CUPS_REQUESTS@/tmp" or
# the value of the TMPDIR environment variable.
#
-#TempDir /var/spool/cups/tmp
+#TempDir @CUPS_REQUESTS@/tmp
#
# FilterLimit: sets the maximum cost of all job filters that can be run
@@ -716,5 +716,5 @@ Allow From 127.0.0.1
#
-# End of "$Id: cupsd.conf,v 1.38 2002/01/23 17:25:33 mike Exp $".
+# End of "$Id: cupsd.conf.in,v 1.1 2002/01/24 18:51:04 mike Exp $".
#
diff --git a/config-scripts/cups-directories.m4 b/config-scripts/cups-directories.m4
index 2e7aeb66be..0273b52a97 100644
--- a/config-scripts/cups-directories.m4
+++ b/config-scripts/cups-directories.m4
@@ -1,5 +1,5 @@
dnl
-dnl "$Id: cups-directories.m4,v 1.6 2002/01/02 18:50:43 mike Exp $"
+dnl "$Id: cups-directories.m4,v 1.7 2002/01/24 18:51:05 mike Exp $"
dnl
dnl Directory stuff for the Common UNIX Printing System (CUPS).
dnl
@@ -155,14 +155,14 @@ AC_SUBST(INITDIR)
AC_SUBST(INITDDIR)
dnl Setup default locations...
-CUPS_SERVERROOT='${sysconfdir}/cups'
-CUPS_REQUESTS='${localstatedir}/spool/cups'
+CUPS_SERVERROOT="$sysconfdir/cups"
+CUPS_REQUESTS="$localstatedir/spool/cups"
AC_DEFINE_UNQUOTED(CUPS_SERVERROOT, "$sysconfdir/cups")
AC_DEFINE_UNQUOTED(CUPS_REQUESTS, "$localstatedir/spool/cups")
if test x$logdir = x; then
- CUPS_LOGDIR='${localstatedir}/log/cups'
+ CUPS_LOGDIR="$localstatedir/log/cups"
AC_DEFINE_UNQUOTED(CUPS_LOGDIR, "$localstatedir/log/cups")
else
CUPS_LOGDIR="$logdir"
@@ -174,13 +174,13 @@ case "$uname" in
*BSD* | Darwin*)
# *BSD and Darwin (MacOS X)
INSTALL_SYSV=""
- CUPS_SERVERBIN='${exec_prefix}/libexec/cups'
+ CUPS_SERVERBIN="$exec_prefix/libexec/cups"
AC_DEFINE_UNQUOTED(CUPS_SERVERBIN, "$exec_prefix/libexec/cups")
;;
*)
# All others
INSTALL_SYSV="install-sysv"
- CUPS_SERVERBIN='${exec_prefix}/lib/cups'
+ CUPS_SERVERBIN="$exec_prefix/lib/cups"
AC_DEFINE_UNQUOTED(CUPS_SERVERBIN, "$exec_prefix/lib/cups")
;;
esac
@@ -194,18 +194,18 @@ AC_SUBST(CUPS_REQUESTS)
dnl Set the CUPS_LOCALE directory...
case "$uname" in
Linux* | *BSD* | Darwin*)
- CUPS_LOCALEDIR='${datadir}/locale'
+ CUPS_LOCALEDIR="$datadir/locale"
AC_DEFINE_UNQUOTED(CUPS_LOCALEDIR, "$datadir/locale")
;;
OSF1* | AIX*)
- CUPS_LOCALEDIR='${exec_prefix}/lib/nls/msg'
+ CUPS_LOCALEDIR="$exec_prefix/lib/nls/msg"
AC_DEFINE_UNQUOTED(CUPS_LOCALEDIR, "$exec_prefix/lib/nls/msg")
;;
*)
# This is the standard System V location...
- CUPS_LOCALEDIR='${exec_prefix}/lib/locale'
+ CUPS_LOCALEDIR="$exec_prefix/lib/locale"
AC_DEFINE_UNQUOTED(CUPS_LOCALEDIR, "$exec_prefix/lib/locale")
;;
esac
@@ -213,13 +213,13 @@ esac
AC_SUBST(CUPS_LOCALEDIR)
dnl Set the CUPS_DATADIR directory...
-CUPS_DATADIR='${datadir}/cups'
+CUPS_DATADIR="$datadir/cups"
AC_DEFINE_UNQUOTED(CUPS_DATADIR, "$datadir/cups")
AC_SUBST(CUPS_DATADIR)
dnl Set the CUPS_DOCROOT directory...
if test x$docdir = x; then
- CUPS_DOCROOT='${datadir}/doc/cups'
+ CUPS_DOCROOT="$datadir/doc/cups"
docdir="$datadir/doc/cups"
else
CUPS_DOCROOT="$docdir"
@@ -229,8 +229,10 @@ AC_DEFINE_UNQUOTED(CUPS_DOCROOT, "$docdir")
AC_SUBST(CUPS_DOCROOT)
dnl Set the CUPS_FONTPATH directory...
+CUPS_FONTPATH="$fontpath"
+AC_SUBST(CUPS_FONTPATH)
AC_DEFINE_UNQUOTED(CUPS_FONTPATH, "$fontpath")
dnl
-dnl End of "$Id: cups-directories.m4,v 1.6 2002/01/02 18:50:43 mike Exp $".
+dnl End of "$Id: cups-directories.m4,v 1.7 2002/01/24 18:51:05 mike Exp $".
dnl
diff --git a/config-scripts/cups-sharedlibs.m4 b/config-scripts/cups-sharedlibs.m4
index 3447634140..37234640cb 100644
--- a/config-scripts/cups-sharedlibs.m4
+++ b/config-scripts/cups-sharedlibs.m4
@@ -1,5 +1,5 @@
dnl
-dnl "$Id: cups-sharedlibs.m4,v 1.9 2002/01/14 20:37:44 mike Exp $"
+dnl "$Id: cups-sharedlibs.m4,v 1.10 2002/01/24 18:51:05 mike Exp $"
dnl
dnl Shared library support for the Common UNIX Printing System (CUPS).
dnl
@@ -47,13 +47,13 @@ if test x$enable_shared != xno; then
DSO="\$(CC)"
DSOFLAGS="$DSOFLAGS -Wl,-rpath,\$(libdir),-set_version,sgi2.4,-soname,\$@ -shared \$(OPTIM)"
;;
- OSF1* | Linux*)
+ OSF1* | Linux* | NetBSD* | OpenBSD*)
LIBCUPS="libcups.so.2"
LIBCUPSIMAGE="libcupsimage.so.2"
DSO="\$(CC)"
DSOFLAGS="$DSOFLAGS -Wl,-soname,\$@ -shared \$(OPTIM)"
;;
- Darwin* | *BSD*)
+ Darwin* | FreeBSD*)
LIBCUPS="libcups.2.dylib"
LIBCUPSIMAGE="libcupsimage.2.dylib"
DSO="ld"
@@ -146,5 +146,5 @@ AC_SUBST(DSOLIBS)
AC_SUBST(IMGLIBS)
dnl
-dnl End of "$Id: cups-sharedlibs.m4,v 1.9 2002/01/14 20:37:44 mike Exp $".
+dnl End of "$Id: cups-sharedlibs.m4,v 1.10 2002/01/24 18:51:05 mike Exp $".
dnl
diff --git a/configure.in b/configure.in
index bf7f91c307..3097f0d084 100644
--- a/configure.in
+++ b/configure.in
@@ -1,5 +1,5 @@
dnl
-dnl "$Id: configure.in,v 1.104 2002/01/02 17:58:33 mike Exp $"
+dnl "$Id: configure.in,v 1.105 2002/01/24 18:51:04 mike Exp $"
dnl
dnl Configuration script for the Common UNIX Printing System (CUPS).
dnl
@@ -39,10 +39,10 @@ sinclude(config-scripts/cups-openslp.m4)
sinclude(config-scripts/cups-openssl.m4)
sinclude(config-scripts/cups-pam.m4)
-AC_OUTPUT(Makedefs cups.list cups.sh cups-config)
+AC_OUTPUT(Makedefs cups.list cups.sh cups-config conf/cupsd.conf)
chmod +x cups-config
dnl
-dnl End of "$Id: configure.in,v 1.104 2002/01/02 17:58:33 mike Exp $".
+dnl End of "$Id: configure.in,v 1.105 2002/01/24 18:51:04 mike Exp $".
dnl
diff --git a/doc/sam.html b/doc/sam.html
index b0175e1031..7ae9809be3 100644
--- a/doc/sam.html
+++ b/doc/sam.html
@@ -64,7 +64,7 @@ Copyright 1997-2002, All Rights Reserved
Installing an Debian Distribution
-3 - Printer Management
+3 - Managing Printers
- The Basics
- Adding Your First Printer
@@ -263,7 +263,7 @@ Copyright 1997-2002, All Rights Reserved
After a short delay the CUPS software will be installed and the
scheduler will be started automatically.
-
+
This chapter describes how to add your first printer and how to
manage your printers.
@@ -1001,7 +1000,7 @@ ServerName server
configuration information.
Polling is enabled by specifying one or more
BrowsePoll
directives in the /etc/cups/cupsd.conf
- file. For information on making these changes, see
+ file. For information on making these changes, see
Chapter 6, "Printing System Management".
@@ -4788,7 +4787,7 @@ AuthClass System
for the /admin location. Then restart the CUPS server as
- described in Chapter 8, "Printing System
+ described in Chapter 6, "Printing System
Management".
@@ -4799,8 +4798,8 @@ AuthClass System
-
+
The default CUPS configuration limits administration to the local
machine. To open up access, edit the /etc/cups/cupsd.conf
and comment out the lines reading:
@@ -4812,7 +4811,7 @@ Allow from 127.0.0.1
for the /admin location. Then restart the CUPS server as
- described in Chapter 8, "Printing System
+ described in Chapter 6, "Printing System
Management".
diff --git a/doc/sam.pdf b/doc/sam.pdf
index 7f7653deec..3d4bbda154 100644
Binary files a/doc/sam.pdf and b/doc/sam.pdf differ
diff --git a/doc/sam.shtml b/doc/sam.shtml
index 0ce82a8ea4..19af687d69 100644
--- a/doc/sam.shtml
+++ b/doc/sam.shtml
@@ -355,7 +355,7 @@ Once you are the root user, run dpkg with:
scheduler will be started automatically.
-
+
This chapter describes how to add your first printer and how to
manage your printers.
@@ -767,7 +767,7 @@ clients on the same subnet can share the same configuration information.
Polling is enabled by specifying one or more
BrowsePoll
directives in the
/etc/cups/cupsd.conf file. For information on making these
-changes, see Chapter 6, "Printing System
+changes, see Chapter 6, "Printing System
Management".
@@ -4490,7 +4490,7 @@ AuthClass System
for the /admin location. Then restart the CUPS server as
-described in Chapter 8, "Printing System
+described in Chapter 6, "Printing System
Management".
@@ -4505,7 +4505,7 @@ Management".
-I Can't Do Administration Tasks from Another Machine!
+
The default CUPS configuration limits administration to the local
machine. To open up access, edit the /etc/cups/cupsd.conf
@@ -4518,7 +4518,7 @@ Allow from 127.0.0.1
for the /admin location. Then restart the CUPS server as
-described in Chapter 8, "Printing System
+described in Chapter 6, "Printing System
Management".
diff --git a/doc/spm.html b/doc/spm.html
index 05a1286caf..df204cb1cd 100644
--- a/doc/spm.html
+++ b/doc/spm.html
@@ -192,12 +192,25 @@ Copyright 1997-2002, All Rights Reserved
C - Structures
-D - Functions
+D - Functions
- cupsAddOption()
@@ -1564,10 +1577,10 @@ if (jobid == 0)
Interfaces ("GUIs"), the CUPS API provides functions to set the default
username and to register a callback function that returns a password
string.
-The cupsSetPasswordCB()
+
The cupsSetPasswordCB()
function is used to set a password callback in your program. Only one
function can be used at any time.
-The cupsSetUser()
function
+
The cupsSetUser()
function
sets the current username for authentication. This function can be
called by your password callback function to change the current
username as needed.
@@ -3700,11 +3713,159 @@ cupsRasterOpen() function to specify a stream for reading or
This appendix describes all of the structures that are defined by the
CUPS API.
-
-
-The raster page header (
-cups_raster_header_t
) consists of the PostScript page device
- dictionary for the page:
+
+
+The CUPS destination structure (cups_dest_t
) contains
+ information on a specific destination or instance:
+
+
+Member | Type | Description |
+name | char * | The name of the printer or class. |
+
+instance | char * | The instance of the printer or
+ class; NULL for the primary instance. |
+is_default | int | 1 if the destination is set as
+ the default, 0 otherwise. |
+num_options | int | The number of options associated
+ with this destination. |
+options | cups_option_t * |
+The options associated with this destination. |
+
+
+
+
+The CUPS job structure (cups_job_t
) contains information
+ on a specific job:
+
+
+Member | Type | Description |
+id | int | The job ID for this job. |
+dest | char * | The destination for this job
+ (printer or class name). |
+title | char * | The job-name for this job (title). |
+
+user | char * | The job-originating-user-name for
+ this job (username). |
+format | char * | The document-format for this job
+ (MIME type string). |
+state | ipp_jstate | The current state of the job. |
+
+size | int | The size of this job in kilobytes. |
+priority | int | The priority of this job from 1 to
+ 100 (50 is normal). |
+completed_time | time_t | The time the job was
+ completed, or 0 if not yet completed. |
+creation_time | time_t | The time the job was
+ queued. |
+processing_time | time_t | The time the job started
+ printing. |
+
+
+
+
+The CUPS messages structure (cups_lang_t
) contains the
+ character set, locale name, and messages array:
+
+
+Member | Type | Description |
+next | cups_lang_t * | Pointer to the next messages
+ structure in memory. |
+used | int | The number of active users of this
+ messages structure. |
+encoding | cups_encoding_t | The character encoding
+ of the message strings. |
+language | char [16] | The language/locale name. |
+
+messages | char *[] | The array of message strings. |
+
+
+
+
+
+The CUPS option structure (cups_option_t
) contains the
+ option name and string value:
+
+
+Member | Type | Description |
+name | char * | The name of the option. |
+value | char * | The string value of the option. |
+
+
+
+
+
+
+The HTTP state structure (http_t
) contains the current
+ state of a HTTP request or response:
+
+
+Member | Type | Description |
+fd | int | The socket for the HTTP connection. |
+blocking | int | 1 if the HTTP functions should
+ block, 0 if not. |
+error | int | The last OS error that occurred on the
+ socket. |
+activity | time_t | The last time the HTTP
+ connection was used. |
+state | http_state_t | The current HTTP
+ request/response state. |
+status | int | The last HTTP status seen. |
+version | http_version_t | The HTTP protocol version
+ in use. |
+keep_alive | http_keep_alive_t | Whether or not to
+ use Keep-Alive |
+hostaddr | struct sockaddr_in | The IPv4 address of
+ the HTTP server. |
+hostname | char [] | The hostname of the HTTP
+ server. |
+fields | char [][] | The string values of all HTTP
+ request/response fields. |
+data | char * | Current byte in data buffer. |
+data_encoding | http_encoding_t | The transfer
+ encoding for the request/response. |
+data_remaining | int | The number of bytes remaining
+ in the current request, response, or chunk. |
+used | int | The number of bytes that are used in
+ the buffer. |
+buffer | char [] | The read/write buffer. |
+auth_type | int | The type of authentication in use. |
+
+md5_state | md5_state_t | The current MD5 digest
+ state. |
+nonce | char [] | The nonce value for Digest
+ authentication. |
+nonce_count | int | The nonce count value. |
+tls | void * | A pointer to private encryption data. |
+
+encryption | http_encryption_t | The current
+ encryption mode. |
+
+
+
+
+The IPP state structure (ipp_t
) contains the current
+ state of a IPP request or response:
+
+
+Member | Type | Description |
+ | | |
+
+
+
+
+The CUPS option structure (cups_option_t
) contains the
+ option name and string value:
+
+
+Member | Type | Description |
+ | | |
+
+
+
+
+
+The raster page header (cups_raster_header_t
) consists
+ of the PostScript page device dictionary for the page:
Member | Type | Description |
@@ -3788,7 +3949,7 @@ cups_raster_header_t) consists of the PostScript page device
-
+
This appendix provides a reference for all of the CUPS API functions.
diff --git a/doc/spm.pdf b/doc/spm.pdf
index 0deb26654a..a65aaee2eb 100644
Binary files a/doc/spm.pdf and b/doc/spm.pdf differ
diff --git a/doc/spm.shtml b/doc/spm.shtml
index dd0b372cfb..f3e7eee2a9 100644
--- a/doc/spm.shtml
+++ b/doc/spm.shtml
@@ -463,11 +463,11 @@ Graphical User Interfaces ("GUIs"), the CUPS API provides
functions to set the default username and to register a callback
function that returns a password string.
-The cupsSetPasswordCB()
+
The cupsSetPasswordCB()
function is used to set a password callback in your program. Only one
function can be used at any time.
-
The cupsSetUser()
function sets
+
The cupsSetUser()
function sets
the current username for authentication. This function can be called by
your password callback function to change the current username as needed.
@@ -2529,16 +2529,349 @@ value orderings:
-This appendix describes all of the structures that are defined by the CUPS
-API.
+
This appendix describes all of the structures that are
+defined by the CUPS API.
+
+
CUPS Structures
+
+
+
+The CUPS destination structure (cups_dest_t
)
+contains information on a specific destination or instance:
+
+
+
+ Member |
+ Type |
+ Description |
+
+
+ name |
+ char * |
+ The name of the printer or class. |
+
+
+ instance |
+ char * |
+ The instance of the printer or class; NULL for the primary
+ instance. |
+
+
+ is_default |
+ int |
+ 1 if the destination is set as the default, 0 otherwise. |
+
+
+ num_options |
+ int |
+ The number of options associated with this destination. |
+
+
+ options |
+ cups_option_t * |
+ The options associated with this destination. |
+
+
+
+
+
+The CUPS job structure (cups_job_t
) contains
+information on a specific job:
+
+
+
+ Member |
+ Type |
+ Description |
+
+
+ id |
+ int |
+ The job ID for this job. |
+
+
+ dest |
+ char * |
+ The destination for this job (printer or class name). |
+
+
+ title |
+ char * |
+ The job-name for this job (title). |
+
+
+ user |
+ char * |
+ The job-originating-user-name for this job (username). |
+
+
+ format |
+ char * |
+ The document-format for this job (MIME type string). |
+
+
+ state |
+ ipp_jstate |
+ The current state of the job. |
+
+
+ size |
+ int |
+ The size of this job in kilobytes. |
+
+
+ priority |
+ int |
+ The priority of this job from 1 to 100 (50 is normal). |
+
+
+ completed_time |
+ time_t |
+ The time the job was completed, or 0 if not yet completed. |
+
+
+ creation_time |
+ time_t |
+ The time the job was queued. |
+
+
+ processing_time |
+ time_t |
+ The time the job started printing. |
+
+
+
+
+
+The CUPS messages structure (cups_lang_t
)
+contains the character set, locale name, and messages array:
+
+
+
+ Member |
+ Type |
+ Description |
+
+
+ next |
+ cups_lang_t * |
+ Pointer to the next messages structure in memory. |
+
+
+ used |
+ int |
+ The number of active users of this messages structure. |
+
+
+ encoding |
+ cups_encoding_t |
+ The character encoding of the message strings. |
+
+
+ language |
+ char [16] |
+ The language/locale name. |
+
+
+ messages |
+ char *[] |
+ The array of message strings. |
+
+
+
+
+
+The CUPS option structure (cups_option_t
)
+contains the option name and string value:
+
+
+
+ Member |
+ Type |
+ Description |
+
+
+ name |
+ char * |
+ The name of the option. |
+
+
+ value |
+ char * |
+ The string value of the option. |
+
+
+
+Networking Structures
+
+
+
+The HTTP state structure (http_t
) contains the
+current state of a HTTP request or response:
+
+
+
+ Member |
+ Type |
+ Description |
+
+
+ fd |
+ int |
+ The socket for the HTTP connection. |
+
+
+ blocking |
+ int |
+ 1 if the HTTP functions should block, 0 if not. |
+
+
+ error |
+ int |
+ The last OS error that occurred on the socket. |
+
+
+ activity |
+ time_t |
+ The last time the HTTP connection was used. |
+
+
+ state |
+ http_state_t |
+ The current HTTP request/response state. |
+
+
+ status |
+ int |
+ The last HTTP status seen. |
+
+
+ version |
+ http_version_t |
+ The HTTP protocol version in use. |
+
+
+ keep_alive |
+ http_keep_alive_t |
+ Whether or not to use Keep-Alive |
+
+
+ hostaddr |
+ struct sockaddr_in |
+ The IPv4 address of the HTTP server. |
+
+
+ hostname |
+ char [] |
+ The hostname of the HTTP server. |
+
+
+ fields |
+ char [][] |
+ The string values of all HTTP request/response
+ fields. |
+
+
+ data |
+ char * |
+ Current byte in data buffer. |
+
+
+ data_encoding |
+ http_encoding_t |
+ The transfer encoding for the request/response. |
+
+
+ data_remaining |
+ int |
+ The number of bytes remaining in the current request,
+ response, or chunk. |
+
+
+ used |
+ int |
+ The number of bytes that are used in the buffer. |
+
+
+ buffer |
+ char [] |
+ The read/write buffer. |
+
+
+ auth_type |
+ int |
+ The type of authentication in use. |
+
+
+ md5_state |
+ md5_state_t |
+ The current MD5 digest state. |
+
+
+ nonce |
+ char [] |
+ The nonce value for Digest authentication. |
+
+
+ nonce_count |
+ int |
+ The nonce count value. |
+
+
+ tls |
+ void * |
+ A pointer to private encryption data. |
+
+
+ encryption |
+ http_encryption_t |
+ The current encryption mode. |
+
+
+
+
+
+The IPP state structure (ipp_t
) contains the
+current state of a IPP request or response:
+
+
+
+ Member |
+ Type |
+ Description |
+
+
+ |
+ |
+ |
+
+
+
+
+
+The CUPS option structure (cups_option_t
)
+contains the option name and string value:
+
+
+
+ Member |
+ Type |
+ Description |
+
+
+ |
+ |
+ |
+
+
+
Raster Structures
-Raster Page Header
+
-The raster page header (cups_raster_header_t
) consists
-of the PostScript page device dictionary for the page:
+
The raster page header (cups_raster_header_t
)
+consists of the PostScript page device dictionary for the page:
@@ -2748,7 +3081,7 @@ of the PostScript page device dictionary for the page:
-
+
This appendix provides a reference for all of the CUPS API functions.