Volume Management Library Functions         volmgtinuse(3VOLMGT)



NAME
     volmgtinuse - check whether or  not  volume  management  is
     managing a pathname

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



     int volmgtinuse(char *pathname);


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.


     volmgtinuse() checks whether volume management is  managing
     the specified pathname.

RETURN VALUES
     The return from this function is undefined.

ERORS
     This routine can fail, returning 0, if a stat(2) of the sup-
     plied pathname or an open(2) of /dev/volctl fails, or if any
     of the following is true:

     ENXIO    Volume management is not running.


     EINTR    An interrupt signal was detected while checking for
              the supplied pathname for use.


EXAMPLES
     Example 1 Using volmgtinuse()


     To see if volume management is  managing  the  first  floppy
     disk:


       if (volmgtinuse("/dev/rdiskette0") != 0) {
               (void) printf("volmgt is managing diskette 0\n");
       } else {
               (void) printf("volmgt is NOT managing diskette 0\n");



SunOS 5.11           Last change: 8 Mar 2007                    1






Volume Management Library Functions         volmgtinuse(3VOLMGT)



       }


ATRIBUTES
     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),         stat(2),         errno(3C),
     volmgtcheck(3VOLMGT),    volmgtrunning(3VOLMGT),    attri-
     butes(5),  hal(5)

NOTES
     This routine requires volume management to be running.


     Since volmgtinuse() returns 0 for two different cases (both
     when  a  volume is not in use, and when an error occurs), it
     is up to the user to to check  errno  to  differentiate  the
     two, and to ensure that volume management is running.
























SunOS 5.11           Last change: 8 Mar 2007                    2