Manual Pages for UNIX Operating System command usage for man volmgt_release

Volume Management Library Functions       volmgt_release(3VOLMGT)



NAME
     volmgt_release - release removable media device reservation

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



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


     If  dev is reserved by the caller,  volmgt_release() 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.

ERRORS
     On failure, volmgt_release() 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 volmgt_release()


     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       volmgt_release(3VOLMGT)



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


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Obsolete                    |
    |_____________________________|_____________________________|


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
























SunOS 5.11           Last change: 8 Mar 2007                    2