94 lines
2.5 KiB
Plaintext
94 lines
2.5 KiB
Plaintext
= 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
|
|
---------
|