forked from osmocom/wireshark
![Guy Harris](/assets/img/avatar_default.png)
they have LF at the end of the line on UN*X and CR/LF on Windows; hopefully this means that if a CR/LF version is checked in on Windows, the CRs will be stripped so that they show up only when checked out on Windows, not on UN*X. svn path=/trunk/; revision=11400
151 lines
6.4 KiB
C
151 lines
6.4 KiB
C
/* asn1.h
|
|
* Definitions for ASN.1 BER dissection
|
|
*
|
|
* $Id$
|
|
*
|
|
* Ethereal - Network traffic analyzer
|
|
* By Gerald Combs <gerald@ethereal.com>
|
|
*
|
|
* Based on "g_asn1.h" from:
|
|
*
|
|
* GXSNMP -- An snmp mangament application
|
|
* Copyright (C) 1998 Gregory McLean & Jochen Friedrich
|
|
* Beholder RMON ethernet network monitor,Copyright (C) 1993 DNPAP group
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
*
|
|
*/
|
|
#ifndef __ASN1_H__
|
|
#define __ASN1_H__
|
|
|
|
#define ASN1_UNI 0 /* Universal */
|
|
#define ASN1_APL 1 /* Application */
|
|
#define ASN1_CTX 2 /* Context */
|
|
#define ASN1_PRV 3 /* Private */
|
|
|
|
/* Tag */
|
|
#define ASN1_EOC 0 /* End Of Contents */
|
|
#define ASN1_BOL 1 /* Boolean */
|
|
#define ASN1_INT 2 /* Integer */
|
|
#define ASN1_BTS 3 /* Bit String */
|
|
#define ASN1_OTS 4 /* Octet String */
|
|
#define ASN1_NUL 5 /* Null */
|
|
#define ASN1_OJI 6 /* Object Identifier */
|
|
#define ASN1_OJD 7 /* Object Description */
|
|
#define ASN1_EXT 8 /* External */
|
|
#define ASN1_REAL 9 /* Real */
|
|
#define ASN1_ENUM 10 /* Enumerated */
|
|
#define ASN1_SEQ 16 /* Sequence */
|
|
#define ASN1_SET 17 /* Set */
|
|
#define ASN1_NUMSTR 18 /* Numerical String */
|
|
#define ASN1_PRNSTR 19 /* Printable String */
|
|
#define ASN1_TEXSTR 20 /* Teletext String */
|
|
#define ASN1_VIDSTR 21 /* Video String */
|
|
#define ASN1_IA5STR 22 /* IA5 String */
|
|
#define ASN1_UNITIM 23 /* Universal Time */
|
|
#define ASN1_GENTIM 24 /* General Time */
|
|
#define ASN1_GRASTR 25 /* Graphical String */
|
|
#define ASN1_VISSTR 26 /* Visible String */
|
|
#define ASN1_GENSTR 27 /* General String */
|
|
|
|
/* Primitive / Constructed */
|
|
#define ASN1_PRI 0 /* Primitive */
|
|
#define ASN1_CON 1 /* Constructed */
|
|
|
|
/*
|
|
* Oh, this is hellish.
|
|
*
|
|
* The CMU SNMP library defines an OID as a sequence of "u_int"s,
|
|
* unless EIGHTBIT_SUBIDS is defined, in which case it defines
|
|
* an OID as a sequence of "u_char"s. None of its header files
|
|
* define EIGHTBIT_SUBIDS, and if a program defines it, that's
|
|
* not going to change the library to treat OIDs as sequences
|
|
* of "u_chars", so I'll assume that it'll be "u_int"s.
|
|
*
|
|
* The UCD SNMP library does the same, except it defines an OID
|
|
* as a sequence of "u_long"s, by default.
|
|
*
|
|
* "libsmi" defines it as a sequence of "unsigned int"s.
|
|
*
|
|
* I don't want to oblige all users of ASN.1 to include the SNMP
|
|
* library header files, so I'll assume none of the SNMP libraries
|
|
* will rudely surprise me by changing the definition; if they
|
|
* do, there will be compiler warnings, so we'll at least be able
|
|
* to catch it.
|
|
*
|
|
* This requires that, if you're going to use "asn1_subid_decode()",
|
|
* "asn1_oid_value_decode()", or "asn1_oid_decode()", you include
|
|
* "config.h", to get the right #defines defined, so that we properly
|
|
* typedef "subid_t".
|
|
*/
|
|
#if defined(HAVE_SOME_SNMP)
|
|
typedef gulong subid_t; /* Net-SNMP or UCD SNMP */
|
|
#else
|
|
typedef guint subid_t; /* CMU SNMP, libsmi, or nothing */
|
|
#endif
|
|
|
|
#define ASN1_ERR_NOERROR 0 /* no error */
|
|
#define ASN1_ERR_EOC_MISMATCH 1
|
|
#define ASN1_ERR_WRONG_TYPE 2 /* type not right */
|
|
#define ASN1_ERR_LENGTH_NOT_DEFINITE 3 /* length should be definite */
|
|
#define ASN1_ERR_LENGTH_MISMATCH 4
|
|
#define ASN1_ERR_WRONG_LENGTH_FOR_TYPE 5 /* length wrong for type */
|
|
|
|
typedef struct _ASN1_SCK ASN1_SCK;
|
|
|
|
struct _ASN1_SCK
|
|
{ /* ASN1 socket */
|
|
tvbuff_t *tvb; /* Tvbuff whence the data comes */
|
|
int offset; /* Current offset in tvbuff */
|
|
};
|
|
|
|
extern void asn1_open (ASN1_SCK *asn1, tvbuff_t *tvb, int offset);
|
|
extern void asn1_close (ASN1_SCK *asn1, int *offset);
|
|
extern int asn1_octet_decode (ASN1_SCK *asn1, guchar *ch);
|
|
extern int asn1_tag_decode (ASN1_SCK *asn1, guint *tag);
|
|
extern int asn1_id_decode (ASN1_SCK *asn1, guint *cls, guint *con, guint *tag);
|
|
extern int asn1_id_decode1 (ASN1_SCK *asn1, guint *tag);
|
|
extern int asn1_length_decode (ASN1_SCK *asn1, gboolean *def, guint *len);
|
|
extern int asn1_header_decode(ASN1_SCK *asn1, guint *cls, guint *con,
|
|
guint *tag, gboolean *defp, guint *lenp);
|
|
extern int asn1_eoc (ASN1_SCK *asn1, int eoc);
|
|
extern int asn1_eoc_decode (ASN1_SCK *asn1, int eoc);
|
|
extern int asn1_null_decode (ASN1_SCK *asn1, int enc_len);
|
|
extern int asn1_bool_decode (ASN1_SCK *asn1, int enc_len, gboolean *boolean);
|
|
extern int asn1_int32_value_decode (ASN1_SCK *asn1, int enc_len,
|
|
gint32 *integer);
|
|
extern int asn1_int32_decode (ASN1_SCK *asn1, gint32 *integer, guint *nbytes);
|
|
extern int asn1_uint32_value_decode (ASN1_SCK *asn1, int enc_len,
|
|
guint32 *integer);
|
|
extern int asn1_uint32_decode (ASN1_SCK *asn1, guint32 *integer, guint *nbytes);
|
|
extern int asn1_bits_decode (ASN1_SCK *asn1, int enc_len, guchar **bits,
|
|
guint *len, guchar *unused);
|
|
extern int asn1_string_value_decode (ASN1_SCK *asn1, int enc_len,
|
|
guchar **octets);
|
|
extern int asn1_string_decode (ASN1_SCK *asn1, guchar **octets, guint *str_len,
|
|
guint *nbytes, guint expected_tag);
|
|
extern int asn1_octet_string_decode (ASN1_SCK *asn1, guchar **octets,
|
|
guint *str_len, guint *nbytes);
|
|
extern int asn1_subid_decode (ASN1_SCK *asn1, subid_t *subid);
|
|
extern int asn1_oid_value_decode (ASN1_SCK *asn1, int enc_len, subid_t **oid,
|
|
guint *len);
|
|
extern int asn1_oid_decode (ASN1_SCK *asn1, subid_t **oid, guint *len,
|
|
guint *nbytes);
|
|
extern int asn1_sequence_decode (ASN1_SCK *asn1, guint *seq_len, guint *nbytes);
|
|
|
|
extern char *asn1_err_to_str (int err);
|
|
|
|
#endif
|