| = gerrit show-queue | |
| == NAME | |
| gerrit show-queue - Display the background work queues, including replication | |
| and indexing. | |
| == SYNOPSIS | |
| [verse] | |
| -- | |
| _ssh_ -p <port> <host> _gerrit show-queue_ | |
| _ssh_ -p <port> <host> _ps_ | |
| -- | |
| == DESCRIPTION | |
| Presents a table of the pending activity the Gerrit daemon | |
| is currently performing, or will perform in the near future. | |
| Gerrit contains an internal scheduler, similar to cron, that it | |
| uses to queue and dispatch both short and long term activity. | |
| Tasks that are completed or canceled exit the queue very quickly | |
| once they enter this state, but it can be possible to observe tasks | |
| in these states. | |
| == ACCESS | |
| End-users may see a task in the queue only if they can also see | |
| the project the task is associated with. Tasks operating on other | |
| projects, or that do not have a specific project are hidden. | |
| Members of the group 'Administrators', or any group that has been | |
| granted | |
| link:access-control.html#capability_viewQueue[the 'View Queue' capability] | |
| can see all queue entries. | |
| == SCRIPTING | |
| Intended for interactive use only. | |
| == OPTIONS | |
| --wide:: | |
| -w:: | |
| Do not format the output to the terminal width (default of | |
| 80 columns). | |
| --by-queue:: | |
| -q:: | |
| Group tasks by queue and print queue info. | |
| == DISPLAY | |
| Task:: | |
| Unique task identifier on this server. May be passed into | |
| link:cmd-kill.html[kill] to cancel or terminate the task. | |
| Task identifiers have a period of 2^32-1, and start from | |
| a random value. | |
| State:: | |
| If running, blank. | |
| + | |
| If the task has completed, but has not yet been reaped, 'done'. | |
| If the task has been killed, but has not yet halted or been removed | |
| from the queue, 'killed'. | |
| + | |
| If the task is ready to execute but is waiting for an idle thread | |
| in its associated thread pool, 'waiting'. | |
| + | |
| Otherwise the time (local to the server) that this task will begin | |
| execution. | |
| Command:: | |
| Short text description of the task that will be performed | |
| at the given time. | |
| == EXAMPLES | |
| The following queue contains two tasks scheduled to replicate the | |
| `tools/gerrit.git` project to two different remote systems, `dst1` | |
| and `dst2`: | |
| ---- | |
| $ ssh -p 29418 review.example.com gerrit show-queue | |
| Task State Command | |
| ------------------------------------------------------------------------------ | |
| 7aae09b2 14:31:15.435 mirror dst1:/home/git/tools/gerrit.git | |
| 9ad09d27 14:31:25.434 mirror dst2:/var/cache/tools/gerrit.git | |
| ------------------------------------------------------------------------------ | |
| 2 tasks | |
| ---- | |
| GERRIT | |
| ------ | |
| Part of link:index.html[Gerrit Code Review] | |
| SEARCHBOX | |
| --------- |