scheduler/client.h

   1 /*
   2  * "$Id: client.h 6947 2007-09-12 21:09:49Z mike $"
   3  *
   4  *   Client definitions for the Common UNIX Printing System (CUPS) scheduler.
   5  *
   6  *   Copyright 2007 by Apple Inc.
   7  *   Copyright 1997-2007 by Easy Software Products, all rights reserved.
   8  *
   9  *   These coded instructions, statements, and computer programs are the
  10  *   property of Apple Inc. and are protected by Federal copyright
  11  *   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  12  *   which should have been included with this file.  If this file is
  13  *   file is missing or damaged, see the license at "http://www.cups.org/".
  14  */
  15
  16 #ifdef HAVE_AUTHORIZATION_H
  17 #  include <Security/Authorization.h>
  18 #endif /* HAVE_AUTHORIZATION_H */
  19
  20 /*
  21  * HTTP client structure...
  22  */
  23
  24 struct cupsd_client_s
  25 {
  26   http_t                http;           /* HTTP client connection */
  27   ipp_t                 *request,       /* IPP request information */
  28                         *response;      /* IPP response information */
  29   cupsd_location_t      *best;          /* Best match for AAA */
  30   time_t                start;          /* Request start time */
  31   http_state_t          operation;      /* Request operation */
  32   off_t                 bytes;          /* Bytes transferred for this request */
  33   char                  username[256],  /* Username from Authorization: line */
  34                         password[33],   /* Password from Authorization: line */
  35                         uri[HTTP_MAX_URI],
  36                                         /* Localized URL/URI for GET/PUT */
  37                         *filename,      /* Filename of output file */
  38                         *command,       /* Command to run */
  39                         *options,       /* Options for command */
  40                         *query_string;  /* QUERY_STRING environment variable */
  41   int                   file;           /* Input/output file */
  42   int                   file_ready;     /* Input ready on file/pipe? */
  43   int                   pipe_pid;       /* Pipe process ID (or 0 if not a pipe) */
  44   int                   sent_header,    /* Non-zero if sent HTTP header */
  45                         got_fields,     /* Non-zero if all fields seen */
  46                         field_col;      /* Column within line */
  47   cups_lang_t           *language;      /* Language to use */
  48 #ifdef HAVE_SSL
  49   int                   auto_ssl;       /* Automatic test for SSL/TLS */
  50 #endif /* HAVE_SSL */
  51   http_addr_t           clientaddr;     /* Client address */
  52   char                  servername[256];/* Server name for connection */
  53   int                   serverport;     /* Server port for connection */
  54 #ifdef HAVE_GSSAPI
  55   int                   gss_have_creds; /* Have authenticated credentials */
  56   gss_buffer_desc       gss_output_token;
  57                                         /* Output token for Negotiate header */
  58   gss_cred_id_t         gss_delegated_cred;
  59                                         /* Credentials from client header */
  60 #endif /* HAVE_GSSAPI */
  61 #ifdef HAVE_AUTHORIZATION_H
  62   AuthorizationRef      authref;        /* Authorization ref */
  63 #endif /* HAVE_AUTHORIZATION_H */
  64 };
  65
  66 #define HTTP(con) &((con)->http)
  67
  68
  69 /*
  70  * HTTP listener structure...
  71  */
  72
  73 typedef struct
  74 {
  75   int                   fd;             /* File descriptor for this server */
  76   http_addr_t           address;        /* Bind address of socket */
  77   http_encryption_t     encryption;     /* To encrypt or not to encrypt... */
  78 } cupsd_listener_t;
  79
  80
  81 /*
  82  * Globals...
  83  */
  84
  85 VAR int                 ListenBackLog   VALUE(SOMAXCONN),
  86                                         /* Max backlog of pending connections */
  87                         LocalPort       VALUE(631);
  88                                         /* Local port to use */
  89 VAR http_encryption_t   LocalEncryption VALUE(HTTP_ENCRYPT_IF_REQUESTED);
  90                                         /* Local port encryption to use */
  91 VAR cups_array_t        *Listeners      VALUE(NULL);
  92                                         /* Listening sockets */
  93 VAR time_t              ListeningPaused VALUE(0);
  94                                         /* Time when listening was paused */
  95 VAR cups_array_t        *Clients        VALUE(NULL);
  96                                         /* HTTP clients */
  97 VAR http_addrlist_t     *ServerAddrs    VALUE(NULL);
  98                                         /* Server address(es) */
  99 VAR char                *ServerHeader   VALUE(NULL);
 100                                         /* Server header in requests */
 101 VAR int                 CGIPipes[2]     VALUE2(-1,-1);
 102                                         /* Pipes for CGI error/debug output */
 103 VAR cupsd_statbuf_t     *CGIStatusBuffer VALUE(NULL);
 104                                         /* Status buffer for pipes */
 105
 106
 107 /*
 108  * Prototypes...
 109  */
 110
 111 extern void     cupsdAcceptClient(cupsd_listener_t *lis);
 112 extern void     cupsdCloseAllClients(void);
 113 extern int      cupsdCloseClient(cupsd_client_t *con);
 114 extern void     cupsdDeleteAllListeners(void);
 115 extern int      cupsdFlushHeader(cupsd_client_t *con);
 116 extern void     cupsdPauseListening(void);
 117 extern int      cupsdProcessIPPRequest(cupsd_client_t *con);
 118 extern void     cupsdReadClient(cupsd_client_t *con);
 119 extern void     cupsdResumeListening(void);
 120 extern int      cupsdSendCommand(cupsd_client_t *con, char *command,
 121                                  char *options, int root);
 122 extern int      cupsdSendError(cupsd_client_t *con, http_status_t code,
 123                                int auth_type);
 124 extern int      cupsdSendHeader(cupsd_client_t *con, http_status_t code,
 125                                 char *type, int auth_type);
 126 extern void     cupsdShutdownClient(cupsd_client_t *con);
 127 extern void     cupsdStartListening(void);
 128 extern void     cupsdStopListening(void);
 129 extern void     cupsdUpdateCGI(void);
 130 extern void     cupsdWriteClient(cupsd_client_t *con);
 131
 132
 133 /*
 134  * End of "$Id: client.h 6947 2007-09-12 21:09:49Z mike $".
 135  */