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
89
90
91
|
/* -*- mode: c; c-basic-offset: 4; indent-tabs-mode: nil -*- */
/* 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_boolean(asn1buf *buf, unsigned int *val);
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_maybe_unsigned(asn1buf *buf, unsigned long *val);
asn1_error_code asn1_decode_null(asn1buf *buf);
asn1_error_code asn1_decode_oid(asn1buf *buf, unsigned int *retlen,
asn1_octet **val);
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
|