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

/*
 * "$Id$"
 *
 *   SNMP definitions for the Common UNIX Printing System (CUPS).
 *
 *   Copyright 2007-2008 by Apple Inc.
 *   Copyright 2006-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"
 *   "LICENSE" which should have been included with this file.  If this
 *   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_SNMP_H_
#  define _CUPS_SNMP_H_


/*
 * Include necessary headers.
 */

#include "http.h"


/*
 * Constants...
 */

#define CUPS_SNMP_PORT		161	/* SNMP well-known port */
#define CUPS_SNMP_MAX_OID	128	/* Maximum number of OID numbers */
#define CUPS_SNMP_MAX_PACKET	1472	/* Maximum size of SNMP packet */
#define CUPS_SNMP_MAX_STRING	512	/* Maximum size of string */
#define CUPS_SNMP_VERSION_1	0	/* SNMPv1 */


/*
 * Types...
 */

enum cups_asn1_e			/**** ASN1 request/object types ****/
{
  CUPS_ASN1_END_OF_CONTENTS = 0x00,	/* End-of-contents */
  CUPS_ASN1_BOOLEAN = 0x01,		/* BOOLEAN */
  CUPS_ASN1_INTEGER = 0x02,		/* INTEGER or ENUMERATION */
  CUPS_ASN1_BIT_STRING = 0x03,		/* BIT STRING */
  CUPS_ASN1_OCTET_STRING = 0x04,	/* OCTET STRING */
  CUPS_ASN1_NULL_VALUE = 0x05,		/* NULL VALUE */
  CUPS_ASN1_OID = 0x06,			/* OBJECT IDENTIFIER */
  CUPS_ASN1_SEQUENCE = 0x30,		/* SEQUENCE */
  CUPS_ASN1_HEX_STRING = 0x40,		/* Binary string aka Hex-STRING */
  CUPS_ASN1_COUNTER = 0x41,		/* 32-bit unsigned aka Counter32 */
  CUPS_ASN1_GAUGE = 0x42,		/* 32-bit unsigned aka Gauge32 */
  CUPS_ASN1_TIMETICKS = 0x43,		/* 32-bit unsigned aka Timeticks32 */
  CUPS_ASN1_GET_REQUEST = 0xa0,		/* GetRequest-PDU */
  CUPS_ASN1_GET_NEXT_REQUEST = 0xa1,	/* GetNextRequest-PDU */
  CUPS_ASN1_GET_RESPONSE = 0xa2		/* GetResponse-PDU */
};
typedef enum cups_asn1_e cups_asn1_t;	/**** ASN1 request/object types ****/

struct cups_snmp_hexstring_s		/**** Hex-STRING value ****/
{
  unsigned char	bytes[CUPS_SNMP_MAX_STRING];
					/* Bytes in string */
  int		num_bytes;		/* Number of bytes */
};

union cups_snmp_value_u			/**** Object value ****/
{
  int		boolean;		/* Boolean value */
  int		integer;		/* Integer value */
  unsigned	counter;		/* Counter value */
  unsigned	gauge;			/* Gauge value */
  unsigned	timeticks;		/* Timeticks  value */
  int		oid[CUPS_SNMP_MAX_OID];	/* OID value */
  char		string[CUPS_SNMP_MAX_STRING];
					/* String value */
  struct cups_snmp_hexstring_s hex_string;
					/* Hex string value */
};

typedef struct cups_snmp_s		/**** SNMP data packet ****/
{
  const char	*error;			/* Encode/decode error */
  http_addr_t	address;		/* Source address */
  int		version;		/* Version number */
  char		community[CUPS_SNMP_MAX_STRING];
					/* Community name */
  cups_asn1_t	request_type;		/* Request type */
  int		request_id;		/* request-id value */
  int		error_status;		/* error-status value */
  int		error_index;		/* error-index value */
  int		object_name[CUPS_SNMP_MAX_OID];
					/* object-name value */
  cups_asn1_t	object_type;		/* object-value type */
  union cups_snmp_value_u
		object_value;		/* object-value value */
} cups_snmp_t;

typedef void (*cups_snmp_cb_t)(cups_snmp_t *packet, void *data);

/*
 * Prototypes...
 */

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

extern void		cupsSNMPClose(int fd) _CUPS_API_1_4;
extern int		*cupsSNMPCopyOID(int *dst, const int *src, int dstsize)
			    _CUPS_API_1_4;
extern const char	*cupsSNMPDefaultCommunity(void) _CUPS_API_1_4;
extern int		cupsSNMPIsOID(cups_snmp_t *packet, const int *oid)
			    _CUPS_API_1_4;
extern int		cupsSNMPIsOIDPrefixed(cups_snmp_t *packet,
			                      const int *prefix) _CUPS_API_1_4;
extern int		cupsSNMPOpen(int family) _CUPS_API_1_4;
extern cups_snmp_t	*cupsSNMPRead(int fd, cups_snmp_t *packet, int msec)
			    _CUPS_API_1_4;
extern void		cupsSNMPSetDebug(int level) _CUPS_API_1_4;
extern int		cupsSNMPWalk(int fd, http_addr_t *address, int version,
			             const char *community, const int *prefix,
				     int msec, cups_snmp_cb_t cb, void *data)
			    _CUPS_API_1_4;
extern int		cupsSNMPWrite(int fd, http_addr_t *address, int version,
				      const char *community,
				      cups_asn1_t request_type,
				      const unsigned request_id,
				      const int *oid) _CUPS_API_1_4;

#  ifdef __cplusplus
}
#  endif /* __cplusplus */
#endif /* !_CUPS_SNMP_H_ */


/*
 * End of "$Id$".
 */
Commit	Line	Data
91c84a35 MS	1	/*
	2	* "$Id$"
	3	*
	4	* SNMP definitions for the Common UNIX Printing System (CUPS).
	5	*
	6	* Copyright 2007-2008 by Apple Inc.
	7	* Copyright 2006-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	* "LICENSE" which should have been included with this file. If this
	13	* file is missing or damaged, see the license at "http://www.cups.org/".
	14	*
	15	* This file is subject to the Apple OS-Developed Software exception.
	16	*/
	17
	18	#ifndef _CUPS_SNMP_H_
	19	# define _CUPS_SNMP_H_
	20
	21
	22	/*
	23	* Include necessary headers.
	24	*/
	25
	26	#include "http.h"
	27
	28
	29	/*
	30	* Constants...
	31	*/
	32
	33	#define CUPS_SNMP_PORT 161 /* SNMP well-known port */
	34	#define CUPS_SNMP_MAX_OID 128 /* Maximum number of OID numbers */
	35	#define CUPS_SNMP_MAX_PACKET 1472 /* Maximum size of SNMP packet */
	36	#define CUPS_SNMP_MAX_STRING 512 /* Maximum size of string */
	37	#define CUPS_SNMP_VERSION_1 0 /* SNMPv1 */
	38
	39
	40	/*
	41	* Types...
	42	*/
	43
ac884b6a	44	enum cups_asn1_e /** ASN1 request/object types **/
91c84a35 MS	45	{
	46	CUPS_ASN1_END_OF_CONTENTS = 0x00, /* End-of-contents */
	47	CUPS_ASN1_BOOLEAN = 0x01, /* BOOLEAN */
	48	CUPS_ASN1_INTEGER = 0x02, /* INTEGER or ENUMERATION */
	49	CUPS_ASN1_BIT_STRING = 0x03, /* BIT STRING */
	50	CUPS_ASN1_OCTET_STRING = 0x04, /* OCTET STRING */
	51	CUPS_ASN1_NULL_VALUE = 0x05, /* NULL VALUE */
	52	CUPS_ASN1_OID = 0x06, /* OBJECT IDENTIFIER */
	53	CUPS_ASN1_SEQUENCE = 0x30, /* SEQUENCE */
ac884b6a	54	CUPS_ASN1_HEX_STRING = 0x40, /* Binary string aka Hex-STRING */
91c84a35 MS	55	CUPS_ASN1_COUNTER = 0x41, /* 32-bit unsigned aka Counter32 */
91c84a35 MS	56	CUPS_ASN1_GAUGE = 0x42, /* 32-bit unsigned aka Gauge32 */
ac884b6a	57	CUPS_ASN1_TIMETICKS = 0x43, /* 32-bit unsigned aka Timeticks32 */
91c84a35 MS	58	CUPS_ASN1_GET_REQUEST = 0xa0, /* GetRequest-PDU */
	59	CUPS_ASN1_GET_NEXT_REQUEST = 0xa1, /* GetNextRequest-PDU */
	60	CUPS_ASN1_GET_RESPONSE = 0xa2 /* GetResponse-PDU */
ac884b6a MS	61	};
	62	typedef enum cups_asn1_e cups_asn1_t; /** ASN1 request/object types **/
	63
	64	struct cups_snmp_hexstring_s /** Hex-STRING value **/
	65	{
	66	unsigned char bytes[CUPS_SNMP_MAX_STRING];
	67	/* Bytes in string */
	68	int num_bytes; /* Number of bytes */
	69	};
	70
	71	union cups_snmp_value_u /** Object value **/
	72	{
	73	int boolean; /* Boolean value */
	74	int integer; /* Integer value */
	75	unsigned counter; /* Counter value */
	76	unsigned gauge; /* Gauge value */
	77	unsigned timeticks; /* Timeticks value */
	78	int oid[CUPS_SNMP_MAX_OID]; /* OID value */
	79	char string[CUPS_SNMP_MAX_STRING];
	80	/* String value */
	81	struct cups_snmp_hexstring_s hex_string;
	82	/* Hex string value */
	83	};
91c84a35 MS	84
	85	typedef struct cups_snmp_s /** SNMP data packet **/
	86	{
	87	const char error; / Encode/decode error */
	88	http_addr_t address; /* Source address */
	89	int version; /* Version number */
	90	char community[CUPS_SNMP_MAX_STRING];
	91	/* Community name */
	92	cups_asn1_t request_type; /* Request type */
	93	int request_id; /* request-id value */
	94	int error_status; /* error-status value */
	95	int error_index; /* error-index value */
	96	int object_name[CUPS_SNMP_MAX_OID];
	97	/* object-name value */
	98	cups_asn1_t object_type; /* object-value type */
ac884b6a MS	99	union cups_snmp_value_u
ac884b6a MS	100	object_value; /* object-value value */
91c84a35 MS	101	} cups_snmp_t;
91c84a35 MS	102
ac884b6a	103	typedef void (cups_snmp_cb_t)(cups_snmp_t packet, void *data);
91c84a35 MS	104
	105	/*
	106	* Prototypes...
	107	*/
	108
	109	# ifdef __cplusplus
	110	extern "C" {
	111	# endif /* __cplusplus */
	112
	113	extern void cupsSNMPClose(int fd) _CUPS_API_1_4;
	114	extern int cupsSNMPCopyOID(int dst, const int *src, int dstsize)
	115	_CUPS_API_1_4;
ac884b6a	116	extern const char *cupsSNMPDefaultCommunity(void) _CUPS_API_1_4;
91c84a35 MS	117	extern int cupsSNMPIsOID(cups_snmp_t packet, const int oid)
	118	_CUPS_API_1_4;
	119	extern int cupsSNMPIsOIDPrefixed(cups_snmp_t *packet,
	120	const int *prefix) _CUPS_API_1_4;
ac884b6a	121	extern int cupsSNMPOpen(int family) _CUPS_API_1_4;
91c84a35 MS	122	extern cups_snmp_t cupsSNMPRead(int fd, cups_snmp_t packet, int msec)
	123	_CUPS_API_1_4;
	124	extern void cupsSNMPSetDebug(int level) _CUPS_API_1_4;
ac884b6a MS	125	extern int cupsSNMPWalk(int fd, http_addr_t *address, int version,
	126	const char community, const int prefix,
	127	int msec, cups_snmp_cb_t cb, void *data)
	128	_CUPS_API_1_4;
	129	extern int cupsSNMPWrite(int fd, http_addr_t *address, int version,
91c84a35 MS	130	const char *community,
	131	cups_asn1_t request_type,
	132	const unsigned request_id,
	133	const int *oid) _CUPS_API_1_4;
	134
	135	# ifdef __cplusplus
	136	}
	137	# endif /* __cplusplus */
	138	#endif /* !_CUPS_SNMP_H_ */
	139
	140
	141	/*
	142	* End of "$Id$".
	143	*/