idmef_time_ref ()

idmef_time_t *
idmef_time_ref (idmef_time_t *time);

Increases time reference count. idmef_time_destroy() won't destroy time until the refcount reach 0.

idmef_time_new ()

int
idmef_time_new (idmef_time_t **time);

Creates an empty idmef_time_t object and store it in time .

idmef_time_new_from_time ()

int
idmef_time_new_from_time (idmef_time_t **time,
                          const time_t *t);

Creates a new idmef_time_t object and store it in time . This object will be filled with information available in t . The created time won't contain micro seconds information, since theses are not available within t .

idmef_time_new_from_gettimeofday ()

int
idmef_time_new_from_gettimeofday (idmef_time_t **time);

Creates an idmef_time_t object filled with information retrieved using gettimeofday(), and stores it in time .

idmef_time_new_from_string ()

int
idmef_time_new_from_string (idmef_time_t **time,
                            const char *buf);

Creates an idmef_time_t object filled with information retrieved from the user provided buf , containing a string describing a time in a format conforming to the IDMEF definition (v. 0.10, section 3.2.6).

Additionally, the provided time might be separated with white spaces, instead of the IDMEF define 'T' character. The format might not specify a timezone (will assume UTC in this case).

The resulting idmef_time_t object is stored in time .

idmef_time_new_from_ntpstamp ()

int
idmef_time_new_from_ntpstamp (idmef_time_t **time,
                              const char *buf);

Creates an idmef_time_t object filled with information provided from the buf NTP timestamp, and stores it in time .

idmef_time_new_from_timeval ()

int
idmef_time_new_from_timeval (idmef_time_t **time,
                             const struct timeval *tv);

Creates an idmef_time_t object filled with information provided within the tv structure.

idmef_time_set_from_time ()

void
idmef_time_set_from_time (idmef_time_t *time,
                          const time_t *t);

Fills time from the information described by t . time won't contain micro seconds information, since theses are not available within t .

idmef_time_set_from_gettimeofday ()

int
idmef_time_set_from_gettimeofday (idmef_time_t *time);

Fills time with information retrieved using gettimeofday().

idmef_time_set_from_string ()

int
idmef_time_set_from_string (idmef_time_t *time,
                            const char *buf);

Fills time object with information retrieved from the user provided buf , containing a string describing a time in a format conforming to the IDMEF definition (v. 0.10, section 3.2.6).

Additionally, the provided time might be separated with white spaces, instead of the IDMEF defined 'T' character.

If there is no UTC offset specified, we assume that the provided time is local, and compute the GMT offset by ourselve.

idmef_time_set_from_ntpstamp ()

int
idmef_time_set_from_ntpstamp (idmef_time_t *time,
                              const char *buf);

Fills the time object with information provided within the buf NTP timestamp.

idmef_time_set_from_timeval ()

int
idmef_time_set_from_timeval (idmef_time_t *time,
                             const struct timeval *tv);

Fills time object filled with information provided within the tv structure.

idmef_time_destroy_internal ()

void
idmef_time_destroy_internal (idmef_time_t *time);

idmef_time_destroy ()

void
idmef_time_destroy (idmef_time_t *time);

Destroys time if refcount reach 0.

idmef_time_clone ()

int
idmef_time_clone (const idmef_time_t *src,
                  idmef_time_t **dst);

Clones src and stores the result in the dst address.

idmef_time_copy ()

int
idmef_time_copy (const idmef_time_t *src,
                 idmef_time_t *dst);

Copies src internal to dst .

idmef_time_set_sec ()

void
idmef_time_set_sec (idmef_time_t *time,
                    uint32_t sec);

Sets the number of second from the Epoch to sec within time .

WARNING: this is just an accessor function, and using it to set time current time also requires the use of idmef_time_set_usec() and idmef_time_set_gmt_offset().

idmef_time_set_usec ()

void
idmef_time_set_usec (idmef_time_t *time,
                     uint32_t usec);

Sets the number of micro second to usec within time .

WARNING: this is just an accessor function, and using it to set time current time also requires the use of idmef_time_set_sec() and idmef_time_set_gmt_offset().

idmef_time_set_gmt_offset ()

void
idmef_time_set_gmt_offset (idmef_time_t *time,
                           int32_t gmtoff);

Sets the GMT offset gmtoff , in seconds, within time .

WARNING: this is just an accessor function, and using it to set time current time also requires the use of idmef_time_set_sec() and idmef_time_set_usec().

idmef_time_get_sec ()

uint32_t
idmef_time_get_sec (const idmef_time_t *time);

Returns the number of second since the Epoch (00:00:00 UTC, January 1, 1970), previously set within time .

idmef_time_get_usec ()

uint32_t
idmef_time_get_usec (const idmef_time_t *time);

Returns the u-second member of time .

idmef_time_get_gmt_offset ()

int32_t
idmef_time_get_gmt_offset (const idmef_time_t *time);

Returns the GMT offset that applies to time .

idmef_time_to_string ()

int
idmef_time_to_string (const idmef_time_t *time,
                      prelude_string_t *out);

Translates time to an user readable string conforming to the IDMEF defined time format.

idmef_time_to_ntpstamp ()

int
idmef_time_to_ntpstamp (const idmef_time_t *time,
                        prelude_string_t *out);

Translates time to an user readable NTP timestamp string, conforming to the IDMEF defined time format.

idmef_time_t

typedef struct idmef_time idmef_time_t;