hc_nvr_add_timestamp
Addsnew metadata value of type timestamp.
Synopsis
#include <time.h>
hcerr_t hc_nvr_add_timestamp(hc_nvr_t *nvr,
hc_string_t name,
struct timespec *value);
Description
Thisfunction adds a new metadata name-value-type tuple to a designated name-value record,
wheretype is hc_timestamp_t. The struct timespec is dened in the POSIX standard:
time_t tv_sec; /* seconds */
long tv_nsec; /* and nanoseconds */
wheretv_sec ismeasured since the UNIX epoch (00:00:00 UTC on January 1, 1970). The
maximumvalue of tv_sec istruncated by three decimal digits owing to database limitations
andtv_nsec istruncated to milliseconds. The name-value record automatically expands as
needed.The name and value are copied into the structure.
Parameters
nvr
Pointsto a name-value-record.
name
IN:Name for the tuple.
value
IN: The ’struct timespec’(time.h) value.
ReturnCodes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
HCERR_INVALID_NVR
HCERR_ILLEGAL_ARGUMENT
HCERR_ILLEGAL_VALUE_FOR_METADATA
HCERR_NO_SUCH_ATTRIBUTE
SynchronousCAPI Functions
SunStorageTek5800 System Client API Reference Manual • June 200874