DtDtsBufferToAttriUNIXLSystem V (1 ADtDtsBufferToAttributeList(3)
NAME
DtDtsBufferToAttributeList - get a list of data attributes
for a byte stream
SYNOPSIS
#include <Dt/Dts.h>
DtDtsAttribute **DtDtsBufferToAttributeList(const void *buffer,
const int size,
const char *opt_name);
DESCRIPTION
The DtDtsBufferToAttributeList() function returns a list of
data attributes for a given byte stream.
The buffer argument is a pointer to the buffer of the data
to be typed.
The size argument is the size of the buffer in bytes.
The opt_name argument can be used to specify a name to be
associated with the buffer. If the opt_name argument is not
NULL, it is used as a pseudo file name in typing; otherwise,
certain attributes may be returned as NULL because the
filename components could not be determined.
RETURN VALUE
Upon successful completion, the DtDtsBufferToAttributeList()
function returns a NULL-terminated array of pointers of
*DtDtsAttribute. If no value could be determined, it
returns NULL.
APPLICATION USAGE
The application should use the DtDtsFreeAttributeList(3)
function to release the memory for the returned value.
The DtDtsBufferToAttributeList() function assumes that the
buffer is readable and writable by the user, group and other
file classes and selects a type accordingly. An application
requiring a type based on read-only permissions should use
DtDtsDataToDataType().
SEE ALSO
DtDts(5), DtDtsDataToDataType(3), DtDtsLoadDataTypes(3),
DtDtsFreeAttributeList(3).
Page 1 (printed 9/3/04)