[thirdparty/cups.git] / cups / sidechannel.h

/*
 * "$Id: sidechannel.h 6649 2007-07-11 21:46:42Z mike $"
 *
 *   Side-channel API definitions for the Common UNIX Printing System (CUPS).
 *
 *   Copyright 2007-2008 by Apple Inc.
 *   Copyright 2006 by Easy Software Products.
 *
 *   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/".
 *
 *   This file is subject to the Apple OS-Developed Software exception.
 */

#ifndef _CUPS_SIDECHANNEL_H_
#  define _CUPS_SIDECHANNEL_H_

/*
 * Include necessary headers...
 */

#  include "versioning.h"


/*
 * C++ magic...
 */

#  ifdef __cplusplus
extern "C" {
#  endif /* __cplusplus */


/*
 * Constants...
 */

#define CUPS_SC_FD	4		/* File descriptor for select/poll */


/*
 * Enumerations...
 */

enum cups_sc_bidi_e			/**** Bidirectional capabilities ****/
{
  CUPS_SC_BIDI_NOT_SUPPORTED = 0,	/* Bidirectional I/O is not supported */
  CUPS_SC_BIDI_SUPPORTED = 1		/* Bidirectional I/O is supported */
};
typedef enum cups_sc_bidi_e cups_sc_bidi_t;
					/**** Bidirectional capabilities ****/

enum cups_sc_command_e			/**** Request command codes ****/
{
  CUPS_SC_CMD_SOFT_RESET = 1,		/* Do a soft reset */
  CUPS_SC_CMD_DRAIN_OUTPUT = 2,		/* Drain all pending output */
  CUPS_SC_CMD_GET_BIDI = 3,		/* Return bidirectional capabilities */
  CUPS_SC_CMD_GET_DEVICE_ID = 4,	/* Return the IEEE-1284 device ID */
  CUPS_SC_CMD_GET_STATE = 5		/* Return the device state */
};
typedef enum cups_sc_command_e cups_sc_command_t;
					/**** Request command codes ****/

enum cups_sc_state_e			/**** Printer state bits ****/
{
  CUPS_SC_STATE_OFFLINE = 0,		/* Device is off-line */
  CUPS_SC_STATE_ONLINE = 1,		/* Device is on-line */
  CUPS_SC_STATE_BUSY = 2,		/* Device is busy */
  CUPS_SC_STATE_ERROR = 4,		/* Other error condition */
  CUPS_SC_STATE_MEDIA_LOW = 16,		/* Paper low condition */
  CUPS_SC_STATE_MEDIA_EMPTY = 32,	/* Paper out condition */
  CUPS_SC_STATE_MARKER_LOW = 64,	/* Toner/ink low condition */
  CUPS_SC_STATE_MARKER_EMPTY = 128	/* Toner/ink out condition */
};
typedef enum cups_sc_state_e cups_sc_state_t;
					/**** Printer state bits ****/

enum cups_sc_status_e			/**** Response status codes ****/
{
  CUPS_SC_STATUS_NONE,			/* No status */
  CUPS_SC_STATUS_OK,			/* Operation succeeded */
  CUPS_SC_STATUS_IO_ERROR,		/* An I/O error occurred */
  CUPS_SC_STATUS_TIMEOUT,		/* The backend did not respond */
  CUPS_SC_STATUS_NO_RESPONSE,		/* The device did not respond */
  CUPS_SC_STATUS_BAD_MESSAGE,		/* The command/response message was invalid */
  CUPS_SC_STATUS_TOO_BIG,		/* Response too big */
  CUPS_SC_STATUS_NOT_IMPLEMENTED	/* Command not implemented */
};
typedef enum cups_sc_status_e cups_sc_status_t;
					/**** Response status codes ****/


/*
 * Prototypes...
 */

extern cups_sc_status_t	cupsSideChannelDoRequest(cups_sc_command_t command,
			                         char *data, int *datalen,
						 double timeout) _CUPS_API_1_3;
extern int		cupsSideChannelRead(cups_sc_command_t *command,
			                    cups_sc_status_t *status,
					    char *data, int *datalen,
					    double timeout) _CUPS_API_1_3;
extern int		cupsSideChannelWrite(cups_sc_command_t command,
			                     cups_sc_status_t status,
					     const char *data, int datalen,
					     double timeout) _CUPS_API_1_3;


#  ifdef __cplusplus
}
#  endif /* __cplusplus */

#endif /* !_CUPS_SIDECHANNEL_H_ */

/*
 * End of "$Id: sidechannel.h 6649 2007-07-11 21:46:42Z mike $".
 */
Commit	Line	Data
f7deaa1a	1	/*
bc44d920	2	* "$Id: sidechannel.h 6649 2007-07-11 21:46:42Z mike $"
f7deaa1a	3	*
	4	* Side-channel API definitions for the Common UNIX Printing System (CUPS).
	5	*
5a738aea	6	* Copyright 2007-2008 by Apple Inc.
f7deaa1a	7	* Copyright 2006 by Easy Software Products.
	8	*
	9	* These coded instructions, statements, and computer programs are the
bc44d920	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/".
f7deaa1a	14	*
	15	* This file is subject to the Apple OS-Developed Software exception.
	16	*/
	17
	18	#ifndef _CUPS_SIDECHANNEL_H_
	19	# define _CUPS_SIDECHANNEL_H_
	20
2fb76298 MS	21	/*
	22	* Include necessary headers...
	23	*/
	24
	25	# include "versioning.h"
	26
	27
f7deaa1a	28	/*
	29	* C++ magic...
	30	*/
	31
	32	# ifdef __cplusplus
	33	extern "C" {
	34	# endif /* __cplusplus */
	35
	36
	37	/*
	38	* Constants...
	39	*/
	40
	41	#define CUPS_SC_FD 4 /* File descriptor for select/poll */
	42
	43
	44	/*
	45	* Enumerations...
	46	*/
	47
5a738aea	48	enum cups_sc_bidi_e /** Bidirectional capabilities **/
f7deaa1a	49	{
	50	CUPS_SC_BIDI_NOT_SUPPORTED = 0, /* Bidirectional I/O is not supported */
	51	CUPS_SC_BIDI_SUPPORTED = 1 /* Bidirectional I/O is supported */
5a738aea MS	52	};
	53	typedef enum cups_sc_bidi_e cups_sc_bidi_t;
	54	/** Bidirectional capabilities **/
f7deaa1a	55
5a738aea	56	enum cups_sc_command_e /** Request command codes **/
f7deaa1a	57	{
	58	CUPS_SC_CMD_SOFT_RESET = 1, /* Do a soft reset */
	59	CUPS_SC_CMD_DRAIN_OUTPUT = 2, /* Drain all pending output */
	60	CUPS_SC_CMD_GET_BIDI = 3, /* Return bidirectional capabilities */
	61	CUPS_SC_CMD_GET_DEVICE_ID = 4, /* Return the IEEE-1284 device ID */
	62	CUPS_SC_CMD_GET_STATE = 5 /* Return the device state */
5a738aea MS	63	};
	64	typedef enum cups_sc_command_e cups_sc_command_t;
	65	/** Request command codes **/
f7deaa1a	66
5a738aea	67	enum cups_sc_state_e /** Printer state bits **/
f7deaa1a	68	{
	69	CUPS_SC_STATE_OFFLINE = 0, /* Device is off-line */
	70	CUPS_SC_STATE_ONLINE = 1, /* Device is on-line */
	71	CUPS_SC_STATE_BUSY = 2, /* Device is busy */
	72	CUPS_SC_STATE_ERROR = 4, /* Other error condition */
	73	CUPS_SC_STATE_MEDIA_LOW = 16, /* Paper low condition */
	74	CUPS_SC_STATE_MEDIA_EMPTY = 32, /* Paper out condition */
	75	CUPS_SC_STATE_MARKER_LOW = 64, /* Toner/ink low condition */
	76	CUPS_SC_STATE_MARKER_EMPTY = 128 /* Toner/ink out condition */
5a738aea MS	77	};
	78	typedef enum cups_sc_state_e cups_sc_state_t;
	79	/** Printer state bits **/
f7deaa1a	80
5a738aea	81	enum cups_sc_status_e /** Response status codes **/
f7deaa1a	82	{
	83	CUPS_SC_STATUS_NONE, /* No status */
	84	CUPS_SC_STATUS_OK, /* Operation succeeded */
	85	CUPS_SC_STATUS_IO_ERROR, /* An I/O error occurred */
	86	CUPS_SC_STATUS_TIMEOUT, /* The backend did not respond */
	87	CUPS_SC_STATUS_NO_RESPONSE, /* The device did not respond */
	88	CUPS_SC_STATUS_BAD_MESSAGE, /* The command/response message was invalid */
	89	CUPS_SC_STATUS_TOO_BIG, /* Response too big */
	90	CUPS_SC_STATUS_NOT_IMPLEMENTED /* Command not implemented */
5a738aea MS	91	};
	92	typedef enum cups_sc_status_e cups_sc_status_t;
	93	/** Response status codes **/
f7deaa1a	94
	95
	96	/*
	97	* Prototypes...
	98	*/
	99
	100	extern cups_sc_status_t cupsSideChannelDoRequest(cups_sc_command_t command,
	101	char data, int datalen,
2fb76298	102	double timeout) _CUPS_API_1_3;
f7deaa1a	103	extern int cupsSideChannelRead(cups_sc_command_t *command,
	104	cups_sc_status_t *status,
	105	char data, int datalen,
2fb76298	106	double timeout) _CUPS_API_1_3;
f7deaa1a	107	extern int cupsSideChannelWrite(cups_sc_command_t command,
	108	cups_sc_status_t status,
	109	const char *data, int datalen,
2fb76298	110	double timeout) _CUPS_API_1_3;
f7deaa1a	111
	112
	113	# ifdef __cplusplus
	114	}
	115	# endif /* __cplusplus */
	116
	117	#endif /* !_CUPS_SIDECHANNEL_H_ */
	118
	119	/*
bc44d920	120	* End of "$Id: sidechannel.h 6649 2007-07-11 21:46:42Z mike $".
f7deaa1a	121	*/