RSA BSAFE Micro Edition Suite	Streamlined security for mobile and embedded devices

---

r_cert_req.h

Go to the documentation of this file.

/* $Id: r_cert_req.h,v 1.60 2005/06/27 01:51:40 jmckee Exp $ */
/*
 * Copyright (C) 1998-2003 RSA Security Inc. All rights reserved.
 *
 * This work contains proprietary information of RSA Security.
 * Distribution is limited to authorized licensees of RSA
 * Security. Any unauthorized reproduction, distribution or
 * modification of this work is strictly prohibited.
 */

#ifndef HEADER_COMMON_CERT_R_CERT_REQ_H
#define HEADER_COMMON_CERT_R_CERT_REQ_H

#ifdef  __cplusplus
extern "C" {
#endif

#ifndef NO_BIO
#include "bio.h"
#endif /* !NO_BIO */
#include "r_format.h"
#include "r_cert.h"

/*
 * Exported macro constants
 */

#define R_CERT_REQ_CTX_INFO_R_LIB_CTX       R_CERT_CTX_INFO_R_LIB_CTX

#define R_CERT_REQ_CTX_INFO_CERT_REQ_TYPE   R_CERT_CTX_INFO_CERT_TYPE

#define R_CERT_REQ_CTX_INFO_R_CR_CTX        R_CERT_CTX_INFO_R_CR_CTX

#define R_CERT_REQ_CTX_INFO_R_PKEY_CTX      R_CERT_CTX_INFO_R_PKEY_CTX

#define R_CERT_REQ_TYPE_PKCS10           10

#define R_CERT_REQ_INFO_VERSION                PK_CERT_VER

#define R_CERT_REQ_INFO_SUBJECT                PK_CERT_SUBJECT

#define R_CERT_REQ_INFO_PUBLIC_KEY             PK_CERT_PUBKEY

#define R_CERT_REQ_INFO_ATTRIBUTES             PK_CERT_REQ_ATTRIBUTES

#define R_CERT_REQ_INFO_TO_BE_SIGNED           PK_CERT_BODY

#define R_CERT_REQ_INFO_SIGNATURE              PK_CERT_SIGNATURE

#define R_CERT_REQ_INFO_ALL                    R_CERT_INFO_ALL

#define R_CERT_REQ_INFO_TYPE                   R_CERT_INFO_TYPE

#define R_CERT_REQ_INFO_R_CERT_REQ_CTX         R_CERT_INFO_R_CERT_CTX

#define R_CERT_REQ_INFO_VERSION_STRING         R_CERT_INFO_VERSION_STRING

#define R_CERT_REQ_INFO_SIGNATURE_TYPE         R_CERT_INFO_SIGNATURE_TYPE

#define R_CERT_REQ_INFO_SIGNATURE_DIGEST_TYPE  R_CERT_INFO_SIGNATURE_DIGEST_TYPE

#define R_CERT_REQ_INFO_R_PKEY                 R_CERT_INFO_R_PKEY

#define R_CERT_REQ_INFO_SUBJECT_R_CERT_NAME    R_CERT_INFO_SUBJECT_R_CERT_NAME

#define R_CERT_REQ_INFO_PARAMETERS            R_CERT_INFO_PARAMETERS

#define R_CERT_REQ_INFO_KEY_USAGE_INT         R_CERT_INFO_KEY_USAGE_INT

#define R_CERT_REQ_FLAG_DEFAULT          0x0000

#define R_CERT_REQ_FLAG_COPY_DATA        0x0000

#define R_CERT_REQ_FLAG_BY_REFERENCE     0x0001

/* Indicates that the request is binary encoded. */
#define R_CERT_REQ_FORMAT_BINARY            R_FORMAT_BINARY

/* Indicates that the request is text format encoded. */
#define R_CERT_REQ_FORMAT_TEXT              R_FORMAT_TEXT

/* Indicates that the request is Privacy Enhanced Mail (PEM) encoded. */
#define R_CERT_REQ_FORMAT_PEM               R_FORMAT_PEM

/* Indicates that the request is in a C code function format. */
#define R_CERT_REQ_FORMAT_CODE_BINARY       R_FORMAT_CODE_BINARY

/* Indicates that the request is in a C code fields format. */
#define R_CERT_REQ_FORMAT_CODE_FIELDS       R_FORMAT_CODE_FIELDS

/* Indicates that the request is in a C code data format. */
#define R_CERT_REQ_FORMAT_CODE_HEX          R_FORMAT_CODE_HEX

/* Indicates that the request is in a plain hexadecimal Bytes format. */
#define R_CERT_REQ_FORMAT_HEX               R_FORMAT_HEX

/* Backwards compatibility macro for R_CERT_REQ_FORMAT_from_string */
#define R_CERT_REQ_FORMAT_from_string(str, fmt)       \
    R_FORMAT_from_string((str), (fmt))

/* Backwards compatibility macro for R_CERT_REQ_FORMAT_to_string */
#define R_CERT_REQ_FORMAT_to_string(fmt, max, str)    \
    R_FORMAT_to_string((fmt), (max), (str))

/*
 * Exported types
 */

typedef struct r_cert_ctx_st    R_CERT_REQ_CTX;

typedef struct r_cert_st        R_CERT_REQ;

typedef int R_CERT_REQ_TYPE;

typedef int R_CERT_REQ_INFO;

typedef int R_CERT_REQ_CTX_INFO;

typedef int R_CERT_REQ_FLAG;

#if defined(Rm_CERT_TABLE) || defined(Rm_CERT_DIRECT)

/* Only include the extension header when building a small application */
#include "rx_cert_req.h"

#endif /* defined(Rm_CERT_TABLE) || defined(rm_CERT_DIRECT) */

#ifndef Rm_CERT_DIRECT

int R_CDECL R_CERT_REQ_CTX_new(R_LIB_CTX *lib_ctx, R_RES_FLAG flag,
    R_CERT_REQ_TYPE type, R_CERT_REQ_CTX **req_ctx);

#endif /* Rm_CERT_DIRECT */


#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_CTX_free(req_ctx) \
    R_CERT_CTX_free(req_ctx)
#endif /* Rm_CERT_DIRECT */

#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_CTX_get_info(req_ctx, info_id, value) \
    R_CERT_CTX_get_info((req_ctx), (info_id), (value))
#endif /* Rm_CERT_DIRECT */


#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_CTX_set_info(req_ctx, info_id, value) \
    R_CERT_CTX_set_info((req_ctx), (info_id), (value))
#endif /* Rm_CERT_DIRECT */

#ifndef NO_BIO
typedef int  R_CDECL R_CERT_REQ_PRINT_FUNC_T(BIO *bio, R_CERT_REQ *req,
    R_FORMAT format, char *format_arg);
#else
typedef int  R_CDECL R_CERT_REQ_PRINT_FUNC_T(void *bio, R_CERT_REQ *req,
    R_FORMAT format, char *format_arg);
#endif


#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_new(req_ctx, type, req) \
    R_CERT_new(req_ctx, type, req)
#endif /* Rm_CERT_DIRECT */


#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_free(req)        R_CERT_free(req)
#endif /* Rm_CERT_DIRECT */


#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_from_binary(req_ctx, flag, type, max_buf_len, buf, \
                               consumed_len, req) \
    R_CERT_from_binary(req_ctx, flag, type, max_buf_len, buf, consumed_len, req)
#endif /* Rm_CERT_DIRECT */


#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_to_binary(req, max_buf_len, buf, out_len) \
    R_CERT_to_binary(req, max_buf_len, buf, out_len)
#endif /* Rm_CERT_DIRECT */


#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_inc_reference(req)    R_CERT_inc_reference(req)
#endif /* Rm_CERT_DIRECT */


#define R_CERT_REQ_subject_name_to_string(req, max_str_len, str) \
    R_CERT_subject_name_to_string(req, max_str_len, str)

#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_public_key_to_R_PKEY(req, flag, pkey) \
    R_CERT_public_key_to_R_PKEY(req, flag, pkey)
#endif /* Rm_CERT_DIRECT */


/*
 * the get_*_info functions return references to the underlying binary
 * data for use by those routines that do not need to pull apart the
 * certificates in order to work with them and can simple extract the
 * mandatory pieces to work with
 *
 */

#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_get_info(req, info_id, value) \
    R_CERT_get_info(req, info_id, value)
#endif /* Rm_CERT_DIRECT */


#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_set_info(req, info_id, value) \
    R_CERT_set_info(req, info_id, value)
#endif /* Rm_CERT_DIRECT */


#define R_CERT_REQ_subject_name_to_R_CERT_NAME(req, flag, subject) \
    R_CERT_subject_name_to_R_CERT_NAME(req, flag, subject)

/* Crypto-related functions */

#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_verify(req, pkey, verified) \
    R_CERT_verify(req, pkey, verified)
#endif /* Rm_CERT_DIRECT */


#ifndef Rm_CERT_DIRECT

#define R_CERT_REQ_sign(req, pkey, sign_type) \
    R_CERT_sign(req, pkey, sign_type)
#endif /* Rm_CERT_DIRECT */

#define R_CERT_REQ_fingerprint(req, md_type, max_buf_len, buf, out_len) \
    R_CERT_fingerprint(req, md_type, max_buf_len, buf, out_len)

#ifndef Rm_CERT_DIRECT
#ifndef NO_BIO
int R_CDECL R_CERT_REQ_print(R_CERT_REQ *req, R_FORMAT format, char *format_arg,
    BIO *bio);
#endif /* NO_BIO */
#endif /* Rm_CERT_DIRECT */

int R_CDECL R_CERT_to_R_CERT_REQ(R_CERT *cert, R_CERT_REQ_CTX *ctx,
                         R_CERT_REQ_TYPE type, R_CERT_REQ **req);

int R_CDECL R_CERT_REQ_to_R_CERT(R_CERT_REQ *req, R_CERT_CTX *ctx, R_CERT_TYPE type,
                         R_CERT **cert);

int R_CDECL R_CERT_REQ_TYPE_from_string(char *str, R_CERT_REQ_TYPE *type);
int R_CDECL R_CERT_REQ_TYPE_to_string(R_CERT_REQ_TYPE type, unsigned int max_str_len,
                              char *str);
int R_CDECL R_CERT_REQ_TYPE_to_PEM_header(R_CERT_REQ_TYPE type,
                         unsigned int max_str_len, char *str);

#ifndef NO_BIO
int R_CDECL R_CERT_REQ_read(R_CERT_REQ_CTX *ctx, BIO *bio, R_CERT_REQ_TYPE type,
                    R_FORMAT format, R_CERT_REQ **req);
#endif /* !NO_BIO */
int R_CDECL R_CERT_REQ_read_file(R_CERT_REQ_CTX *ctx, char *filename,
                         R_CERT_REQ_TYPE type, R_FORMAT format,
                         R_CERT_REQ **req);
#ifndef NO_BIO
int R_CDECL R_CERT_REQ_write(R_CERT_REQ *req, BIO *bio, R_FORMAT format,
                     void *format_arg);
#endif /* !NO_BIO */
int R_CDECL R_CERT_REQ_write_file(R_CERT_REQ *req, char *filename,
                          R_FORMAT format, void *format_arg);

#ifdef  __cplusplus
}
#endif

#endif /* HEADER_COMMON_CERT_R_CERT_REQ_H */

---

Copyright (c) 1999-2005 RSA Security Inc. All rights reserved. 072-001001-2100-001-000 - 2.1