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