summaryrefslogtreecommitdiffstats
path: root/Documentation/cmd-set-project-parent.txt
blob: 1e7e6c560735d373f4d305163401176d1e7e463c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
gerrit set-project-parent
=========================

NAME
----
gerrit set-project-parent - Change the project permissions are inherited from.

SYNOPSIS
--------
[verse]
'ssh' -p <port> <host> 'gerrit set-project-parent'
  [--parent <NAME>]
  [--children-of <NAME>]
  [--exclude <NAME>]
  <NAME> ...

DESCRIPTION
-----------
Changes the project that permissions are inherited through.
Every project inherits permissions from another project, by
default this is `All-Projects`.  This command sets
the project to inherit through another one.

ACCESS
------
Caller must be a member of the privileged 'Administrators' group.

SCRIPTING
---------
This command is intended to be used in scripts.

OPTIONS
-------
--parent::
	Name of the parent to inherit through. If not specified,
	the parent is set back to the default `All-Projects`.

--children-of::
	Name of the parent project for which all child projects should be
	reparented. If the new parent project or any project in its
	parent line is a child of this parent project it is automatically
	excluded from reparenting.

--exclude::
	Name of a child project that should not be reparented. This
	option can only be used if the option --children-of is set.
	Multiple child projects can be excluded from reparenting by
	specifying the --exclude option multiple times. Excluding a
	project that is not a child project has no effect.

EXAMPLES
--------
Configure `kernel/omap` to inherit permissions from `kernel/common`:

====
	$ ssh -p 29418 review.example.com gerrit set-project-parent --parent kernel/common kernel/omap
====

Reparent all children of `myParent` to `myOtherParent`:

====
	$ ssh -p 29418 review.example.com gerrit set-project-parent \
	  --children-of myParent --parent myOtherParent
====

SEE ALSO
--------

* link:access-control.html[Access Controls]

GERRIT
------
Part of link:index.html[Gerrit Code Review]