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

NAME
       bk parent - manage repository parent pointer[s]

SYNOPSIS
       bk parent [-a|-r|-s] [-1iloq] [<repository>] [<repository>]

   SETTING PARENT POINTERS
       bk parent -s [-ioq] <repository> [<repository>]

   ADDING PARENT POINTERS
       bk parent -a [-ioq] <repository> [<repository>]

   REMOVING PARENT POINTERS
       bk parent -r [-ioq] <repository> [<repository>]

   LISTING PARENT POINTERS
       bk parent [-1iloq]

DESCRIPTION
       The  bk parent command is used to set, add, adjust, remove or list par-
       ent pointers for a repository.  A parent pointer  is  a  BitKeeper  URL
       which  is  the  location  from  or to which  a repository gets or sends
       updates when running bk pull or bk push.  The typical case  is  that  a
       repository  has only one ``parent'' but it is possible for a repository
       to have multiple parent pointers and each pointer may be incoming, out-
       going, or both.

       When  setting  the parent pointer, the parent command is backwards com-
       patible with earlier versions if and only if there is currently no par-
       ent pointer or there is one and only one push/pull parent pointer.

       The parent is automatically set when a repository is cloned and will be
       tion).

OPTIONS
       -1  List  only  the  first  parent found.  May be combined with "-i" or
           "-o" to list the  first  incoming  or  outgoing  parent  pointer[s]
           respectively.
       -a  Add  the  specified  parent pointer to the list of parents.  May be
           combined with "-i" or "-o" to add just  the  incoming  or  outgoing
           parent pointer[s] respectively.
       -i  Operate  only on incoming (pull) parent pointers.  May be used when
           setting, adding, adjusting, removing, or listing parents.
       -l  List the parent pointer[s] without any annotations, one  per  line.
           May be combined with "-i" or "-o" to list just the incoming or out-
           going parents respectively.
       -o  Operate only on outgoing (push) parent pointers.  May be used  when
           setting, adding, adjusting, removing, or listing parents.
       -q  Do not produce output when adding/removing/listing parents.  May be
           combined with "-i" or "-o" to query whether the repository  has  an
           incoming (pull) or outgoing (push) parent pointer, exit status will
           be 0 if any matching parent pointers where  found,  otherwise  exit
           status is 1.
       -r  Remove  the  parent  pointer.  May be combined with "-i" or "-o" to
           remove just the incoming  or  outgoing  parent  pointer[s]  respec-
           tively.   Using "-i" or "-o" on a bidirectional parent pointer con-
           verts the parent pointer to unidirectional.
       -s  Set the parent pointer[s] to  the  specified  list,  replacing  any
           existing  pointers.  This option is always required to override any
           existing parent pointers except in the case that there is only  one
           bidirectional  parent  pointer  and  it  is being replaced with one
           bidirectional parent pointer (backwards compat).

BUGS
       The term parent is somewhat of a misnomer in a  peer  to  peer  system.
       Since  it  is  quite  common  to  use BitKeeper repositories  in a par-
       ent/child relationship most of the time, we have stuck with the term.

SEE ALSO
       bk bkd
       bk changes
       bk clone
       bk pull
       bk push
       bk url

CATEGORY
       Repository

BitKeeper Inc                         1E1                     bk parent(7.3ce)