FDES_TO_DEVNAME(2)					    FDES_TO_DEVNAME(2)

NAME    [Toc]    [Back]

     fdes_to_devname - determine the device name for the device

C SYNOPSIS    [Toc]    [Back]

     #include <invent.h>

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

OVERVIEW    [Toc]    [Back]

     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    [Toc]    [Back]

     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 number 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    [Toc]    [Back]

     attr(1), hwgraph(4)

DIAGNOSTICS    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111