Sun StorageTek 5800 System Client API Reference Guide

hc_nvr_add_date

Adds new metadata value of type date.

Synopsis

     #include <time.h>
     hcerr_t hc_nvr_add_date(hc_nvr_t *nvr, 
          hc_string_t name,struct tm *value);

Description

This function adds a new metadata name-value-type tuple to a designated name-value record.

The struct tm fields are as defined in the POSIX standard and interpreted by mktime(3C). All fields are ignored except:

     int tm_mday; /* day of the month - [1, 31] */
     int tm_mon; /* months since January - [0, 11] */
     int tm_year; /* years since 1900 */

The name-value record automatically expands as needed. The name and value are copied into the structure.

Parameters

nvr

Points to a name-value-record.

name

IN: Name for the tuple.

value

IN: The struct tm (time.h) value.

Return Codes

     HCERR_OK
     HCERR_BAD_REQUEST
     HCERR_OOM
     HCERR_INVALID_NVR
     HCERR_ILLEGAL_ARGUMENT
     HCERR_ILLEGAL_VALUE_FOR_METADATA
     HCERR_NO_SUCH_ATTRIBUTE