]> git.ipfire.org Git - thirdparty/cups.git/blobdiff - scheduler/conf.h
Update all references to OS X to macOS.
[thirdparty/cups.git] / scheduler / conf.h
index e80a24ea996d0984b7fe8686a0792227542a95ab..3dc442518590fd8528a1979b12beaaf26a2a7df6 100644 (file)
@@ -1,17 +1,14 @@
 /*
- * "$Id: conf.h 7674 2008-06-18 23:18:32Z mike $"
+ * Configuration file definitions for the CUPS scheduler.
  *
- *   Configuration file definitions for the Common UNIX Printing System (CUPS)
- *   scheduler.
+ * Copyright 2007-2015 by Apple Inc.
+ * Copyright 1997-2007 by Easy Software Products, all rights reserved.
  *
- *   Copyright 2007-2008 by Apple Inc.
- *   Copyright 1997-2007 by Easy Software Products, all rights reserved.
- *
- *   These coded instructions, statements, and computer programs are the
- *   property of Apple Inc. and are protected by Federal copyright
- *   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
- *   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/".
+ * These coded instructions, statements, and computer programs are the
+ * property of Apple Inc. and are protected by Federal copyright
+ * law.  Distribution and use rights are outlined in the file "LICENSE.txt"
+ * 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/".
  */
 
 
 
 typedef enum
 {
-  CUPSD_LOG_PPD = -4,                  /* Used internally for PPD keywords */
+  CUPSD_LOG_PPD = -5,                  /* Used internally for PPD keywords */
   CUPSD_LOG_ATTR,                      /* Used internally for attributes */
-  CUPSD_LOG_STATE,                     /* Used internally for state-reasons */
+  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 */
@@ -39,11 +37,25 @@ typedef enum
 
 typedef enum
 {
+  CUPSD_ACCESSLOG_NONE,                        /* Log no requests */
   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;
+
+typedef enum
+{
+  CUPSD_SANDBOXING_OFF,                        /* No sandboxing */
+  CUPSD_SANDBOXING_RELAXED,            /* Relaxed sandboxing */
+  CUPSD_SANDBOXING_STRICT              /* Strict sandboxing */
+} cupsd_sandboxing_t;
+
 
 /*
  * FatalErrors flags...
@@ -64,6 +76,18 @@ typedef enum
 
 #define PRINTCAP_BSD           0       /* Berkeley LPD format */
 #define PRINTCAP_SOLARIS       1       /* Solaris lpsched format */
+#define PRINTCAP_PLIST         2       /* macOS plist format */
+
+
+/*
+ * ServerAlias data...
+ */
+
+typedef struct
+{
+  size_t       namelen;                /* Length of alias name */
+  char         name[1];                /* Alias name */
+} cupsd_alias_t;
 
 
 /*
@@ -71,7 +95,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),
@@ -86,7 +112,10 @@ 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]
@@ -107,8 +136,6 @@ 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),
@@ -121,37 +148,45 @@ 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);
+VAR uid_t              User                    VALUE(1),
                                        /* User ID for server */
+                       RunUser                 VALUE(0);
+                                       /* User to run as, used for files */
 VAR gid_t              Group                   VALUE(0);
                                        /* Group ID for server */
-VAR int                        AccessLogLevel          VALUE(CUPSD_ACCESSLOG_ACTIONS),
+VAR cupsd_accesslog_t  AccessLogLevel          VALUE(CUPSD_ACCESSLOG_ACTIONS);
                                        /* Access log level */
-                       ClassifyOverride        VALUE(0),
+VAR int                        ClassifyOverride        VALUE(0),
                                        /* Allow overrides? */
-                       ConfigFilePerm          VALUE(0640),
-                                       /* Permissions for config files */
+                       LogDebugHistory         VALUE(200),
+                                       /* Amount of automatic debug history */
                        FatalErrors             VALUE(CUPSD_FATAL_CONFIG),
                                        /* Which errors are fatal? */
-                       LogFilePerm             VALUE(0644),
+                       StrictConformance       VALUE(FALSE),
+                                       /* Require strict IPP conformance? */
+                       SyncOnClose             VALUE(FALSE);
+                                       /* Call fsync() when closing files? */
+VAR mode_t             ConfigFilePerm          VALUE(0640U),
+                                       /* Permissions for config files */
+                       LogFilePerm             VALUE(0644U);
                                        /* Permissions for log files */
-                       LogLevel                VALUE(CUPSD_LOG_WARN),
+VAR cupsd_loglevel_t   LogLevel                VALUE(CUPSD_LOG_WARN);
                                        /* Error log level */
-                       MaxClients              VALUE(0),
+VAR cupsd_time_t       LogTimeFormat           VALUE(CUPSD_TIME_STANDARD);
+                                       /* Log file time format */
+VAR cups_file_t                *LogStderr              VALUE(NULL);
+                                       /* Stderr file, if any */
+VAR cupsd_sandboxing_t Sandboxing              VALUE(CUPSD_SANDBOXING_STRICT);
+                                       /* Sandboxing level */
+VAR int                        UseSandboxing   VALUE(1);
+                                       /* Use sandboxing for child procs? */
+VAR int                        MaxClients              VALUE(100),
                                        /* Maximum number of clients */
                        MaxClientsPerHost       VALUE(0),
                                        /* Maximum number of clients per host */
@@ -159,8 +194,6 @@ VAR int                     AccessLogLevel          VALUE(CUPSD_ACCESSLOG_ACTIONS),
                                        /* 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),
@@ -171,12 +204,6 @@ VAR int                    AccessLogLevel          VALUE(CUPSD_ACCESSLOG_ACTIONS),
                                        /* 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),
@@ -189,12 +216,14 @@ VAR int                   AccessLogLevel          VALUE(CUPSD_ACCESSLOG_ACTIONS),
                                        /* Timeout before reload from SIGHUP */
                        RootCertDuration        VALUE(300),
                                        /* Root certificate update interval */
-                       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),
@@ -211,62 +240,58 @@ VAR const char            **MimeTypes             VALUE(NULL);
                                        /* Array of MIME types */
 
 #ifdef HAVE_SSL
-VAR char               *ServerCertificate      VALUE(NULL);
-                                       /* Server certificate file */
-#  if defined(HAVE_LIBSSL) || defined(HAVE_GNUTLS)
-VAR char               *ServerKey              VALUE(NULL);
-                                       /* Server key file */
-#  endif /* HAVE_LIBSSL || HAVE_GNUTLS */
+VAR char               *ServerKeychain         VALUE(NULL);
+                                       /* Keychain holding cert + key */
 #endif /* HAVE_SSL */
 
-#ifdef HAVE_LAUNCHD
-VAR int                        LaunchdTimeout          VALUE(DEFAULT_KEEPALIVE);
+#if defined(HAVE_LAUNCHD) || defined(HAVE_SYSTEMD)
+VAR int                        IdleExitTimeout         VALUE(60);
                                        /* 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__ */
+#endif /* HAVE_LAUNCHD || HAVE_SYSTEMD */
 
 #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 */
+VAR int                        HaveServerCreds         VALUE(0);
+                                       /* Do we have server credentials? */
+VAR 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,
+                                     const char *suffix, mode_t mode,
+                                     uid_t user, gid_t 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 int     cupsdLogClient(cupsd_client_t *con, int level,
+                               const char *message, ...)
+                               __attribute__((__format__(__printf__, 3, 4)));
+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,
+extern int     cupsdLogGSSMessage(int level, OM_uint32 major_status,
+                                  OM_uint32 minor_status,
                                   const char *message, ...);
 #endif /* HAVE_GSSAPI */
-extern int     cupsdLogJob(cupsd_job_t *job, int level, const char *message, ...)
-#ifdef __GNUC__
-__attribute__ ((__format__ (__printf__, 3, 4)))
-#endif /* __GNUC__ */
-;
+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 7674 2008-06-18 23:18:32Z mike $".
- */