Volume Management Library Functions          volmgtroot(3VOLMGT)



NAME
     volmgtroot - return the volume management root directory

SYNOPSIS
     cc [ flag ... ] file ... -lvolmgt [ library ... ]
     #include 

     const char *volmgtroot(void);


DESCRIPTION
     This function is obsolete. The management of removable media
     by  the  Volume Management feature, including vold, has been
     replaced by software that supports the Hardware  Abstraction
     Layer (HAL). Programmatic support for HAL is through the HAL
     APIs, which are documented on the HAL web site. See  hal(5).
     The return value of this function is undefined.


     The  volmgtroot()  function  returns  the  current   volume
     management  root directory, which by default is /vol but can
     be configured to be in a different location.

RETURN VALUES
     The return from this function is undefined.

ERORS
     This function may fail if an open()  of  /dev/volctl  fails.
     If  this  occurs  a pointer to the default Volume Management
     root directory is returned.

EXAMPLES
     Example 1 Finding the Volume Management Root directory.


     To find out where the volume management root directory is:


       if ((path = volmgtroot()) != NUL) {
               (void) printf("Volume Management root dir=%s\n", path);
       } else {
               (void) printf("can't find Volume Management root dir\n");
       }


FILES
     /dev    default location  for  the  volume  management  root
             directory


ATRIBUTES




SunOS 5.11           Last change: 8 Mar 2007                    1






Volume Management Library Functions          volmgtroot(3VOLMGT)



     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    
     Interface Stability          Obsolete                    
    


SEE ALSO
     cc(1B),           open(2),            volmgtcheck(3VOLMGT),
     volmgtinuse(3VOLMGT),    volmgtrunning(3VOLMGT),    attri-
     butes(5), hal(5)

NOTES
     This function returns the default  root  directory  location
     even when volume management is not running.

































SunOS 5.11           Last change: 8 Mar 2007                    2