blob: b38d7f28378c0e4a4ac7c64b3b307b306b26f501 [file] [log] [blame]
gerrit show-connections
=======================
NAME
----
gerrit show-connections - Display active client SSH connections
SYNOPSIS
--------
[verse]
'ssh' -p <port> <host> 'gerrit show-connections' [-n]
DESCRIPTION
-----------
Presents a table of the active SSH connections, the users who
are currently connected to the internal server and performing
an activity.
ACCESS
------
Caller must be a member of the privileged 'Administrators' group.
SCRIPTING
---------
Intended for interactive use only.
OPTIONS
-------
-n::
\--numeric::
Show client hostnames as IP addresses instead of DNS hostname.
DISPLAY
-------
Start::
Time (local to the server) that this connection started.
Idle::
Time since the last data transfer on this connection.
Note that most SSH clients use not only a TCP based
connection keep-alive, but also an encrypted keep alive
higher up in the SSH protocol stack. That higher keep
alive resets the idle timer, about once a minute.
User::
The SSH User Name of the account that is authenticated on
this connection. If the -n option is used, this column
shows the Account Id instead.
Remote Host::
Reverse lookup hostname, or if -n option is used, the remote
IP address.
[ second line ]::
Command(s) actively being executed on this connection.
With SSH channel multiplexing a single connection can
perform multiple commands, or a connection can be idle,
performing nothing at all.
EXAMPLES
--------
With reverse DNS lookup (default):
====
$ ssh -p 29418 review.example.com gerrit show-connections
Start Idle User Remote Host
--------------------------------------------------------------
14:02:47 00:00:00 jdoe jdoe-desktop.example.com
[ gerrit-show-connections ]
--
====
Without reverse DNS lookup:
====
$ ssh -p 29418 review.example.com gerrit show-connections -n
Start Idle User Remote Host
--------------------------------------------------------------
14:02:48 00:00:00 a/1001240 10.0.0.1
[ gerrit-show-connections -n ]
--
====
GERRIT
------
Part of link:index.html[Gerrit Code Review]