2 * "$Id: ipp.h 4922 2006-01-12 22:05:06Z mike $"
4 * Internet Printing Protocol definitions for the Common UNIX Printing
7 * Copyright 1997-2006 by Easy Software Products.
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
16 * Attn: CUPS Licensing Information
17 * Easy Software Products
18 * 44141 Airport View Drive, Suite 204
19 * Hollywood, Maryland 20636 USA
21 * Voice: (301) 373-9600
22 * EMail: cups-info@cups.org
23 * WWW: http://www.cups.org
25 * This file is subject to the Apple OS-Developed Software exception.
32 * Include necessary headers...
44 # endif /* __cplusplus */
48 * IPP version string...
51 # define IPP_VERSION "\001\001"
54 * IPP registered port number...
56 * Note: Applications should never use IPP_PORT, but instead use the
57 * ippPort() function to allow overrides via the IPP_PORT environment
58 * variable and services file if needed!
67 # define IPP_MAX_NAME 256
68 # define IPP_MAX_VALUES 8 /* Power-of-2 allocation increment */
72 * Types and structures...
75 typedef enum /**** Format tags for attribute formats... ****/
82 IPP_TAG_UNSUPPORTED_GROUP
,
84 IPP_TAG_EVENT_NOTIFICATION
,
85 IPP_TAG_UNSUPPORTED_VALUE
= 0x10,
89 IPP_TAG_NOTSETTABLE
= 0x15,
92 IPP_TAG_INTEGER
= 0x21,
95 IPP_TAG_STRING
= 0x30,
99 IPP_TAG_BEGIN_COLLECTION
,
102 IPP_TAG_END_COLLECTION
,
105 IPP_TAG_KEYWORD
= 0x44,
112 IPP_TAG_MASK
= 0x7fffffff, /* Mask for copied attribute values */
113 IPP_TAG_COPY
= -0x7fffffff-1 /* Bitflag for copied attribute values */
116 typedef enum /**** Resolution units... ****/
118 IPP_RES_PER_INCH
= 3,
122 typedef enum /**** Finishings... ****/
124 IPP_FINISHINGS_NONE
= 3,
125 IPP_FINISHINGS_STAPLE
,
126 IPP_FINISHINGS_PUNCH
,
127 IPP_FINISHINGS_COVER
,
129 IPP_FINISHINGS_SADDLE_STITCH
,
130 IPP_FINISHINGS_EDGE_STITCH
,
134 IPP_FINISHINGS_BOOKLET_MAKER
,
135 IPP_FINISHINGS_JOB_OFFSET
,
136 IPP_FINISHINGS_STAPLE_TOP_LEFT
= 20,
137 IPP_FINISHINGS_STAPLE_BOTTOM_LEFT
,
138 IPP_FINISHINGS_STAPLE_TOP_RIGHT
,
139 IPP_FINISHINGS_STAPLE_BOTTOM_RIGHT
,
140 IPP_FINISHINGS_EDGE_STITCH_LEFT
,
141 IPP_FINISHINGS_EDGE_STITCH_TOP
,
142 IPP_FINISHINGS_EDGE_STITCH_RIGHT
,
143 IPP_FINISHINGS_EDGE_STITCH_BOTTOM
,
144 IPP_FINISHINGS_STAPLE_DUAL_LEFT
,
145 IPP_FINISHINGS_STAPLE_DUAL_TOP
,
146 IPP_FINISHINGS_STAPLE_DUAL_RIGHT
,
147 IPP_FINISHINGS_STAPLE_DUAL_BOTTOM
,
148 IPP_FINISHINGS_BIND_LEFT
= 50,
149 IPP_FINISHINGS_BIND_TOP
,
150 IPP_FINISHINGS_BIND_RIGHT
,
151 IPP_FINISHINGS_BIND_BOTTOM
154 typedef enum /**** Orientation... ****/
156 IPP_PORTRAIT
= 3, /* No rotation */
157 IPP_LANDSCAPE
, /* 90 degrees counter-clockwise */
158 IPP_REVERSE_LANDSCAPE
, /* 90 degrees clockwise */
159 IPP_REVERSE_PORTRAIT
/* 180 degrees */
162 typedef enum /**** Qualities... ****/
164 IPP_QUALITY_DRAFT
= 3,
169 typedef enum /**** Job States.... */
180 typedef enum /**** Printer States.... */
182 IPP_PRINTER_IDLE
= 3,
183 IPP_PRINTER_PROCESSING
,
187 typedef enum /**** IPP states... ****/
189 IPP_ERROR
= -1, /* An error occurred */
190 IPP_IDLE
, /* Nothing is happening/request completed */
191 IPP_HEADER
, /* The request header needs to be sent/received */
192 IPP_ATTRIBUTE
, /* One or more attributes need to be sent/received */
193 IPP_DATA
/* IPP request data needs to be sent/received */
196 typedef enum /**** IPP operations... ****/
198 IPP_PRINT_JOB
= 0x0002,
205 IPP_GET_JOB_ATTRIBUTES
,
207 IPP_GET_PRINTER_ATTRIBUTES
,
211 IPP_PAUSE_PRINTER
= 0x0010,
214 IPP_SET_PRINTER_ATTRIBUTES
,
215 IPP_SET_JOB_ATTRIBUTES
,
216 IPP_GET_PRINTER_SUPPORTED_VALUES
,
217 IPP_CREATE_PRINTER_SUBSCRIPTION
,
218 IPP_CREATE_JOB_SUBSCRIPTION
,
219 IPP_GET_SUBSCRIPTION_ATTRIBUTES
,
220 IPP_GET_SUBSCRIPTIONS
,
221 IPP_RENEW_SUBSCRIPTION
,
222 IPP_CANCEL_SUBSCRIPTION
,
223 IPP_GET_NOTIFICATIONS
,
224 IPP_SEND_NOTIFICATIONS
,
225 IPP_GET_PRINT_SUPPORT_FILES
= 0x0021,
228 IPP_PAUSE_PRINTER_AFTER_CURRENT_JOB
,
230 IPP_RELEASE_HELD_NEW_JOBS
,
231 IPP_DEACTIVATE_PRINTER
,
232 IPP_ACTIVATE_PRINTER
,
234 IPP_SHUTDOWN_PRINTER
,
237 IPP_CANCEL_CURRENT_JOB
,
238 IPP_SUSPEND_CURRENT_JOB
,
241 IPP_SCHEDULE_JOB_AFTER
,
242 IPP_PRIVATE
= 0x4000,
256 CUPS_AUTHENTICATE_JOB
259 typedef enum /**** IPP status codes... ****/
264 IPP_OK_IGNORED_SUBSCRIPTIONS
,
265 IPP_OK_IGNORED_NOTIFICATIONS
,
266 IPP_OK_TOO_MANY_EVENTS
,
267 IPP_OK_BUT_CANCEL_SUBSCRIPTION
,
268 IPP_REDIRECTION_OTHER_SITE
= 0x300,
269 IPP_BAD_REQUEST
= 0x0400,
271 IPP_NOT_AUTHENTICATED
,
284 IPP_COMPRESSION_NOT_SUPPORTED
,
285 IPP_COMPRESSION_ERROR
,
286 IPP_DOCUMENT_FORMAT_ERROR
,
287 IPP_DOCUMENT_ACCESS_ERROR
,
288 IPP_ATTRIBUTES_NOT_SETTABLE
,
289 IPP_IGNORED_ALL_SUBSCRIPTIONS
,
290 IPP_TOO_MANY_SUBSCRIPTIONS
,
291 IPP_IGNORED_ALL_NOTIFICATIONS
,
292 IPP_PRINT_SUPPORT_FILE_NOT_FOUND
,
294 IPP_INTERNAL_ERROR
= 0x0500,
295 IPP_OPERATION_NOT_SUPPORTED
,
296 IPP_SERVICE_UNAVAILABLE
,
297 IPP_VERSION_NOT_SUPPORTED
,
302 IPP_ERROR_JOB_CANCELLED
,
303 IPP_MULTIPLE_JOBS_NOT_SUPPORTED
,
304 IPP_PRINTER_IS_DEACTIVATED
307 typedef unsigned char ipp_uchar_t
;/**** Unsigned 8-bit integer/character ****/
309 /**** New in CUPS 1.1.19 ****/
310 typedef int (*ipp_iocb_t
)(void *, ipp_uchar_t
*, int);
311 /**** IPP IO Callback Function ****/
313 typedef union /**** Request Header ****/
315 struct /* Any Header */
317 ipp_uchar_t version
[2]; /* Protocol version number */
318 int op_status
; /* Operation ID or status code*/
319 int request_id
; /* Request ID */
322 struct /* Operation Header */
324 ipp_uchar_t version
[2]; /* Protocol version number */
325 ipp_op_t operation_id
; /* Operation ID */
326 int request_id
; /* Request ID */
329 struct /* Status Header */
331 ipp_uchar_t version
[2]; /* Protocol version number */
332 ipp_status_t status_code
; /* Status code */
333 int request_id
; /* Request ID */
336 /**** New in CUPS 1.1.19 ****/
337 struct /* Event Header */
339 ipp_uchar_t version
[2]; /* Protocol version number */
340 ipp_status_t status_code
; /* Status code */
341 int request_id
; /* Request ID */
345 /**** New in CUPS 1.1.19 ****/
346 typedef struct ipp_str ipp_t
;
348 typedef union /**** Attribute Value ****/
350 int integer
; /* Integer/enumerated value */
352 char boolean
; /* Boolean value */
354 ipp_uchar_t date
[11]; /* Date/time value */
358 int xres
, /* Horizontal resolution */
359 yres
; /* Vertical resolution */
360 ipp_res_t units
; /* Resolution units */
361 } resolution
; /* Resolution value */
365 int lower
, /* Lower value */
366 upper
; /* Upper value */
367 } range
; /* Range of integers value */
371 char *charset
; /* Character set */
372 char *text
; /* String */
373 } string
; /* String with language value */
377 int length
; /* Length of attribute */
378 void *data
; /* Data in attribute */
379 } unknown
; /* Unknown attribute type */
381 /**** New in CUPS 1.1.19 ****/
382 ipp_t
*collection
; /* Collection value */
385 typedef struct ipp_attribute_s
/**** Attribute ****/
387 struct ipp_attribute_s
*next
; /* Next attribute in list */
388 ipp_tag_t group_tag
, /* Job/Printer/Operation group tag */
389 value_tag
; /* What type of value is it? */
390 char *name
; /* Name of attribute */
391 int num_values
; /* Number of values */
392 ipp_value_t values
[1]; /* Values */
395 struct ipp_str
/**** IPP Request/Response/Notification ****/
397 ipp_state_t state
; /* State of request */
398 ipp_request_t request
; /* Request header */
399 ipp_attribute_t
*attrs
, /* Attributes */
400 *last
, /* Last attribute in list */
401 *current
; /* Current attribute (for read/write) */
402 ipp_tag_t curtag
; /* Current attribute group tag */
404 /**** New in CUPS 1.2 ****/
405 ipp_attribute_t
*prev
; /* Previous attribute (for read) */
413 extern ipp_attribute_t
*ippAddBoolean(ipp_t
*ipp
, ipp_tag_t group
, const char *name
, char value
);
414 extern ipp_attribute_t
*ippAddBooleans(ipp_t
*ipp
, ipp_tag_t group
, const char *name
, int num_values
, const char *values
);
415 extern ipp_attribute_t
*ippAddDate(ipp_t
*ipp
, ipp_tag_t group
, const char *name
, const ipp_uchar_t
*value
);
416 extern ipp_attribute_t
*ippAddInteger(ipp_t
*ipp
, ipp_tag_t group
, ipp_tag_t type
, const char *name
, int value
);
417 extern ipp_attribute_t
*ippAddIntegers(ipp_t
*ipp
, ipp_tag_t group
, ipp_tag_t type
, const char *name
, int num_values
, const int *values
);
418 extern ipp_attribute_t
*ippAddRange(ipp_t
*ipp
, ipp_tag_t group
, const char *name
, int lower
, int upper
);
419 extern ipp_attribute_t
*ippAddRanges(ipp_t
*ipp
, ipp_tag_t group
, const char *name
, int num_values
, const int *lower
, const int *upper
);
420 extern ipp_attribute_t
*ippAddResolution(ipp_t
*ipp
, ipp_tag_t group
, const char *name
, ipp_res_t units
, int xres
, int yres
);
421 extern ipp_attribute_t
*ippAddResolutions(ipp_t
*ipp
, ipp_tag_t group
, const char *name
, int num_values
, ipp_res_t units
, const int *xres
, const int *yres
);
422 extern ipp_attribute_t
*ippAddSeparator(ipp_t
*ipp
);
423 extern ipp_attribute_t
*ippAddString(ipp_t
*ipp
, ipp_tag_t group
, ipp_tag_t type
, const char *name
, const char *charset
, const char *value
);
424 extern ipp_attribute_t
*ippAddStrings(ipp_t
*ipp
, ipp_tag_t group
, ipp_tag_t type
, const char *name
, int num_values
, const char *charset
, const char * const *values
);
425 extern time_t ippDateToTime(const ipp_uchar_t
*date
);
426 extern void ippDelete(ipp_t
*ipp
);
427 extern const char *ippErrorString(ipp_status_t error
);
428 extern ipp_attribute_t
*ippFindAttribute(ipp_t
*ipp
, const char *name
,
430 extern ipp_attribute_t
*ippFindNextAttribute(ipp_t
*ipp
, const char *name
,
432 extern size_t ippLength(ipp_t
*ipp
);
433 extern ipp_t
*ippNew(void);
434 extern ipp_state_t
ippRead(http_t
*http
, ipp_t
*ipp
);
435 extern const ipp_uchar_t
*ippTimeToDate(time_t t
);
436 extern ipp_state_t
ippWrite(http_t
*http
, ipp_t
*ipp
);
437 extern int ippPort(void);
438 extern void ippSetPort(int p
);
440 /**** New in CUPS 1.1.19 ****/
441 extern ipp_attribute_t
*ippAddCollection(ipp_t
*ipp
, ipp_tag_t group
, const char *name
, ipp_t
*value
);
442 extern ipp_attribute_t
*ippAddCollections(ipp_t
*ipp
, ipp_tag_t group
, const char *name
, int num_values
, const ipp_t
**values
);
443 extern void ippDeleteAttribute(ipp_t
*ipp
, ipp_attribute_t
*attr
);
444 extern ipp_state_t
ippReadFile(int fd
, ipp_t
*ipp
);
445 extern ipp_state_t
ippReadIO(void *src
, ipp_iocb_t cb
, int blocking
, ipp_t
*parent
, ipp_t
*ipp
);
446 extern ipp_state_t
ippWriteFile(int fd
, ipp_t
*ipp
);
447 extern ipp_state_t
ippWriteIO(void *dst
, ipp_iocb_t cb
, int blocking
, ipp_t
*parent
, ipp_t
*ipp
);
449 /**** New in CUPS 1.2 ****/
450 extern ipp_attribute_t
*ippAddOctetString(ipp_t
*ipp
, ipp_tag_t group
,
452 const void *data
, int datalen
);
453 extern ipp_status_t
ippErrorValue(const char *name
);
454 extern ipp_t
*ippNewRequest(ipp_op_t op
);
455 extern const char *ippOpString(ipp_op_t op
);
456 extern ipp_op_t
ippOpValue(const char *name
);
459 * "Private" functions used internally by CUPS...
462 extern ipp_attribute_t
*_ipp_add_attr(ipp_t
*, int);
463 extern void _ipp_free_attr(ipp_attribute_t
*);
472 # endif /* __cplusplus */
473 #endif /* !_CUPS_IPP_H_ */
476 * End of "$Id: ipp.h 4922 2006-01-12 22:05:06Z mike $".