DtDtsBufferToAttributeValue(3)

     NAME
          DtDtsBufferToAttributeValue - get a single data attribute
          value for a byte stream

     SYNOPSIS
          #include <Dt/Dts.h>

          char *DtDtsBufferToAttributeValue(const void *buffer,
                                            const int size,
                                            const char *attr_name,
                                            const char *opt_name);

     DESCRIPTION
          The DtDtsBufferToAttributeValue() function returns a data
          attribute value 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 attr_name argument is a name of the attribute.

          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
          DtDtsBufferToAttributeValue() function returns a pointer to
          a data attribute value string, or NULL if no value could be
          determined.

     APPLICATION USAGE
          The application should use the DtDtsFreeAttributeValue(3)
          function to release the memory for the returned value.

          The DtDtsBufferToAttributeValue() 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),
          DtDtsFreeAttributeValue(3).