]> git.ipfire.org Git - thirdparty/cups.git/blobdiff - scheduler/conf.h
Update svn:keyword properties.
[thirdparty/cups.git] / scheduler / conf.h
index 4f1ab36e85cf585150c6df3242fa916abdfaef92..e095ecfaaaa4c1a6c418d7c5e8eeb3c8442d389d 100644 (file)
@@ -1,10 +1,9 @@
 /*
- * "$Id: conf.h 6649 2007-07-11 21:46:42Z mike $"
+ * "$Id$"
  *
- *   Configuration file definitions for the Common UNIX Printing System (CUPS)
- *   scheduler.
+ *   Configuration file definitions for the CUPS scheduler.
  *
- *   Copyright 2007 by Apple Inc.
+ *   Copyright 2007-2012 by Apple Inc.
  *   Copyright 1997-2007 by Easy Software Products, all rights reserved.
  *
  *   These coded instructions, statements, and computer programs are the
 
 typedef enum
 {
-  CUPSD_LOG_ATTR = -3,                 /* Used internally for attributes */
-  CUPSD_LOG_STATE,                     /* Used internally for state-reasons */
+  CUPSD_LOG_PPD = -5,                  /* Used internally for PPD keywords */
+  CUPSD_LOG_ATTR,                      /* Used internally for attributes */
+  CUPSD_LOG_STATE,                     /* Used internally for printer-state-reasons */
+  CUPSD_LOG_JOBSTATE,                  /* Used internally for job-state-reasons */
   CUPSD_LOG_PAGE,                      /* Used internally for page logging */
   CUPSD_LOG_NONE,
   CUPSD_LOG_EMERG,                     /* Emergency issues */
@@ -36,6 +37,32 @@ typedef enum
   CUPSD_LOG_DEBUG2                     /* Detailed debugging */
 } cupsd_loglevel_t;
 
+typedef enum
+{
+  CUPSD_ACCESSLOG_CONFIG,              /* Log config requests */
+  CUPSD_ACCESSLOG_ACTIONS,             /* Log config, print, and job management requests */
+  CUPSD_ACCESSLOG_ALL                  /* Log everything */
+} cupsd_accesslog_t;
+
+typedef enum
+{
+  CUPSD_TIME_STANDARD,                 /* "Standard" Apache/CLF format */
+  CUPSD_TIME_USECS                     /* Standard format with microseconds */
+} cupsd_time_t;
+
+
+/*
+ * FatalErrors flags...
+ */
+
+#define CUPSD_FATAL_NONE       0       /* No errors are fatal */
+#define CUPSD_FATAL_BROWSE     1       /* Browse bind errors are fatal */
+#define CUPSD_FATAL_CONFIG     2       /* Config file syntax errors are fatal */
+#define CUPSD_FATAL_LISTEN     4       /* Listen/Port bind errors are fatal */
+#define CUPSD_FATAL_LOG                8       /* Log file errors are fatal */
+#define CUPSD_FATAL_PERMISSIONS        16      /* File permission errors are fatal */
+#define CUPSD_FATAL_ALL                ~0      /* All errors are fatal */
+
 
 /*
  * Printcap formats...
@@ -43,6 +70,26 @@ typedef enum
 
 #define PRINTCAP_BSD           0       /* Berkeley LPD format */
 #define PRINTCAP_SOLARIS       1       /* Solaris lpsched format */
+#define PRINTCAP_PLIST         2       /* OS X plist format */
+
+
+/*
+ * SSL options (bits)...
+ */
+
+#define CUPSD_SSL_NONE         0       /* No special options */
+#define CUPSD_SSL_NOEMPTY      1       /* Do not insert empty fragments */
+
+
+/*
+ * ServerAlias data...
+ */
+
+typedef struct
+{
+  size_t       namelen;                /* Length of alias name */
+  char         name[1];                /* Alias name */
+} cupsd_alias_t;
 
 
 /*
@@ -50,7 +97,9 @@ typedef enum
  */
 
 VAR char               *ConfigurationFile      VALUE(NULL),
-                                       /* Configuration file to use */
+                                       /* cupsd.conf file to use */
+                       *CupsFilesFile          VALUE(NULL),
+                                       /* cups-files.conf file to use */
                        *ServerName             VALUE(NULL),
                                        /* FQDN for server */
                        *ServerAdmin            VALUE(NULL),
@@ -65,12 +114,17 @@ VAR char           *ConfigurationFile      VALUE(NULL),
                                        /* Directory for request files */
                        *DocumentRoot           VALUE(NULL);
                                        /* Root directory for documents */
+VAR cups_array_t       *ServerAlias            VALUE(NULL);
+                                       /* Alias names for server */
 VAR int                        ServerNameIsIP          VALUE(0);
+                                       /* Is the ServerName an IP address? */
 VAR int                        NumSystemGroups         VALUE(0);
                                        /* Number of system group names */
-VAR char               *SystemGroups[MAX_SYSTEM_GROUPS];
+VAR char               *SystemGroups[MAX_SYSTEM_GROUPS]
+                                               VALUE({0});
                                        /* System group names */
-VAR gid_t              SystemGroupIDs[MAX_SYSTEM_GROUPS];
+VAR gid_t              SystemGroupIDs[MAX_SYSTEM_GROUPS]
+                                               VALUE({0});
                                        /* System group IDs */
 VAR char               *AccessLog              VALUE(NULL),
                                        /* Access log filename */
@@ -84,10 +138,10 @@ VAR char           *AccessLog              VALUE(NULL),
                                        /* Data file directory */
                        *DefaultLanguage        VALUE(NULL),
                                        /* Default language encoding */
-                       *DefaultCharset         VALUE(NULL),
-                                       /* Default charset */
                        *DefaultLocale          VALUE(NULL),
                                        /* Default locale */
+                       *DefaultPaperSize       VALUE(NULL),
+                                       /* Default paper size */
                        *ErrorPolicy            VALUE(NULL),
                                        /* Default printer-error-policy */
                        *RIPCache               VALUE(NULL),
@@ -96,33 +150,35 @@ VAR char           *AccessLog              VALUE(NULL),
                                        /* Temporary directory */
                        *Printcap               VALUE(NULL),
                                        /* Printcap file */
-                       *PrintcapGUI            VALUE(NULL),
-                                       /* GUI program to use for IRIX */
                        *FontPath               VALUE(NULL),
                                        /* Font search path */
                        *RemoteRoot             VALUE(NULL),
                                        /* Remote root user */
                        *Classification         VALUE(NULL);
                                        /* Classification of system */
-#ifdef HAVE_GSSAPI
-VAR char               *GSSServiceName         VALUE(NULL);
-                                       /* GSS service name */
-VAR char               *Krb5Keytab             VALUE(NULL);
-                                       /* Kerberos Keytab */
-#endif /* HAVE_GSSAPI */
 VAR uid_t              User                    VALUE(1);
                                        /* User ID for server */
 VAR gid_t              Group                   VALUE(0);
                                        /* Group ID for server */
+VAR cupsd_accesslog_t  AccessLogLevel          VALUE(CUPSD_ACCESSLOG_ACTIONS);
+                                       /* Access log level */
 VAR int                        ClassifyOverride        VALUE(0),
                                        /* Allow overrides? */
                        ConfigFilePerm          VALUE(0640),
                                        /* Permissions for config files */
-                       LogFilePerm             VALUE(0644),
+                       LogDebugHistory         VALUE(200),
+                                       /* Amount of automatic debug history */
+                       FatalErrors             VALUE(CUPSD_FATAL_CONFIG),
+                                       /* Which errors are fatal? */
+                       StrictConformance       VALUE(FALSE),
+                                       /* Require strict IPP conformance? */
+                       LogFilePerm             VALUE(0644);
                                        /* Permissions for log files */
-                       LogLevel                VALUE(CUPSD_LOG_ERROR),
-                                       /* Log level */
-                       MaxClients              VALUE(0),
+VAR cupsd_loglevel_t   LogLevel                VALUE(CUPSD_LOG_WARN);
+                                       /* Error log level */
+VAR cupsd_time_t       LogTimeFormat           VALUE(CUPSD_TIME_STANDARD);
+                                       /* Log file time format */
+VAR int                        MaxClients              VALUE(100),
                                        /* Maximum number of clients */
                        MaxClientsPerHost       VALUE(0),
                                        /* Maximum number of clients per host */
@@ -130,8 +186,6 @@ VAR int                     ClassifyOverride        VALUE(0),
                                        /* Maximum number of copies per job */
                        MaxLogSize              VALUE(1024 * 1024),
                                        /* Maximum size of log files */
-                       MaxPrinterHistory       VALUE(10),
-                                       /* Maximum printer state history */
                        MaxRequestSize          VALUE(0),
                                        /* Maximum size of IPP requests */
                        HostNameLookups         VALUE(FALSE),
@@ -142,12 +196,6 @@ VAR int                    ClassifyOverride        VALUE(0),
                                        /* Support the Keep-Alive option? */
                        KeepAliveTimeout        VALUE(DEFAULT_KEEPALIVE),
                                        /* Timeout between requests */
-                       ImplicitClasses         VALUE(TRUE),
-                                       /* Are classes implicitly created? */
-                       ImplicitAnyClasses      VALUE(FALSE),
-                                       /* Create AnyPrinter classes? */
-                       HideImplicitMembers     VALUE(TRUE),
-                                       /* Hide implicit class members? */
                        FileDevice              VALUE(FALSE),
                                        /* Allow file: devices? */
                        FilterLimit             VALUE(0),
@@ -156,21 +204,28 @@ VAR int                   ClassifyOverride        VALUE(0),
                                        /* Current filter level */
                        FilterNice              VALUE(0),
                                        /* Nice value for filters */
-                       ReloadTimeout           VALUE(0),
+                       ReloadTimeout           VALUE(DEFAULT_KEEPALIVE),
                                        /* Timeout before reload from SIGHUP */
                        RootCertDuration        VALUE(300),
                                        /* Root certificate update interval */
-                       RunUser,        /* User to run as, used for files */
+                       RunUser                 VALUE(0),
+                                       /* User to run as, used for files */
                        PrintcapFormat          VALUE(PRINTCAP_BSD),
                                        /* Format of printcap file? */
-                       DefaultShared           VALUE(TRUE);
+                       DefaultShared           VALUE(TRUE),
                                        /* Share printers by default? */
+                       MultipleOperationTimeout VALUE(DEFAULT_TIMEOUT),
+                                       /* multiple-operation-time-out value */
+                       WebInterface            VALUE(CUPS_DEFAULT_WEBIF);
+                                       /* Enable the web interface? */
 VAR cups_file_t                *AccessFile             VALUE(NULL),
                                        /* Access log file */
                        *ErrorFile              VALUE(NULL),
                                        /* Error log file */
                        *PageFile               VALUE(NULL);
                                        /* Page log file */
+VAR char               *PageLogFormat          VALUE(NULL);
+                                       /* Page log format */
 VAR mime_t             *MimeDatabase           VALUE(NULL);
                                        /* MIME type database */
 VAR int                        NumMimeTypes            VALUE(0);
@@ -185,50 +240,60 @@ VAR char          *ServerCertificate      VALUE(NULL);
 VAR char               *ServerKey              VALUE(NULL);
                                        /* Server key file */
 #  endif /* HAVE_LIBSSL || HAVE_GNUTLS */
+VAR int                        SSLOptions              VALUE(CUPSD_SSL_NONE);
+                                       /* SSL/TLS options */
 #endif /* HAVE_SSL */
 
 #ifdef HAVE_LAUNCHD
-VAR int                        LaunchdTimeout          VALUE(DEFAULT_TIMEOUT);
+VAR int                        LaunchdTimeout          VALUE(10);
                                        /* Time after which an idle cupsd will exit */
-VAR char               *LaunchdConf            VALUE(NULL);
-                                       /* launchd(8) configuration file */
 #endif /* HAVE_LAUNCHD */
 
-#ifdef __APPLE__
-VAR int                        AppleQuotas             VALUE(TRUE);
-                                       /* Use Apple PrintService Quotas instead of CUPS quotas */
-#endif  /* __APPLE__ */
-
 #ifdef HAVE_AUTHORIZATION_H
 VAR char               *SystemGroupAuthKey     VALUE(NULL);
                                        /* System group auth key */
 #endif /* HAVE_AUTHORIZATION_H */
 
+#ifdef HAVE_GSSAPI
+VAR char               *GSSServiceName         VALUE(NULL);
+                                       /* GSS service name */
+int                    HaveServerCreds         VALUE(0);
+                                       /* Do we have server credentials? */
+gss_cred_id_t          ServerCreds;    /* Server's GSS credentials */
+#endif /* HAVE_GSSAPI */
+
 
 /*
  * Prototypes...
  */
 
+extern void    cupsdAddAlias(cups_array_t *aliases, const char *name);
+extern int     cupsdCheckLogFile(cups_file_t **lf, const char *logname);
 extern int     cupsdCheckPermissions(const char *filename,
                                      const char *suffix, int mode,
                                      int user, int group, int is_dir,
                                      int create_dir);
-extern char    *cupsdGetDateTime(time_t t);
+extern int     cupsdCheckProgram(const char *filename, cupsd_printer_t *p);
+extern int     cupsdDefaultAuthType(void);
+extern void    cupsdFreeAliases(cups_array_t *aliases);
+extern char    *cupsdGetDateTime(struct timeval *t, cupsd_time_t format);
+extern void    cupsdLogFCMessage(void *context, _cups_fc_result_t result,
+                                 const char *message);
 #ifdef HAVE_GSSAPI
 extern int     cupsdLogGSSMessage(int level, int major_status,
                                   int minor_status,
                                   const char *message, ...);
 #endif /* HAVE_GSSAPI */
+extern int     cupsdLogJob(cupsd_job_t *job, int level, const char *message,
+                           ...) __attribute__((__format__(__printf__, 3, 4)));
 extern int     cupsdLogMessage(int level, const char *message, ...)
-#ifdef __GNUC__
-__attribute__ ((__format__ (__printf__, 2, 3)))
-#endif /* __GNUC__ */
-;
+               __attribute__ ((__format__ (__printf__, 2, 3)));
 extern int     cupsdLogPage(cupsd_job_t *job, const char *page);
 extern int     cupsdLogRequest(cupsd_client_t *con, http_status_t code);
 extern int     cupsdReadConfiguration(void);
+extern int     cupsdWriteErrorLog(int level, const char *message);
 
 
 /*
- * End of "$Id: conf.h 6649 2007-07-11 21:46:42Z mike $".
+ * End of "$Id$".
  */