scheduler/dirsvc.h

   1 /*
   2  * "$Id: dirsvc.h,v 1.12.2.12 2004/08/23 18:01:56 mike Exp $"
   3  *
   4  *   Directory services definitions for the Common UNIX Printing System
   5  *   (CUPS) scheduler.
   6  *
   7  *   Copyright 1997-2004 by Easy Software Products, all rights reserved.
   8  *
   9  *   These coded instructions, statements, and computer programs are the
  10  *   property of Easy Software Products and are protected by Federal
  11  *   copyright law.  Distribution and use rights are outlined in the file
  12  *   "LICENSE.txt" which should have been included with this file.  If this
  13  *   file is missing or damaged please contact Easy Software Products
  14  *   at:
  15  *
  16  *       Attn: CUPS Licensing Information
  17  *       Easy Software Products
  18  *       44141 Airport View Drive, Suite 204
  19  *       Hollywood, Maryland 20636 USA
  20  *
  21  *       Voice: (301) 373-9600
  22  *       EMail: cups-info@cups.org
  23  *         WWW: http://www.cups.org
  24  */
  25
  26 /*
  27  * Include necessary headers...
  28  */
  29
  30 #ifdef HAVE_LIBSLP
  31 #  include <slp.h>
  32 #endif /* HAVE_LIBSLP */
  33
  34
  35 /*
  36  * Browse protocols...
  37  */
  38
  39 #define BROWSE_CUPS     1               /* CUPS */
  40 #define BROWSE_SLP      2               /* SLPv2 */
  41 #define BROWSE_LDAP     4               /* LDAP (not supported yet) */
  42 #define BROWSE_ALL      7               /* All protocols */
  43
  44
  45 /*
  46  * Browse address...
  47  */
  48
  49 typedef struct
  50 {
  51   char                  iface[32];      /* Destination interface */
  52   http_addr_t           to;             /* Destination address */
  53 } dirsvc_addr_t;
  54
  55
  56 /*
  57  * Relay structure...
  58  */
  59
  60 typedef struct
  61 {
  62   authmask_t            from;           /* Source address/name mask */
  63   http_addr_t           to;             /* Destination address */
  64 } dirsvc_relay_t;
  65
  66
  67 /*
  68  * Polling structure...
  69  */
  70
  71 typedef struct
  72 {
  73   char                  hostname[64];   /* Hostname (actually, IP address) */
  74   int                   port;           /* Port number */
  75   int                   pid;            /* Current poll server PID */
  76 } dirsvc_poll_t;
  77
  78
  79 /*
  80  * Globals...
  81  */
  82
  83 VAR int                 Browsing        VALUE(TRUE),
  84                                         /* Whether or not browsing is enabled */
  85                         BrowseProtocols VALUE(BROWSE_ALL),
  86                                         /* Protocols to support */
  87                         BrowseShortNames VALUE(TRUE),
  88                                         /* Short names for remote printers? */
  89                         BrowseSocket    VALUE(-1),
  90                                         /* Socket for browsing */
  91                         BrowsePort      VALUE(IPP_PORT),
  92                                         /* Port number for broadcasts */
  93                         BrowseInterval  VALUE(DEFAULT_INTERVAL),
  94                                         /* Broadcast interval in seconds */
  95                         BrowseTimeout   VALUE(DEFAULT_TIMEOUT),
  96                                         /* Time out for printers in seconds */
  97                         NumBrowsers     VALUE(0);
  98                                         /* Number of broadcast addresses */
  99 VAR char                *BrowseLocalOptions
 100                                         VALUE(NULL),
 101                                         /* Options to add to local printer URIs */
 102                         *BrowseRemoteOptions
 103                                         VALUE(NULL);
 104                                         /* Options to add to remote printer URIs */
 105 VAR dirsvc_addr_t       *Browsers       VALUE(NULL);
 106                                         /* Broadcast addresses */
 107 VAR location_t          *BrowseACL      VALUE(NULL);
 108                                         /* Browser access control list */
 109 VAR printer_t           *BrowseNext     VALUE(NULL);
 110                                         /* Next class/printer to broadcast */
 111 VAR int                 NumRelays       VALUE(0);
 112                                         /* Number of broadcast relays */
 113 VAR dirsvc_relay_t      *Relays         VALUE(NULL);
 114                                         /* Broadcast relays */
 115 VAR int                 NumPolled       VALUE(0);
 116                                         /* Number of polled servers */
 117 VAR dirsvc_poll_t       *Polled         VALUE(NULL);
 118                                         /* Polled servers */
 119 VAR int                 PollPipe        VALUE(0);
 120                                         /* Status pipe for pollers */
 121
 122 #ifdef HAVE_LIBSLP
 123 VAR SLPHandle           BrowseSLPHandle VALUE(NULL);
 124                                         /* SLP API handle */
 125 VAR time_t              BrowseSLPRefresh VALUE(0);
 126                                         /* Next SLP refresh time */
 127 #endif /* HAVE_LIBSLP */
 128
 129
 130 /*
 131  * Prototypes...
 132  */
 133
 134 extern void     ProcessBrowseData(const char *uri, cups_ptype_t type,
 135                                   ipp_pstate_t state, const char *location,
 136                                   const char *info, const char *make_model);
 137 extern void     SendBrowseDelete(printer_t *p);
 138 extern void     SendBrowseList(void);
 139 extern void     SendCUPSBrowse(printer_t *p);
 140 extern void     SendSLPBrowse(printer_t *p);
 141 extern void     StartBrowsing(void);
 142 extern void     StartPolling(void);
 143 extern void     StopBrowsing(void);
 144 extern void     StopPolling(void);
 145 extern void     UpdateCUPSBrowse(void);
 146 extern void     UpdatePolling(void);
 147 extern void     UpdateSLPBrowse(void);
 148
 149
 150 /*
 151  * End of "$Id: dirsvc.h,v 1.12.2.12 2004/08/23 18:01:56 mike Exp $".
 152  */