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.