filename_to_devname(2)

NAME
     filename_to_devname - determine the device name for the device file

C SYNOPSIS
     #include <invent.h>

     char* filename_to_devname (char *filename, char *buf, int *length);

OVERVIEW
     filename_to_devname is useful to determine the canonical hardware graph
     path name given the filename for the device. Note that there can multiple
     alias names for a device vertex in the hardware graph and the canonical
     name is unique.

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

     filename identifies the device, buf is the placeholder for the device
     name and length is an input/output argument that on the call to
     filename_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.

     filename_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 number of bytes that would be required to store the value
          of that attribute.

     [ENOENT]
          The named file does not exist.

     [ENOTDIR]
          A component of the file path name prefix is not a directory.

     [EACCES]
          Search permission is denied on a component of the file path name
          prefix.

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

     [ELOOP]
          The file path name lookup involved too many symbolic links.

     [ENAMETOOLONG]
          The length of filename exceeds {MAXPATHLEN}, or a filename component
          is longer than {MAXNAMELEN}.
     [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.