--- di_devfs_path.3devinfo.orig	Mon Jan 28 10:48:24 2008
+++ di_devfs_path.3devinfo	Fri Feb  1 11:24:30 2008
@@ -1,11 +1,16 @@
+History-of-Change:
+
 Device Information Library Functions      di_devfs_path(3DEVINFO)
 
 NAME
      di_devfs_path,
      di_devfs_minor_path,
-     di_devfs_path_free
-	- generate and free physical path names
+     di_path_devfs_path,
+     di_path_client_devfs_path,
+     di_devfs_path_free,
+     - generate and free path names
+<<<NOTE: ensure that all man page aliases are created too>>>
 
 SYNOPSIS
      cc [ flag... ] file... -ldevinfo [ library... ]
      #include <libdevinfo.h>
@@ -13,47 +18,67 @@
      char	*di_devfs_path(di_node_t node);
 
      char	*di_devfs_minor_path(di_minor_t minor);
 
-     void	di_devfs_path_free(char *path_buf);
+     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 the snapshot.
+     node	The handle to a device node in a di_init(3DEVINFO) snapshot.
 
-     minor      The handle to a device minor node in the snapshot.
+     minor	The handle to a device minor node in a snapshot.
 
-     path_buf   A pointer returned by di_devfs_path() or
-		di_devfs_minor_path().
+     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 by 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 physical path by di_devfs_path() and
-     di_devfs_minor_path(). The caller of di_devfs_path() and
-     di_devfs_minor_path() is responsible for freeing this memory
-     allocated by calling di_devfs_path_free().
+     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 returned memory by calling di_devfs_path_free().
 
 RETURN VALUES
-     Upon successful completion, the di_devfs_path() and
-     di_devfs_minor_path() functions return a pointer to the string
-     containing the physical path of a device node or a device minor
-     node, respectively. Otherwise, they return NULL and errno is set
-     to indicate the error.
+     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, device minor node, or
+     device path node respectively. Otherwise, they return NULL and
+     errno is set to indicate the error.  for non-NULL return, the path
+     will not have a "/devices" prefix.
 
 ERRORS
-     The di_devfs_path() and di_devfs_minor_path() functions will fail
-     if:
+     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 or minor argument is not a valid handle.
+     EINVAL	The node, minor, or path argument is not a valid handle.
 
-     The di_devfs_path() and di_devfs_minor_path() functions can also
-     return any error value returned by malloc(3C).
+     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:
 
@@ -72,5 +97,4 @@
      malloc(3C),
      attributes(5)
 
      Writing Device Drivers
-