Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

LKOB

LLKOB

4.1;ulkob (unlock_object), revision 4.1, 83/12/01
ULKOB (UNLOCK_OBJECT) -- Unlock an object.
usage:  ULKOB [pathname...] [-R|-W|-I|-F] [-L] [-U uid ...]  {CL}


FORMAT

  ULKOB [pathname ...] [options]


  The  ULKOB command unlocks objects residing on, or locked by processes running
  on, the current node.  You may not unlock objects on remote nodes  unless  you
  locked  them  (see  -F  below).    This  command  can  be  used when a program
  terminates abnormally, leaving objects locked, or to unlock objects previously
  locked with the LKOB (LOCK_OBJECT) command.

  To  obtain  a  list  of  your   node's   locked   objects,   use   the   LLKOB
  (LIST_LOCKED_OBJECTS) command.


ARGUMENTS

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

                     Default if omitted:  -U option must be specified


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

  $ ULKOB mary -f            Forcibly unlock the file "mary" for any mode.

  $ ULKOB -uid 1C1A9E2F.20000246 1C1A9E42.50000246
                             Unlock the two objects with the specified UIDs.


RELATED TOPICS

  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