FreeBSD manual
download PDF document: tcpdrop.8.pdf
TCPDROP(8) FreeBSD System Manager's Manual TCPDROP(8)
NAME
tcpdrop - drop TCP connections
SYNOPSIS
tcpdrop local-address local-port foreign-address foreign-port
tcpdrop [-l] -a
tcpdrop [-l] -C cc-algo [-S stack] [-s state]
tcpdrop [-l] [-C cc-algo] -S stack [-s state]
tcpdrop [-l] [-C cc-algo] [-S stack] -s state
DESCRIPTION
The tcpdrop command may be used to drop TCP connections from the command
line.
If -a is specified then tcpdrop will attempt to drop all TCP connections.
If -C cc-algo is specified then tcpdrop will attempt to drop all
connections using the TCP congestion control algorithm cc-algo.
If -S stack is specified then tcpdrop will attempt to drop all
connections using the TCP stack stack.
If -s state is specified then tcpdrop will attempt to drop all TCP
connections being in the state state. state is one of SYN_SENT,
SYN_RCVD, ESTABLISHED, CLOSE_WAIT, FIN_WAIT_1, CLOSING, LAST_ACK,
FIN_WAIT_2, or TIME_WAIT.
If multiple of -C cc-algo, -S stack, and -s state are specified, tcpdrop
will attempt to drop all TCP connections using the congestion control
algorithm cc-algo, being in the state state, and using the TCP stack
stack, if specified. Since TCP connections in the TIME_WAIT state are
not tied to any TCP stack, using the option -s TIME_WAIT in combination
with the -S stack option results in tcpdrop not dropping any TCP
connection.
The -l flag may be given in addition to the -a, -C, -S, or -s options to
list the tcpdrop invocation to drop all corresponding TCP connections one
at a time.
If none of the -a, -C, -S, or -s options are specified then only the
connection between the given local address local-address, port
local-port, and the foreign address foreign-address, port foreign-port,
will be dropped.
Addresses and ports may be specified by name or numeric value. Both IPv4
and IPv6 address formats are supported.
The addresses and ports may be separated by periods or colons instead of
spaces.
EXIT STATUS
The tcpdrop utility exits 0 on success, and >0 if an error occurs.
EXAMPLES
If a connection to httpd(8) is causing congestion on a network link, one
can drop the TCP session in charge:
The following command will drop all connections but those to or from port
22, the port used by sshd(8):
# tcpdrop -l -a | grep -vw 22 | sh
To drop all TCP connections using the new-reno congestion control
algorithm use:
# tcpdrop -C new-reno
The following command will drop all connections using the TCP stack rack:
# tcpdrop -S rack
To drop all TCP connections in the LAST_ACK state use:
# tcpdrop -s LAST_ACK
To drop all TCP connections using the congestion control algorithm new-
reno and the TCP stack rack and being in the LAST_ACK state use:
# tcpdrop -C new-reno -S rack -s LAST_ACK
SEE ALSO
netstat(1), sockstat(1), tcp(4), tcp_functions(9)
AUTHORS
Markus Friedl <markus@openbsd.org>
Juli Mallett <jmallett@FreeBSD.org>
FreeBSD 14.0-RELEASE-p11 December 4, 2021 FreeBSD 14.0-RELEASE-p11