Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ ulkob — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought

10.0;ulkob (unlock_object), revision 1.0, 88/01/21
ulkob (unlock_object) - unlock an object.
usage:  ulkob [-r|-w|-i|-f] [-l] [-u uid ...] [pathname...] {CL}



DESCRIPTION
     ulkob unlocks objects residing on, or locked by processes running on, the
     current node.  You cannot unlock objects on remote nodes unless you
     locked them (see -f below).

     You can unlock objects only if:

     You're running in-process and try to release a lock that your process
     previously obtained, or

     The object you want to unlock resides on the current node AND the process
     that obtained the lock is executing at another node.  For example, if a
     lock is stranded because the node that locked the file crashes, you could
     crp on to the node where the file lives and break that lock.


ARGUMENTS
     pathname (optional)
               Specify name of object to be unlocked.  Multiple pathnames and
               wildcarding are permitted.

               Default if omitted:  -u option must be specified

NOTE
     To obtain a list of your node's locked objects, use the llkob command.

OPTIONS
     If no options are specified, the object is unlocked for all lock modes.

     -r          Unlock an object that was locked for read mode; the lock must
                 be owned by this process.

     -w          Unlock an object that was locked for write mode; the lock
                 must be owned by this process.

     -i          Unlock an object that was locked for reading with intent to
                 write; the lock must be owned by this process.

     -f          Forcibly unlock an object.  It may have been locked for any
                 mode and the lock may be owned by any process.  The object
                 must reside on the current node, however, or must have been
                 locked by the current node.  In other words, you cannot
                 unlock objects on a remote node unless you locked them.

     -l          List the name of each object as it is unlocked.

     -u uid ...  Specify the UID of the object(s) to unlock.  Multiple UIDs
                 are permitted.  If the pathname argument is omitted, then
                 this option is required.

EXAMPLES
     Forcibly unlock the file mary for any mode and unlock the two objects
     with the specified UIDs.

     $ /etc/ulkob mary -f

     $ /etc/ulkob -uid 1C1A9E2F.20000246 1C1A9E42.50000246



SEE ALSO
     More information is available.  Type

     help  lkob     For details about locking objects

     help  llkob    For details about listing those objects that are locked

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026