gerrit/Documentation/cmd-show-connections.txt
Shawn O. Pearce 099dc176cc Correct SSH Username to be just Username
Slightly clarify the UI to just say Username now, since that's
the name we use internally in the code, and in the database.

Change-Id: Ide4a10f6b2795ea8ba30d3aff22c0672bba5bd91
Signed-off-by: Shawn O. Pearce <sop@google.com>
2010-01-15 09:41:30 -08:00

84 lines
2.0 KiB
Plaintext

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
-------
Session::
Unique session identifier on this server. Session
identifiers have a period of 2\^32-1 and start from a
random value.
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 username 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.
EXAMPLES
--------
With reverse DNS lookup (default):
====
$ ssh -p 29418 review.example.com gerrit show-connections
Session Start Idle User Remote Host
--------------------------------------------------------------
3abf31e6 20:09:02 00:00:00 jdoe jdoe-desktop.example.com
--
====
Without reverse DNS lookup:
====
$ ssh -p 29418 review.example.com gerrit show-connections -n
Session Start Idle User Remote Host
--------------------------------------------------------------
3abf31e6 20:09:02 00:00:00 a/1001240 10.0.0.1
--
====
GERRIT
------
Part of link:index.html[Gerrit Code Review]