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

---

r_time.h

Go to the documentation of this file.

/* $Id: r_time.h,v 1.54 2005/08/10 00:14:56 itaylor 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_R_TIME_H
#define HEADER_COMMON_R_TIME_H

#ifdef  __cplusplus
extern "C" {
#endif

#include "r_com.h"

typedef union r_time_t_st R_TIME_T;
union r_time_t_st {
        struct r_secs_st{
                R_INT32 high; /* high 32 bits */
                R_UINT32 low; /* low 32 bits */
                R_UINT32 nano;
        } secs;
        R_INT32 force_align;
        unsigned char bytes[sizeof(R_INT32)*3];
};

#ifdef CT_INT32
#undef CT_INT32
#endif
#ifdef CT_UINT32
#undef CT_UINT32
#endif
#define CT_INT32            R_INT32
#define CT_UINT32           R_UINT32

#define CRYPTO_TIME_T           R_TIME_T

#define CRYPTO_time         R_time
#define CRYPTO_time_offset      R_time_offset
#define CRYPTO_time_export      R_time_export
#define CRYPTO_time_import      R_time_import
#define CRYPTO_time_cmp         R_time_cmp

#define CRYPTO_time_to_int              R_time_to_int
#define CRYPTO_time_from_int            R_time_from_int

#define CRYPTO_get_time_cb      R_time_get_func
#define CRYPTO_set_time_cb      R_time_set_func

#define CRYPTO_get_time_offset_cb   R_time_get_offset_func
#define CRYPTO_set_time_offset_cb   R_time_set_offset_func

#define CRYPTO_get_time_cmp_cb      R_time_get_cmp_func
#define CRYPTO_set_time_cmp_cb      R_time_set_cmp_func

#define CRYPTO_get_time_import_cb   R_time_get_import_func
#define CRYPTO_set_time_import_cb   R_time_set_import_func

#define CRYPTO_get_time_export_cb   R_time_get_export_func
#define CRYPTO_set_time_export_cb   R_time_set_export_func

#define R_TIME_FMT_UTC              23

#define R_TIME_FMT_GENERALIZEDTIME  24

#define R_TIME_FMT_BIGENDIAN        3

#define R_TIME_LEN_UTC          (13+1)

#define R_TIME_LEN_UTC                  (13+1)
#define R_TIME_LEN_GENERALIZEDTIME      (20+1)
#define R_TIME_LEN_BIGENDIAN            (sizeof(R_INT32)*2)

#define R_TIME_MIN_UTC          "500101000000Z"

#define R_TIME_MAX_UTC          "491231235959Z"

#define R_TIME_NAN_UTC          "000000000000Z"

#define R_TIME_MIN_GENERALIZEDTIME  "00000101000000.0Z"

#define R_TIME_MAX_GENERALIZEDTIME  "99991231235959.9Z"

#define R_TIME_NAN_GENERALIZEDTIME  "00000000000000.0Z"

#define CRYPTO_FMT_UTC          R_TIME_FMT_UTC
#define CRYPTO_FMT_GENERALIZEDTIME  R_TIME_FMT_GENERALIZEDTIME
#define CRYPTO_FMT_BIGENDIAN        R_TIME_FMT_BIGENDIAN

#define CRYPTO_LEN_UTC          R_TIME_LEN_UTC
#define CRYPTO_LEN_GENERALIZEDTIME  R_TIME_LEN_GENERALIZEDTIME
#define CRYPTO_LEN_BIGENDIAN        R_TIME_LEN_BIGENDIAN

#define CRYPTO_MIN_UTC          R_TIME_MIN_UTC
#define CRYPTO_MAX_UTC          R_TIME_MAX_UTC
#define CRYPTO_NAN_UTC          R_TIME_NAN_UTC
#define CRYPTO_MIN_GENERALIZEDTIME  R_TIME_MIN_GENERALIZEDTIME
#define CRYPTO_MAX_GENERALIZEDTIME  R_TIME_MAX_GENERALIZEDTIME
#define CRYPTO_NAN_GENERALIZEDTIME  R_TIME_NAN_GENERALIZEDTIME


typedef int  R_CDECL R_TIME_CMP_FUNC_T(R_TIME_T *tm1, R_TIME_T *tm2);

typedef int  R_CDECL R_TIME_EXPORT_FUNC_T(R_TIME_T *tm, int format, char *buffer,
    int buf_len);

typedef R_TIME_T  * R_CDECL R_TIME_FUNC_T(R_TIME_T *tm);

typedef int  R_CDECL R_TIME_IMPORT_FUNC_T(char *buffer, int buf_len,
            int format, R_TIME_T *tm);

typedef R_TIME_T  * R_CDECL R_TIME_OFFSET_FUNC_T(R_TIME_T *ret, R_TIME_T *tm,
    R_INT32 secs_offset, R_INT32 nano_offset);

/*
 * @defgroup TIME_FUNCS R_time Functions
 * This section outlines the functions that facilitate time management.
 * @ingroup R_TIME_FUNC_MAIN
 * @{
 */

int R_CDECL R_time_size(void);

R_TIME_T * R_CDECL R_time_new(void);
void R_CDECL R_time_free(R_TIME_T *tm);

R_TIME_T * R_CDECL R_time(R_TIME_T *tm);
R_TIME_FUNC_T * R_CDECL R_time_get_func(void);
void R_CDECL R_time_set_func(R_TIME_FUNC_T *func);

R_TIME_T * R_CDECL R_time_offset(R_TIME_T *ret, R_TIME_T *tm,
    R_INT32 secs_offset, R_INT32 nano_offset);
R_TIME_OFFSET_FUNC_T * R_CDECL R_time_get_offset_func(void);
void R_CDECL R_time_set_offset_func(R_TIME_OFFSET_FUNC_T *func);

int R_CDECL R_time_from_int(R_TIME_T *tm, int i);
int R_CDECL R_time_to_int(R_TIME_T *tm);

int R_CDECL R_time_cmp(R_TIME_T *tm1, R_TIME_T *tm2);
R_TIME_CMP_FUNC_T * R_CDECL R_time_get_cmp_func(void);
void R_CDECL R_time_set_cmp_func(R_TIME_CMP_FUNC_T *func);

int R_CDECL R_time_import(char *buffer, int buf_len, int format, R_TIME_T *tm);
R_TIME_IMPORT_FUNC_T * R_CDECL R_time_get_import_func(void);
void R_CDECL R_time_set_import_func(R_TIME_IMPORT_FUNC_T *func);

int R_CDECL R_time_export(R_TIME_T *tm, int format, char *buffer, int buf_len);
R_TIME_EXPORT_FUNC_T * R_CDECL R_time_get_export_func(void);
void R_CDECL R_time_set_export_func(R_TIME_EXPORT_FUNC_T *func);

/*
 * @}
 */

#ifdef __cplusplus
}
#endif
#endif /* HEADER_COMMON_R_TIME_H */

---

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