* main.h, keylist.c (print_subpackets_colon): Make a public function.
[gnupg.git] / g10 / tlv.h
1 /* tlv.h - Tag-Length-Value Utilities
2  *      Copyright (C) 2004 Free Software Foundation, Inc.
3  *
4  * This file is part of GnuPG.
5  *
6  * GnuPG is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * GnuPG is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
19  */
20
21 #ifndef SCD_TLV_H
22 #define SCD_TLV_H 1
23
24 #include "types.h"
25 #include "cardglue.h"
26
27 enum tlv_tag_class {
28   CLASS_UNIVERSAL = 0,
29   CLASS_APPLICATION = 1,
30   CLASS_CONTEXT = 2,
31   CLASS_PRIVATE =3
32 };
33
34 enum tlv_tag_type {
35   TAG_NONE = 0,
36   TAG_BOOLEAN = 1,
37   TAG_INTEGER = 2,
38   TAG_BIT_STRING = 3,
39   TAG_OCTET_STRING = 4,
40   TAG_NULL = 5,
41   TAG_OBJECT_ID = 6,
42   TAG_OBJECT_DESCRIPTOR = 7,
43   TAG_EXTERNAL = 8,
44   TAG_REAL = 9,
45   TAG_ENUMERATED = 10,
46   TAG_EMBEDDED_PDV = 11,
47   TAG_UTF8_STRING = 12,
48   TAG_REALTIVE_OID = 13,
49   TAG_SEQUENCE = 16,
50   TAG_SET = 17,
51   TAG_NUMERIC_STRING = 18,
52   TAG_PRINTABLE_STRING = 19,
53   TAG_TELETEX_STRING = 20,
54   TAG_VIDEOTEX_STRING = 21,
55   TAG_IA5_STRING = 22,
56   TAG_UTC_TIME = 23,
57   TAG_GENERALIZED_TIME = 24,
58   TAG_GRAPHIC_STRING = 25,
59   TAG_VISIBLE_STRING = 26,
60   TAG_GENERAL_STRING = 27,
61   TAG_UNIVERSAL_STRING = 28,
62   TAG_CHARACTER_STRING = 29,
63   TAG_BMP_STRING = 30
64 };
65
66
67
68 /* Locate a TLV encoded data object in BUFFER of LENGTH and return a
69    pointer to value as well as its length in NBYTES.  Return NULL if
70    it was not found.  Note, that the function does not check whether
71    the value fits into the provided buffer.*/
72 const unsigned char *find_tlv (const unsigned char *buffer, size_t length,
73                                int tag, size_t *nbytes);
74
75
76 /* ASN.1 BER parser: Parse BUFFER of length SIZE and return the tag
77    and the length part from the TLV triplet.  Update BUFFER and SIZE
78    on success. */
79 gpg_error_t parse_ber_header (unsigned char const **buffer, size_t *size,
80                               int *r_class, int *r_tag, 
81                               int *r_constructed,
82                               int *r_ndef, size_t *r_length, size_t *r_nhdr);
83
84
85
86 #endif /* SCD_TLV_H */