head	1.4;
access;
symbols
	LMTP2NNTP_1_4_0:1.1.1.1
	LMTP2NNTP_1_3_0:1.4
	LMTP2NNTP_1_3b2:1.4
	LMTP2NNTP_1_3b1:1.4
	LMTP2NNTP_1_3a3:1.4
	LMTP2NNTP_1_3a2:1.4
	LMTP2NNTP_1_3a1:1.4
	LMTP2NNTP_1_2_0:1.3
	LMTP2NNTP_1_2b4:1.3
	LMTP2NNTP_1_2b3:1.3
	LMTP2NNTP_1_2b2:1.3
	LMTP2NNTP_1_2b1:1.3
	LMTP2NNTP_1_2a8:1.3
	LMTP2NNTP_1_2a7:1.3
	LMTP2NNTP_1_2a6:1.3
	LMTP2NNTP_1_2a5:1.2
	TAI_0_0_0:1.1.1.1
	VENDOR:1.1.1;
locks; strict;
comment	@ * @;


1.4
date	2003.03.23.18.00.29;	author rse;	state Exp;
branches;
next	1.3;

1.3
date	2002.06.29.12.19.46;	author rse;	state Exp;
branches;
next	1.2;

1.2
date	2002.05.29.08.32.53;	author thl;	state Exp;
branches;
next	1.1;

1.1
date	2002.04.18.09.10.46;	author rse;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	2002.04.18.09.10.46;	author rse;	state Exp;
branches;
next	;


desc
@@


1.4
log
@bump copyright year
@
text
@/*
**  OSSP tai - Time Handling
**  Copyright (c) 2002-2003 Ralf S. Engelschall <rse@@engelschall.com>
**  Copyright (c) 2002-2003 The OSSP Project <http://www.ossp.org/>
**  Copyright (c) 2002-2003 Cable & Wireless Deutschland <http://www.cw.com/de/>
**
**  This file is part of OSSP tai, a time handling library
**  which can be found at http://www.ossp.org/pkg/lib/tai/.
**
**  Permission to use, copy, modify, and distribute this software for
**  any purpose with or without fee is hereby granted, provided that
**  the above copyright notice and this permission notice appear in all
**  copies.
**
**  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
**  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
**  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
**  IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
**  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
**  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
**  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
**  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
**  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
**  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
**  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
**  SUCH DAMAGE.
**
**  tai.h: public API
*/

#ifndef __TAI_H__
#define __TAI_H__

#include <time.h> /* time_t, struct tm */

typedef enum {
    TAI_OK = 0, /* also used for TRUE */
    TAI_FALSE,
    TAI_ERR_ARG,
    TAI_ERR_USE,
    TAI_ERR_OVF,
    TAI_ERR_FMT,
    TAI_ERR_PRS,
    TAI_ERR_SYS,
    TAI_ERR_IMP
} tai_rc_t;

typedef struct {
    int           sign;
    unsigned long  sec;
    unsigned long nsec;
    unsigned long asec;
} tai_offset_t;

typedef struct {
    char bytes[16];
} tai_packed_t;

typedef enum {
    /* lossless types */
    TAI_TYPE_TMT,       /* tai_t */
    TAI_TYPE_PACKED,    /* tai_packed_t (128 bit in 16 bytes network byte order) */
    /* looser types */
    TAI_TYPE_OFFSET,    /* tai_off_t */
    TAI_TYPE_SECONDS,   /* unsigned long */
    TAI_TYPE_NSECONDS,  /* unsigned long */
    TAI_TYPE_ASECONDS,  /* unsigned long */
    TAI_TYPE_TIMET,     /* time_t */
    TAI_TYPE_STRUCTTM,  /* struct tm */
    TAI_TYPE_STRUCTTV,  /* struct timeval */
    /* only import */
    TAI_TYPE_UNIX,      /* gettimeofday/time/getthtime */
    TAI_TYPE_SNTP,      /* SNTP network query */
    TAI_TYPE_RTIME      /* time network query */
} tai_type_t;

typedef enum {
    /* arithmetical operations */
    TAI_OP_NEG,
    TAI_OP_ADD,
    TAI_OP_SUB,
    TAI_OP_MUL,
    TAI_OP_DIV,
    TAI_OP_MOD,
    /* comparison operations */
    TAI_OP_G0,  /* greater than 0 */
    TAI_OP_E0,  /* equal to 0 */
    TAI_OP_L0,  /* less than 0 */
    TAI_OP_NE,
    TAI_OP_EQ,
    TAI_OP_LT,
    TAI_OP_LE,
    TAI_OP_GT,
    TAI_OP_GE,
    TAI_OP_SETPREC,
    TAI_OP_GETPREC
} tai_op_t;

struct tai_st;
typedef struct tai_st tai_t;

tai_rc_t  tai_create  (tai_t **tai);
tai_rc_t  tai_destroy (tai_t  *tai);

tai_rc_t  tai_import  (tai_t  *tai, tai_type_t type, ...);
tai_rc_t  tai_export  (tai_t  *tai, tai_type_t type, ...);

tai_rc_t  tai_format  (tai_t  *tai, char       *buf_ptr, size_t buf_len, const char *fmt);
tai_rc_t  tai_parse   (tai_t  *tai, const char *buf_ptr, size_t buf_len, const char *fmt);

tai_rc_t  tai_op      (tai_t  *tai, tai_op_t op, ...);

#endif /* __TAI_H__ */

@


1.3
log
@fix comment
@
text
@d3 3
a5 3
**  Copyright (c) 2002 Ralf S. Engelschall <rse@@engelschall.com>
**  Copyright (c) 2002 The OSSP Project <http://www.ossp.org/>
**  Copyright (c) 2002 Cable & Wireless Deutschland <http://www.cw.com/de/>
@


1.2
log
@ugly hacks to allow lmtp2nntp to compile; comparison does not even work, yet
@
text
@d65 3
a67 3
    TAI_TYPE_SECONDS,   /* long */
    TAI_TYPE_NSECONDS,  /* long */
    TAI_TYPE_ASECONDS,  /* long */
@


1.1
log
@Initial revision
@
text
@d37 2
a38 1
    TAI_OK = 0,
@


1.1.1.1
log
@Import first cut for OSSP tai
@
text
@@