blob: 1e7e6c560735d373f4d305163401176d1e7e463c [file] [log] [blame]
lincolnfa7bdd32010-04-22 14:23:05 -03001gerrit set-project-parent
2=========================
3
4NAME
5----
6gerrit set-project-parent - Change the project permissions are inherited from.
7
8SYNOPSIS
9--------
10[verse]
Shawn O. Pearce47769242011-06-14 16:40:48 -070011'ssh' -p <port> <host> 'gerrit set-project-parent'
12 [--parent <NAME>]
Edwin Kempin04388412011-09-27 08:36:17 +020013 [--children-of <NAME>]
14 [--exclude <NAME>]
Shawn O. Pearce47769242011-06-14 16:40:48 -070015 <NAME> ...
lincolnfa7bdd32010-04-22 14:23:05 -030016
17DESCRIPTION
18-----------
19Changes the project that permissions are inherited through.
20Every project inherits permissions from another project, by
Shawn O. Pearcea0631822011-06-14 11:18:18 -070021default this is `All-Projects`. This command sets
lincolnfa7bdd32010-04-22 14:23:05 -030022the project to inherit through another one.
23
24ACCESS
25------
26Caller must be a member of the privileged 'Administrators' group.
27
28SCRIPTING
29---------
30This command is intended to be used in scripts.
31
32OPTIONS
33-------
Shawn O. Pearce47769242011-06-14 16:40:48 -070034--parent::
35Name of the parent to inherit through. If not specified,
Shawn O. Pearcea0631822011-06-14 11:18:18 -070036the parent is set back to the default `All-Projects`.
lincolnfa7bdd32010-04-22 14:23:05 -030037
Edwin Kempin04388412011-09-27 08:36:17 +020038--children-of::
39Name of the parent project for which all child projects should be
40reparented. If the new parent project or any project in its
41parent line is a child of this parent project it is automatically
42excluded from reparenting.
43
44--exclude::
45Name of a child project that should not be reparented. This
46option can only be used if the option --children-of is set.
47Multiple child projects can be excluded from reparenting by
48specifying the --exclude option multiple times. Excluding a
49project that is not a child project has no effect.
50
lincolnfa7bdd32010-04-22 14:23:05 -030051EXAMPLES
52--------
53Configure `kernel/omap` to inherit permissions from `kernel/common`:
54
55====
56$ ssh -p 29418 review.example.com gerrit set-project-parent --parent kernel/common kernel/omap
57====
58
Edwin Kempin04388412011-09-27 08:36:17 +020059Reparent all children of `myParent` to `myOtherParent`:
60
61====
62$ ssh -p 29418 review.example.com gerrit set-project-parent \
63 --children-of myParent --parent myOtherParent
64====
65
lincolnfa7bdd32010-04-22 14:23:05 -030066SEE ALSO
67--------
68
69* link:access-control.html[Access Controls]
70
71GERRIT
72------
73Part of link:index.html[Gerrit Code Review]