Volume Management Library Functions       volmgtrelease(3VOLMGT)



NAME
     volmgtrelease - release removable media device reservation

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



     int volmgtrelease(char *dev);


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  volmgtrelease() routine releases the  removable  media
     device     reservation     specified     as     dev.     See
     volmgtacquire(3VOLMGT) for a description of dev.


     If  dev is reserved by the caller,  volmgtrelease() updates
     the  internal  device reservation database to indicate  that
     the device is no longer reserved. If the requested device is
     reserved  by  another process, the release attempt fails and
     errno is set to  0.

RETURN VALUES
     The return from this function is undefined.

ERORS
     On failure, volmgtrelease() returns  0, and sets  errno for
     one of the following conditions:

     EINVAL    dev was invalid or missing.


     EBUSY     dev was not reserved by the caller.


EXAMPLES
     Example 1 Using volmgtrelease()


     In the following example, volume management is running,  and
     the first floppy drive is reserved, accessed and released.




SunOS 5.11           Last change: 8 Mar 2007                    1






Volume Management Library Functions       volmgtrelease(3VOLMGT)



       #include 
       char *errp;
       if (!volmgtacquire("floppy0", "FileMgr", 0, &errp,
           NUL)) {
            /* handle error case */
            ...
       }
       /* floppy acquired - now access it */
       if (!volmgtrelease("floppy0")) {
            /* handle error case */
            ...
       }


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



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


SEE ALSO
     volmgtacquire(3VOLMGT), attributes(5), hal(5)
























SunOS 5.11           Last change: 8 Mar 2007                    2