Documentation > Userspace Application Arguments > --session
--session
Index
Description
Sessions mostly exist so the NAT64 can decide when BIB entries should die. You can also use them to know exactly who is speaking to your IPv6 nodes.
Each BIB entry is a mapping, which describes the IPv4 name of one of your IPv6 services. For every BIB entry, there are zero or more session entries, each of which represents an active connection currently using that mapping.
You can use this command to get information on each of these connections.
Syntax
jool --session [--tcp] [--udp] [--icmp] (
[--display] [--numeric] [--csv]
| --count
)
Arguments
Operations
--display
: The session tables are printed in standard output. This is the default operation.--count
: The number of entries per session table are printed in standard output.
Options
Flag | Description |
--tcp |
If present, the command operates on the TCP table. |
--udp |
If present, the command operates on the UDP table. |
--icmp |
If present, the command operates on the ICMP table. |
--numeric |
By default, the application will attempt to resolve the names of the remote nodes talking in each session. If your nameservers aren’t answering, this will slow the output down. Use --numeric to turn this behavior off. |
--csv |
Print the table in Comma/Character-Separated Values format. This is intended to be redirected into a .csv file. Because every record is printed in a single line, CSV is also better for grepping. |
--tcp
, --udp
and --icmp
are not mutually exclusive. If neither of them are present, the records are added or removed to/from all three protocols.
Examples
ipv6client.mx makes two HTTP requests and a ping to example.com.
Fall back to display all protocols, resolve names, console format:
$ jool --session
TCP:
---------------------------------
(V4_FIN_V6_FIN_RCV) Expires in 2 minutes, 57 seconds
Remote: example.com#http ipv6client.mx#58239
Local: 192.0.2.1#60477 64:ff9b::5db8:d877#80
---------------------------------
(V4_FIN_V6_FIN_RCV) Expires in 3 minutes, 52 seconds
Remote: example.com#http ipv6client.mx#58237
Local: 192.0.2.1#6617 64:ff9b::5db8:d877#80
---------------------------------
(Fetched 2 entries.)
UDP:
---------------------------------
(empty)
ICMP:
---------------------------------
Expires in 50 seconds
Remote: example.com#1402 ipv6client.mx#13371
Local: 192.0.2.1#1402 64:ff9b::5db8:d877#13371
---------------------------------
(Fetched 1 entries.)
Filter out UDP and ICMP, do not query the DNS, console format:
$ jool --session --display --tcp --numeric
TCP:
---------------------------------
(V4_FIN_V6_FIN_RCV) Expires in 2 minutes, 57 seconds
Remote: 93.184.216.119#80 2001:db8::2#58239
Local: 192.0.2.1#60477 64:ff9b::5db8:d877#80
---------------------------------
(V4_FIN_V6_FIN_RCV) Expires in 3 minutes, 52 seconds
Remote: 93.184.216.119#80 2001:db8::2#58237
Local: 192.0.2.1#6617 64:ff9b::5db8:d877#80
---------------------------------
(Fetched 2 entries.)
Do not resolve names, CSV format:
$ jool --session --display --numeric --csv > session.csv
Just display the number of records of every table:
$ jool --session --count
TCP: 2
UDP: 0
ICMP: 1