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.

  This command uses the command line parser, and so also  accepts  the  standard
  command options listed in HELP CL.


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.