1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
/*
* src/lib/krb5/asn.1/asn1_decode.h
*
* Copyright 1994 by the Massachusetts Institute of Technology.
* All Rights Reserved.
*
* Export of this software from the United States of America may
* require a specific license from the United States Government.
* It is the responsibility of any person or organization contemplating
* export to obtain such a license before exporting.
*
* WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
* distribute this software and its documentation for any purpose and
* without fee is hereby granted, provided that the above copyright
* notice appear in all copies and that both that copyright notice and
* this permission notice appear in supporting documentation, and that
* the name of M.I.T. not be used in advertising or publicity pertaining
* to distribution of the software without specific, written prior
* permission. Furthermore if you modify this software you must label
* your software as modified software and not distribute it in such a
* fashion that it might be confused with the original M.I.T. software.
* M.I.T. makes no representations about the suitability of
* this software for any purpose. It is provided "as is" without express
* or implied warranty.
*/
#ifndef __ASN1_DECODE_H__
#define __ASN1_DECODE_H__
#include "k5-int.h"
#include "krbasn1.h"
#include "asn1buf.h"
/*
Overview
These procedures take an asn1buf whose current position points
to the beginning of an ASN.1 primitive (<id><length><contents>).
The primitive is removed from the buffer and decoded.
Operations
asn1_decode_integer
asn1_decode_unsigned_integer
asn1_decode_octetstring
asn1_decode_charstring
asn1_decode_generalstring
asn1_decode_null
asn1_decode_printablestring
asn1_decode_ia5string
asn1_decode_generaltime
*/
/* asn1_error_code asn1_decode_type(asn1buf *buf, ctype *val); */
/* requires *buf is allocated
modifies *buf, *len
effects Decodes the octet string in *buf into *val.
Returns ENOMEM if memory is exhausted.
Returns asn1 errors. */
asn1_error_code asn1_decode_integer
(asn1buf *buf, long *val);
asn1_error_code asn1_decode_unsigned_integer
(asn1buf *buf, unsigned long *val);
asn1_error_code asn1_decode_null
(asn1buf *buf);
asn1_error_code asn1_decode_octetstring
(asn1buf *buf, unsigned int *retlen, asn1_octet **val);
asn1_error_code asn1_decode_generalstring
(asn1buf *buf, unsigned int *retlen, char **val);
asn1_error_code asn1_decode_charstring
(asn1buf *buf, unsigned int *retlen, char **val);
/* Note: A charstring is a special hack to account for the fact that
krb5 structures store some OCTET STRING values in krb5_octet
arrays and others in krb5_data structures
(which use char arrays).
From the ASN.1 point of view, the two string types are the same,
only the receptacles differ. */
asn1_error_code asn1_decode_printablestring
(asn1buf *buf, int *retlen, char **val);
asn1_error_code asn1_decode_ia5string
(asn1buf *buf, int *retlen, char **val);
asn1_error_code asn1_decode_generaltime
(asn1buf *buf, time_t *val);
#endif
|