Google Git
Sign in
gerrit / gerrit / 044a6c983f537598b4275c19ba2be481c099b329 / . / Documentation / cmd-show-connections.txt
blob: 10d3375e5b02cd4efa2bf3be90b46e8b39555486 [file] [log] [blame]
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]1gerrit show-connections
2=======================
3
4NAME
5----
6gerrit show-connections - Display active client SSH connections
7
8SYNOPSIS
9--------
Yuxuan 'fishy' Wangd85b6872013-11-15 11:47:46 -0800[diff] [blame]10--
Edwin Kempin73b26982012-07-16 13:53:22 +0200[diff] [blame]11'ssh' -p <port> <host> 'gerrit show-connections' [--numeric | -n]
Yuxuan 'fishy' Wangd85b6872013-11-15 11:47:46 -0800[diff] [blame]12--
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]13
14DESCRIPTION
15-----------
16Presents a table of the active SSH connections, the users who
17are currently connected to the internal server and performing
18an activity.
19
20ACCESS
21------
Shawn O. Pearce7f485142011-06-16 13:49:42 -0700[diff] [blame]22Caller must be a member of the privileged 'Administrators' group,
Fredrik Luthander48603002012-03-21 18:17:17 +0100[diff] [blame]23or have been granted
24link:access-control.html#capability_viewConnections[the 'View Connections' global capability].
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]25
26SCRIPTING
27---------
28Intended for interactive use only.
29
30OPTIONS
31-------
Shawn O. Pearce47769242011-06-14 16:40:48 -0700[diff] [blame]32--numeric::
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]33-n::
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]34 Show client hostnames as IP addresses instead of DNS hostname.
35
Doug Kelly6599d772013-06-11 01:36:31 -0500[diff] [blame]36--wide::
37-w::
38 Do not format the output to the terminal width (default of
39 80 columns).
40
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]41DISPLAY
42-------
43
Shawn O. Pearce3f1a13a2009-11-20 20:15:41 -0800[diff] [blame]44Session::
45 Unique session identifier on this server. Session
Shawn O. Pearce47769242011-06-14 16:40:48 -0700[diff] [blame]46 identifiers have a period of 2^32-1 and start from a
Shawn O. Pearce3f1a13a2009-11-20 20:15:41 -0800[diff] [blame]47 random value.
48
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]49Start::
50 Time (local to the server) that this connection started.
51
52Idle::
53 Time since the last data transfer on this connection.
54 Note that most SSH clients use not only a TCP based
55 connection keep-alive, but also an encrypted keep alive
56 higher up in the SSH protocol stack. That higher keep
57 alive resets the idle timer, about once a minute.
58
59User::
Shawn O. Pearce099dc172010-01-15 09:41:17 -0800[diff] [blame]60 The username of the account that is authenticated on this
61 connection. If the -n option is used, this column shows
62 the Account Id instead.
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]63
64Remote Host::
65 Reverse lookup hostname, or if -n option is used, the remote
66 IP address.
67
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]68EXAMPLES
69--------
70
71With reverse DNS lookup (default):
72====
73 $ ssh -p 29418 review.example.com gerrit show-connections
Shawn O. Pearce3f1a13a2009-11-20 20:15:41 -0800[diff] [blame]74 Session Start Idle User Remote Host
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]75 --------------------------------------------------------------
Shawn O. Pearce3f1a13a2009-11-20 20:15:41 -0800[diff] [blame]76 3abf31e6 20:09:02 00:00:00 jdoe jdoe-desktop.example.com
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]77 --
78====
79
80Without reverse DNS lookup:
81====
82 $ ssh -p 29418 review.example.com gerrit show-connections -n
Shawn O. Pearce3f1a13a2009-11-20 20:15:41 -0800[diff] [blame]83 Session Start Idle User Remote Host
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]84 --------------------------------------------------------------
Shawn O. Pearce3f1a13a2009-11-20 20:15:41 -0800[diff] [blame]85 3abf31e6 20:09:02 00:00:00 a/1001240 10.0.0.1
Shawn O. Pearce4016a932009-05-28 15:12:40 -0700[diff] [blame]86 --
87====
Shawn O. Pearce5500e692009-05-28 15:55:01 -0700[diff] [blame]88
89GERRIT
90------
91Part of link:index.html[Gerrit Code Review]
Yuxuan 'fishy' Wang99cb68d2013-10-31 17:26:00 -0700[diff] [blame]92
93SEARCHBOX
94---------