Sun StorageTek 5800 System Client API Reference Guide

read_from_data_source

Data source template used to upload object data to the cluster.

Synopsis

    typedef long (*read_from_data_source) 
    (void *cookie, char *buf, long buf_size);

Description

Function pointers of read_from_data_source type are used to upload object data. The function pointer and opaque cookie reference are supplied as arguments to hc_store_both_ez and other functions that store object data. The data source reader function will be called repeatedly, with the supplied cookie as an argument, to gather the object data to upload into storage.

A read_from_data_source function should read up to buf_size bytes from the data source indicated by cookie into the buffer at location buff and return the actual number of bytes read as the return value from the function.

There are two special return codes:

Parameters

cookie

An opaque data structure to identify this data cookie. The cookie is likely to be an open file descriptor.

buf

Where to store the data.

buf_size

The number of available bytes of space in buf.

See Also

hc_store_both_ez