bk lock(7.3ce)              BitKeeper User's Manual             bk lock(7.3ce)

NAME
       bk lock - lock a repository or show lockers

SYNOPSIS
       bk lock [-l|r|w|L|U] [-q] [<directory>]

DESCRIPTION
       The bk lock command can be used to lock an entire repository or to list
       the lockers of a repository.  If a directory is specified,  the  opera-
       tion applies to the repository rooted at that directory.

       Since  a lock is valid only as long as the locking process exists, when
       placing  lock the bk lock command does not exit, it goes to sleep wait-
       ing for a signal.

OPTIONS
       -l  List the lockers of a repository.
       -q  quiet, exit status only
       -r  Add a read lock (non-exclusive) and sleep until interrupted.
       -w  Add a write lock (exclusive) and sleep until interrupted.
       -L  Wait  for the repository to become locked (primarily used for test-
           ing).
       -U  Wait for the repository to  become  unlocked  (primarily  used  for
           testing).

EXIT STATUS
       If  called  with  no options or if called with the "-l" option, bk lock
       returns exit status:

       0   if the repository has no locks.
       1   if the repository has locks.
       2   if run outside of a repository.

       If called with either "-r" or "-w", bk lock returns exit  status  1  if
       unable to lock the repository.

SEE ALSO
       bk unlock

CATEGORY
       Repository

BitKeeper Inc                         1E1                       bk lock(7.3ce)