di_path_devfs_path man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

DI_DEVFS_PATH(3DEVINFO)				       DI_DEVFS_PATH(3DEVINFO)

NAME
       di_devfs_path,	      di_devfs_minor_path,	   di_path_devfs_path,
       di_path_client_devfs_path, di_devfs_path_free - generate and free  path
       names

SYNOPSIS
       cc [ flag... ] file... -ldevinfo [ library... ]
       #include <libdevinfo.h>

       char *di_devfs_path(di_node_t node);

       char *di_devfs_minor_path(di_minor_t minor);

       char *di_path_devfs_path(di_path_t path);

       char *di_path_client_devfs_path(di_path_t path);

       void di_devfs_path_free(char *path_buf);

PARAMETERS
       node
		   The	handle	to  a device node in a di_init(3DEVINFO) snap‐
		   shot.

       minor
		   The handle to a device minor node in a snapshot.

       path
		   The handle to a device path node in a snapshot.

       path_buf
		   A	  pointer      returned	     by	      di_devfs_path(),
		   di_devfs_minor_path(),	di_path_devfs_path(),	    or
		   di_path_client_devfs_path().

DESCRIPTION
       The di_devfs_path() function generates the physical path of the	device
       node specified by node.

       The  di_devfs_minor_path()  function generates the physical path of the
       device minor node specified by minor.

       The di_path_devfs_path() function generates the pHCI physical  path  to
       the device associated with the specified path node. The returned string
       is identical to the di_devfs_path()  for the device had the device  not
       been supported by multipath.

       The  di_path_client_devfs_path()	 function  generates the vHCI physical
       path of the multipath client device node	 associated  with  the	device
       identity	 of  the specified path node. The returned string is identical
       to the di_devfs_path() of the multipath client device node.

       The di_devfs_path_free() function frees memory that  was	 allocated  to
       store  the  path	 returned  by  di_devfs_path(), di_devfs_minor_path(),
       di_path_devfs_path(), and di_path_client_devfs_path().  The  caller  is
       responsible for freeing this memory by calling di_devfs_path_free().

RETURN VALUES
       Upon successful completion, the di_devfs_path(), di_devfs_minor_path(),
       di_path_devfs_path(), and di_path_client_devfs_path() functions	return
       a  pointer to the string containing the path to a device node, a device
       minor node, or a device path node, respectively. Otherwise, they return
       NULL and errno is set to indicate the error. For a non-NULL return, the
       path will not have a "/devices" prefix.

ERRORS
       The di_devfs_path(), di_devfs_minor_path(),  di_path_devfs_path(),  and
       di_path_client_devfs_path() functions will fail if:

       EINVAL
		 The node, minor, or path argument is not a valid handle.

       The  di_devfs_path(),  di_devfs_minor_path(), di_path_devfs_path(), and
       di_path_client_devfs_path() functions can also return any  error	 value
       returned by malloc(3C).

ATTRIBUTES
       See attributes(5)  for descriptions of the following attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ Committed	      │
       ├────────────────────┼─────────────────┤
       │MT-Level	    │ Safe	      │
       └────────────────────┴─────────────────┘

SEE ALSO
       di_init(3DEVINFO), libdevinfo(3LIB), malloc(3C), attributes(5)

       Writing Device Drivers

				 May 15, 2008	       DI_DEVFS_PATH(3DEVINFO)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net