Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
bk parent(7.3.3)	    BitKeeper User's Manual	      bk parent(7.3.3)

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
       named according to the access method (see bk help url for more informa-
       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 outgoing
	   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] respectively.
	   Using -i or -o on a bidirectional parent pointer converts the  par-
	   ent 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.3.3)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | BUGS | SEE ALSO | CATEGORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=parent&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help