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