dev_to_devname(2)

NAME
     dev_to_devname - determine the device name for the device

C SYNOPSIS
     #include <invent.h>

     char* dev_to_devname (dev_t dev, char *buf, int *length);

OVERVIEW
     dev_to_devname is useful to determine the canonical hardware graph path
     name given the device identifier.

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

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

     dev_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 length argument points to has been modified to show the
          actual number of bytes that would be required to store the value of
          that attribute.

     [ENODEV]
          The device does not exist.

     [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.