DEV_TO_DEVNAME(2)					     DEV_TO_DEVNAME(2)

NAME    [Toc]    [Back]

     dev_to_devname - determine	the device name	for the	device

C SYNOPSIS    [Toc]    [Back]

     #include <invent.h>

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

OVERVIEW    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

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