DtDtsBufferToAttributeList(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).