5bfabe5c21
The ls-projects command has a new --tree option that will make the output of the project names be printed in a ascii art hierarcy to show the projects access rights inheritance.
67 lines
1.3 KiB
Plaintext
67 lines
1.3 KiB
Plaintext
gerrit ls-projects
|
|
==================
|
|
|
|
NAME
|
|
----
|
|
gerrit ls-projects - List projects visible to caller
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'ssh' -p <port> <host> 'gerrit ls-projects' [\--show-branch <BRANCH>]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Displays the list of project names, one per line, that the
|
|
calling user account has been granted 'READ' access to.
|
|
|
|
If the caller is a member of the privileged 'Administrators'
|
|
group, all projects are listed.
|
|
|
|
ACCESS
|
|
------
|
|
Any user who has configured an SSH key.
|
|
|
|
SCRIPTING
|
|
---------
|
|
This command is intended to be used in scripts.
|
|
|
|
OPTIONS
|
|
-------
|
|
\--show-branch::
|
|
\-b::
|
|
Name of the branch for which the command will display the sha of each project.
|
|
|
|
\--tree::
|
|
\-t::
|
|
Displays project inheritance in a tree-like format.
|
|
This option does not work together with the show-branch option.
|
|
|
|
EXAMPLES
|
|
--------
|
|
|
|
List visible projects:
|
|
=====
|
|
$ ssh -p 29418 review.example.com gerrit ls-projects
|
|
tools/gerrit
|
|
tools/gwtorm
|
|
=====
|
|
|
|
Clone any project visible to the user:
|
|
====
|
|
for p in `ssh -p 29418 review.example.com gerrit ls-projects`
|
|
do
|
|
mkdir -p `dirname "$p"`
|
|
git clone --bare "ssh://review.example.com:29418/$p.git" "$p.git"
|
|
done
|
|
====
|
|
|
|
SEE ALSO
|
|
--------
|
|
|
|
* link:access-control.html[Access Controls]
|
|
|
|
GERRIT
|
|
------
|
|
Part of link:index.html[Gerrit Code Review]
|