Index for Section 3

Alphabetical listing for D

Bottom of page

DtDtsDataToDataType(3)
CDE
NAME
  DtDtsDataToDataType - get the data type for a set of data

SYNOPSIS
  #include <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 arguments to the
  function. The function gathers any additional information, if it is needed,
  to compensate for the NULL arguments. For example, 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 determined.

RETURN VALUE
  Upon successful completion, the DtDtsDataToDataType function returns a
  pointer to a data type string, or NULL if no value could be determined.

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
  DtDts, DtDtsLoadDataTypes(3), DtDtsFileToDataType(3),
  DtDtsBufferToDataType(3), fstat(2), lstat(2), stat(2).
  DtDtsBufferToDataType, fstat, lstat, stat in the X/Open CAE Specification,
  X/Open System Interfaces and Headers, Issue 4, Version 2

Index for Section 3

Alphabetical listing for D

Top of page