DtDtsDataToDataType(library call) DtDtsDataToDataType(library call)
NAME
DtDtsDataToDataType -- get the data type for a set of data
SYNOPSIS
#include <Dt/Dts.h>
char *DtDtsDataToDataType(
const char *filepath,
const void *buffer,
const int size,
const struct stat *stat_buff,
const char *link_path,
const struct stat *link_stat_buff,
const char *opt_name);
DESCRIPTION
The DtDtsDataToDataType function determines the data type of a set of data, based on the information given in the non- NULL pointer argu-
ments to the function. The function gathers any additional information, if it is needed, to compensate for the NULL arguments. For exam-
ple, if the filepath argument is given, but the stat_buff argument is NULL and a stat_buff value is required to determine the data type,
DtDtsDataToDataType calls the stat(2) function to obtain the information.
The filepath argument is the pathname of a file.
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 stat_buff argument is the buffer returned from a stat(2) or fstat(3) call for use in typing.
The link_path argument is the pathname of the target file pointed to by a symbolic link.
The link_stat_buff argument is the buffer returned from an lstat(2) call for use in typing.
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 deter-
mined.
RETURN VALUE
Upon successful completion, the DtDtsDataToDataType function returns a pointer to a data type string, or NULL if no value could be deter-
mined.
APPLICATION USAGE
The DtDtsDataToDataType function is generally used by applications such as file managers to improve performance. Typical applications
should probably use DtDtsFileToDataType(3) or DtDtsBufferToDataType(3) instead.
The DtDtsBuffer* functions assume that the buffer is readable and writable by the user, group and other file classes and select a type
accordingly. An application requiring a type based on read-only permissions should use DtDtsDataToDataType with a stat_buff value created
for this purpose: all fields should NULL except for the st_mode field, which should be set to:
S_IFREG | S_IROTH | S_IRGRP | S_IRUSR
SEE ALSO
Dt/Dts.h, DtDtsLoadDataTypes(3), DtDtsFileToDataType(3), DtDtsBufferToDataType(3), fstat(3), lstat(2), stat(2).
DtDtsDataToDataType(library call)
