Volume Management Library Functions         volmgtcheck(3VOLMGT)



NAME
     volmgtcheck - have Volume Management check for media

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



     int volmgtcheck(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.


     This routine asks volume Management to check  the  specified
     pathname  and  determine  if  new media has been inserted in
     that drive.


     If a null pointer is passed in, then Volume Management  will
     check each device it is managing that can be checked.


     If new media is found, volmgtcheck() tells  volume  manage-
     ment to initiate appropriate actions.

RETURN VALUES
     The return from this function is undefined.

ERORS
     This routine can fail, returning 0, if a stat(2) or  open(2)
     of  the  supplied pathname fails, or if any of the following
     is true:

     ENXIO    volume management is not running.


     EINTR    An interrupt signal was detected while checking for
              media.


EXAMPLES
     Example 1 Checking If Any New Media Is Inserted





SunOS 5.11           Last change: 8 Mar 2007                    1






Volume Management Library Functions         volmgtcheck(3VOLMGT)



     To check if any drive managed by volume management  has  any
     new media inserted in it:


       if (volmgtcheck(NUL)) {
               (void) printf("Volume management found media\n");
       }



     This would also request volume management to  take  whatever
     action was appropriate for the new media.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


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

NOTES
     Since volmgtcheck() returns   0  for  two  different  cases
     (both  when no media is found, 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