~ubuntu-branches/ubuntu/precise/iproute/precise

« back to all changes in this revision

Viewing changes to debian/man/ss.8

  • Committer: Bazaar Package Importer
  • Author(s): Alexander Wirt, Andreas Henriksson, Ben Finney, Justin Pryzby, Daniel Silverstone, Alexander Wirt
  • Date: 2007-12-16 14:30:31 UTC
  • mfrom: (1.1.5 upstream)
  • Revision ID: james.westby@ubuntu.com-20071216143031-cbd111kybw3o9mpv
Tags: 20071016-1
[ Andreas Henriksson ]
* New upstream release (v2.6.23 aka snapshot 071016) (Closes: #445944)
  - time2tick overflow patch applied upstream (Closes: #175462)
  - tc ematch cmp/nbyte help patch applied upstream (Closes: #438653)
  - mpath support dropped upstream (Closes: #428440, #428442)
  - new manpages included upstream (Closes: #438994)
  - linux header files updated to v2.6.23 (Closes: #409047)
* Drop patches which has been applied upstream or deprecated by
  upstream changes.
  - debian/patches/lartc applied upstream.
  - debian/patches/netbug_fix deprecated, upstream dropped netbug script.
  - debian/patches/empty_linkname.dpatch deprecated, fixed upstream.
* Add .dpatch suffix to wrr-qdisc patch to make dpatch-edit-patch work.
* Update patches to apply:
  - wrr-qdisc, moo, ip_route_usage
* Don't install removed netbug script.
* Fix corruption when using batch files with comments and broken
  lines. (cherry-picked from upstream. Closes: #398912)
* Update build-dependencies:
  - libdb4.3-dev -> libdb-dev. (Closes: #442653)
  - linux-kernel-headers -> linux-libc-dev.
* Drop debian/patches/ip_address_flush_loop.dpatch,
  instead we'll use Daniel Silverstones patch imported from Ubuntu.
* Add Homepage and Vcs-{Browser,Git} fields to debian/control.
* Remove dead/leftover code from tc/q_htb.c, include/linux/pkt_sched.h
* Remove outdated README.Debian.
* Drop our own (buggy) RTAX_INITCWND support, in favor of upstreams.
* fix dotted-quad support patch to work on big-endian.
  (upstream applied a broken patch, which we cherry-picked for #357172)

[ Ben Finney ]
* Add dh_md5sums to generate md5sums control file (Closes: #439439)

[ Justin Pryzby ]
* ss(8) manpage formatting breaks EXAMPLE (Closes: #443071)

[ Daniel Silverstone ]
* Avoid infinite loop in ip addr flush.

[ Alexander Wirt ]
* Add Andreas Henriksson to uploaders
* Bump standards version
* Support dotted-quad netmasks in iproute (Closes: #357172) (Cherry picked
  from upstream)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH SS 8
2
 
.SH NAME
3
 
ss \- another utility to investigate sockets
4
 
.SH SYNOPSIS
5
 
.B ss
6
 
.RI [ options ] " [ FILTER ]"
7
 
.SH DESCRIPTION
8
 
.B ss
9
 
is used to dump socket statistics. It allows showing information similar
10
 
to
11
 
.IR netstat .
12
 
It can display more TCP information than state than other tools.
13
 
 
14
 
.SH OPTIONS
15
 
These programs follow the usual GNU command line syntax, with long
16
 
options starting with two dashes (`-').
17
 
A summary of options is included below.
18
 
.TP
19
 
.B \-h, \-\-help
20
 
Show summary of options.
21
 
.TP
22
 
.B \-V, \-\-version
23
 
Output version information.
24
 
.TP
25
 
.B \-n, \-\-numeric
26
 
Do now try to resolve service names.
27
 
.TP
28
 
.B \-r, \-\-resolve
29
 
Try to resolve numeric address/ports.
30
 
.TP
31
 
.B \-a, \-\-all
32
 
Display all sockets.
33
 
.TP
34
 
.B \-l, \-\-listening
35
 
Display listening sockets.
36
 
.TP
37
 
.B \-o, \-\-options
38
 
Show timer information.
39
 
.TP
40
 
.B \-e, \-\-extended
41
 
Show detailed socket information
42
 
.TP
43
 
.B \-m, \-\-memory
44
 
Show socket memory usage.
45
 
.TP
46
 
.B \-p, \-\-processes
47
 
Show process using socket.
48
 
.TP
49
 
.B \-i, \-\-info
50
 
Show internal TCP information.
51
 
.TP
52
 
.B \-s, \-\-summary
53
 
Print summary statistics. This option does not parse socket lists obtaining
54
 
summary from various sources. It is useful when amount of sockets is so huge
55
 
that parsing /proc/net/tcp is painful.
56
 
.TP
57
 
.B \-4, \-\-ipv4
58
 
Display only IP version 4 sockets (alias for -f inet).
59
 
.TP
60
 
.B \-6, \-\-ipv6
61
 
Display only IP version 6 sockets (alias for -f inet6).
62
 
.TP
63
 
.B \-0, \-\-packet
64
 
Display PACKET sockets.
65
 
.TP
66
 
.B \-t, \-\-tcp
67
 
Display only TCP sockets.
68
 
.TP
69
 
.B \-u, \-\-udp
70
 
Display only UDP sockets.
71
 
.TP
72
 
.B \-d, \-\-dccp
73
 
Display only DCCP sockets.
74
 
.TP
75
 
.B \-w, \-\-raw
76
 
Display only RAW sockets.
77
 
.TP
78
 
.B \-x, \-\-unix
79
 
Display only Unix domain sockets.
80
 
.TP
81
 
.B \-f FAMILY, \-\-family=FAMILY
82
 
Display sockets of type FAMILY.
83
 
Currently the following families are supported: unix, inet, inet6, link, netlink.
84
 
.TP
85
 
.B \-A QUERY, \-\-query=QUERY
86
 
List of socket tables to dump, separated by commas. The following identifiers
87
 
are understood: all, inet, tcp, udp, raw, unix, packet, netlink, unix_dgram,
88
 
unix_stream, packet_raw, packet_dgram.
89
 
.TP
90
 
.B \-D FILE
91
 
Do not display anything, just dump raw information about TCP sockets to FILE after applying filters. If FILE is - stdout is used.
92
 
.TP
93
 
.B \-F FILE, \-\-filter=FILE
94
 
Read filter information from FILE.
95
 
Each line of FILE is interpreted like single command line option. If FILE is - stdin is used.
96
 
.TP
97
 
.B FILTER := [ state TCP-STATE ] [ EXPRESSION ]
98
 
Please take a look at the official documentation (Debian package iproute-doc) for details regarding filters.
99
 
.SH USAGE EXAMPLES
100
 
.TP
101
 
.B ss -t -a
102
 
Display all TCP sockets.
103
 
.TP
104
 
.B ss -u -a
105
 
Display all UDP sockets.
106
 
.TP
107
 
.B ss -o state established '( dport = :ssh or sport = :ssh )'
108
 
Display all established ssh connections.
109
 
.TP
110
 
.B ss -x src \"/tmp/.X11-unix/*\"
111
 
Find all local processes connected to X server.
112
 
.TP
113
 
.B ss -o state fin-wait-1 '( sport = :http or sport = :https )' dst 193.233.7/24
114
 
List all the tcp sockets in state FIN-WAIT-1 for our apache to network 193.233.7/24 and look at their timers.
115
 
.SH SEE ALSO
116
 
.BR ip (8),
117
 
.BR /usr/share/doc/iproute-doc/ss.html " (package iproute�doc)"
118
 
.SH AUTHOR
119
 
.I ss 
120
 
was written by Alexey Kuznetosv, <kuznet@ms2.inr.ac.ru>.
121
 
.PP
122
 
This manual page was written by Michael Prokop <mika@grml.org>
123
 
for the Debian project (but may be used by others).