fdes_to_devname(2)

NAME
     fdes_to_devname - determine the device name for the device

C SYNOPSIS
     #include <invent.h>

     char * fdes_to_devname (int fd, char *buf, int *length);

OVERVIEW
     fdes_to_devname is useful to determine the canonical hardware graph path
     name given the a device file descriptor. Note that this file descriptor
     can correspond to any of the different alias names for the device.

DESCRIPTION
     The fdes_to_devname function provides a way to retrieve the path name for
     a device.

     fd identifies the device, buf is the placeholder for the device name and
     length is an input/output argument that on the call to fdes_to_devname
     should contain the maximum size of the name the process is willing to
     accept.  On return, the length will have been modified to show the actual
     size of the device name returned.

     fdes_to_devname will fail if one or more of the following are true:

     [E2BIG]
          The device name  is too large to fit into the buffer.  The integer
          that the valuelength argument points to has been modified to show
          the actual numnber of bytes that would be required to store the
          value of that attribute.

     [EBADF]
          Fd does not refer to a valid descriptor.

     [EPERM]
          The effective user ID does not match the owner of the file and the
          effective user ID is not super-user.

     [EFAULT]
          Buf, or length points outside the allocated address space of the
          process.

SEE ALSO
     attr(1), hwgraph(4)

DIAGNOSTICS
     Upon successful completion, the name is returned.  Otherwise, a value of
     NULL is returned and errno is set to indicate the error.