/* -*- mode: c; c-basic-offset: 4; indent-tabs-mode: nil -*- */
/*
* 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_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