tcpbug(1)

tcpbug1

Tcp/ip connection bugging device

Usage

tcpbug [-cx] [-btT] local-port remote-host remote-port

Overview

tcpbug forwards a TCP/IP connection to port local-port on the local machine to the port remote-port on remote-host while spying on the connection and writing all data passing through to standard output. All data coming from the client is printed with a greater than sign (>) first on each line, and all data coming from the server is printed with a less than sign (<) first on each line. Any byte offsets and time-stamps are printed before the greater than or less than sign, and are separated from each other by a colon (:).

Options

-b

Print the offset of the first byte in the stream for each line.

-c

Display bytes as individual characters. Printable characters are displayed directly, some control characters appear as C-language escapes (\n, \r, \t et.c), while others appear as 3-digit octal numbers. This should be similar to the -c switch of od(1).

-t

Print the time at which the data was received for each line. The time is the number of seconds and microseconds, separated by a decimal point (.), since 00:00 UTC, January 1, 1970, as reported by gettimeofday().

-T

Print the time at which the data was received for each line. The time is the number of seconds and microseconds, separated by a decimal point (.), since the connections were established.

-x

Display each byte as a two digit hexadecimal number.

Releases

14 releases since Debian 2.1 (Slink); the text changed 1 time.

  1. 2.1–8
  2. 9–13

Bugs

The names of the options are not yet finalized, and may change at a future release.

From tcputils 0.6.2+git20120127.c28952d-0.1 in Debian 13 (Trixie). Parsed by carta from the page's man source.