| Gustaf Lundh | bf53a70 | 2012-11-15 18:24:32 -0800 | [diff] [blame] | 1 | gerrit ls-user-refs |
| 2 | =================== |
| 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | gerrit ls-user-refs - List refs visible to a specific user |
| 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | [verse] |
| Christian Aistleitner | 870fad2 | 2013-05-01 12:19:28 +0200 | [diff] [blame] | 11 | 'ssh' -p <port> <host> 'gerrit ls-user-refs' |
| Gustaf Lundh | bf53a70 | 2012-11-15 18:24:32 -0800 | [diff] [blame] | 12 | [--project PROJECT> | -p <PROJECT>] |
| 13 | [--user <USER> | -u <USER>] |
| Gustaf Lundh | 2f7bdc1 | 2012-11-18 18:24:39 -0800 | [diff] [blame] | 14 | [--only-refs-heads] |
| Gustaf Lundh | bf53a70 | 2012-11-15 18:24:32 -0800 | [diff] [blame] | 15 | |
| 16 | DESCRIPTION |
| 17 | ----------- |
| 18 | Displays all refs that the specified user can see. |
| 19 | |
| 20 | Allows an administrator to query which refs are visible for |
| 21 | a user. The command is helpful for admins when debugging why a |
| 22 | user cannot access certain refs and also to help admins |
| 23 | verify that certain secret refs are not exposed to the wrong |
| 24 | groups. |
| 25 | |
| 26 | ACCESS |
| 27 | ------ |
| 28 | Administrators |
| 29 | |
| 30 | OPTIONS |
| 31 | ------- |
| 32 | --project:: |
| 33 | -p:: |
| Christian Aistleitner | a0e111e | 2013-04-30 20:17:29 +0200 | [diff] [blame] | 34 | Required; Name of the project for which the refs should be listed. |
| Gustaf Lundh | bf53a70 | 2012-11-15 18:24:32 -0800 | [diff] [blame] | 35 | |
| 36 | --user:: |
| 37 | -u:: |
| Christian Aistleitner | a0e111e | 2013-04-30 20:17:29 +0200 | [diff] [blame] | 38 | Required; User for which the visible refs should be listed. Gerrit |
| Gustaf Lundh | bf53a70 | 2012-11-15 18:24:32 -0800 | [diff] [blame] | 39 | will query the database to find matching users, so the |
| 40 | full identity/name does not need to be specified. |
| 41 | |
| Gustaf Lundh | 2f7bdc1 | 2012-11-18 18:24:39 -0800 | [diff] [blame] | 42 | --only-refs-heads:: |
| 43 | Only list the refs found under refs/heads/* |
| 44 | |
| Gustaf Lundh | bf53a70 | 2012-11-15 18:24:32 -0800 | [diff] [blame] | 45 | EXAMPLES |
| 46 | -------- |
| 47 | |
| 48 | List visible refs for the user "mr.developer" in project "gerrit" |
| 49 | ===== |
| 50 | $ ssh -p 29418 review.example.com gerrit ls-user-refs -p gerrit -u mr.developer |
| 51 | ===== |
| 52 | |
| 53 | GERRIT |
| 54 | ------ |
| 55 | Part of link:index.html[Gerrit Code Review] |
