| 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] |
| 11 | 'ssh' -p <port> <host> 'gerrit ls-user-ref' |
| 12 | [--project PROJECT> | -p <PROJECT>] |
| 13 | [--user <USER> | -u <USER>] |
| 14 | |
| 15 | DESCRIPTION |
| 16 | ----------- |
| 17 | Displays all refs that the specified user can see. |
| 18 | |
| 19 | Allows an administrator to query which refs are visible for |
| 20 | a user. The command is helpful for admins when debugging why a |
| 21 | user cannot access certain refs and also to help admins |
| 22 | verify that certain secret refs are not exposed to the wrong |
| 23 | groups. |
| 24 | |
| 25 | ACCESS |
| 26 | ------ |
| 27 | Administrators |
| 28 | |
| 29 | OPTIONS |
| 30 | ------- |
| 31 | --project:: |
| 32 | -p:: |
| 33 | Name of the project for which the refs should be listed. |
| 34 | |
| 35 | --user:: |
| 36 | -u:: |
| 37 | User for which the visible refs should be listed. Gerrit |
| 38 | will query the database to find matching users, so the |
| 39 | full identity/name does not need to be specified. |
| 40 | |
| 41 | EXAMPLES |
| 42 | -------- |
| 43 | |
| 44 | List visible refs for the user "mr.developer" in project "gerrit" |
| 45 | ===== |
| 46 | $ ssh -p 29418 review.example.com gerrit ls-user-refs -p gerrit -u mr.developer |
| 47 | ===== |
| 48 | |
| 49 | GERRIT |
| 50 | ------ |
| 51 | Part of link:index.html[Gerrit Code Review] |
