.\" Text automatically generated by txt2man
.TH packetsender 1 "03 Mar 2022" "packetsender-8.0.9" "Network utility for sending and receiving TCP, UDP, SSL packets"
.SH NAME
\fBpacketsender \fP- Network utility for sending and receiving TCP, UDP, SSL packets
\fB
.SH SYNOPSIS
.nf
.fam C
\fBpacketsender\fP [\fIoptions\fP] \fIaddress\fP \fIport\fP \fIdata\fP

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
Packet Sender is a utility that sends and receives TCP, UDP and SSL (encrypted
TCP) packets on the ports of your choosing. It supports IPv4 and IPv6 and
provides a GUI for final users. However, is also possible use Packet Sender in
text mode via command line.
.PP
Some features:
.RS
.IP \(bu 3
Can act as client/server to send and receive network traffic.
.IP \(bu 3
A payload can be created in ASCII or hex.
.IP \(bu 3
Command line mode is available for automation and scripting.
.IP \(bu 3
Packet Sender cloud is a disposable resource to be used to publicly
display and distribute packets (via an URL) for collaboration, tutorials,
end users, etc. Packet Sender may import public packet sets with
public URL.
.RE
.PP
Some uses:
.RS
.IP \(bu 3
Control network-based devices in ways beyond their original apps.
.IP \(bu 3
Test automation (using command line tool and/or hotkeys).
.IP \(bu 3
Test network APIs (using the built-in TCP, UDP, SSL clients).
.IP \(bu 3
Malware analysis (using the built-in UDP, TCP, SSL servers).
.IP \(bu 3
Troubleshoot secure connections (using SSL).
.IP \(bu 3
Test network connectivity/firewalls (by having 2 Packet Senders talk
to each other).
.IP \(bu 3
Stress-test a device (using intense network generator tool).
.IP \(bu 3
Tech support (by sending customers a portable Packet Sender with
pre-defined settings and packets).
.IP \(bu 3
Share/Save/Collaborate using the Packet Sender Cloud service.
.SH OPTIONS
.TP
.B
\fB-h\fP, \fB--help\fP
Displays help on commandline \fIoptions\fP.
.TP
.B
\fB--help-all\fP
Displays help including Qt specific \fIoptions\fP.
.TP
.B
\fB-v\fP, \fB--version\fP
Displays version information.
.TP
.B
\fB-q\fP, \fB--quiet\fP
Quiet mode. Only output received \fIdata\fP.
.TP
.B
\fB-x\fP, \fB--hex\fP
Parse \fIdata\fP-to-send as hex (default).
.TP
.B
\fB-a\fP, \fB--ascii\fP
Parse \fIdata\fP-to-send as mixed-ascii (like the GUI).
.TP
.B
\fB-A\fP, \fB--ASCII\fP
Parse \fIdata\fP-to-send as pure ascii (no \\xx translation).
.TP
.B
\fB-w\fP, \fB--wait\fP <ms>
Wait up to <milliseconds> for a response after sending.
Zero means do not wait (Default). It is compulsory if a
reply from a server, as an HTTP server, is needed. In this
case, \fB-w\fP 500 is a good start value.
.TP
.B
\fB-f\fP, \fB--file\fP <path>
Send contents of specified path. Max 10 MiB for UDP, 100
MiB for TCP/SSL.
.TP
.B
\fB-b\fP, \fB--bind\fP <\fIport\fP>
Bind \fIport\fP. Default is 0 (dynamic).
.TP
.B
\fB-6\fP, \fB--ipv6\fP
Force IPv6. Same as \fB-B\fP "::". Default is IP:Any.
.TP
.B
\fB-4\fP, \fB--ipv4\fP
Force IPv4.  Same as \fB-B\fP "0.0.0.0". Default is IP:Any.
.TP
.B
\fB-B\fP, \fB--bindip\fP <IP>
Bind custom IP. Default is IP:Any.
.TP
.B
\fB-t\fP, \fB--tcp\fP
Send TCP (default).
.TP
.B
\fB-s\fP, \fB--ssl\fP
Send SSL and ignore errors.
.TP
.B
\fB-S\fP, \fB--SSL\fP
Send SSL and stop for errors.
.TP
.B
\fB-u\fP, \fB--udp\fP
Send UDP.
.TP
.B
\fB--http\fP
Send HTTP.
.TP
.B
\fB-n\fP, \fB--name\fP <name>
Send previously saved packet named <name>. Other \fIoptions\fP
overrides saved packet parameters.
.TP
.B
\fB--bps\fP <bps>
Intense traffic. Calculate rate based on value of
bits per second.
.TP
.B
\fB--num\fP <number>
Intense traffic. Number of packets to send. Default
unlimited.
.TP
.B
\fB--rate\fP <Hertz>
Intense traffic. Rate. Ignored in bps option.
.TP
.B
\fB--usdelay\fP <microseconds>
Intense traffic. Resend delay. Used if rate is 0.
Ignored in bps option.
.PP
Arguments:
.TP
.B
\fIaddress\fP
Destination \fIaddress\fP. Optional for saved packet.
.TP
.B
\fIport\fP
Destination \fIport\fP. Optional for saved packet.
.TP
.B
\fIdata\fP
Data to send. Optional for saved packet.
.SH EXAMPLES
The following command line will send a TCP packet, with a mixed-ascii as
payload, to example.com, \fIport\fP 22. The command will wait 500 ms for a
reply.
.PP
.nf
.fam C
    $ packetsender -taw 500 example.com 22 "Hello\\nWorld"

.fam T
.fi
Similar to last command, but the TCP packet will be sent to \fIport\fP 21. An
anonymous authentication will be used.
.PP
.nf
.fam C
    $ packetsender -taw 500 example.com 21 "USER anonymous\\r\\nPASS chrome@example.com\\r\\n"

.fam T
.fi
The command below uses SSL and will ignore SSL errors. The command will
wait 500 ms for a reply.
.PP
.nf
.fam C
    $ packetsender -saw 500 expired.packetsender.com 443 "GET / HTTP/1.0\\r\\n\\r\\n"

.fam T
.fi
Other good example how to access a homepage:
.PP
.nf
.fam C
    $ packetsender -w 500 -a example.com 80 "GET / HTTP/1.1\\r\\nHost: example.com\\r\\n\\r\\n"

.fam T
.fi
Packet Sender command line also can bind to custom ports to force IPv4/6 modes
or multiple NIC, as shown below:
.PP
.nf
.fam C
    $ packetsender -taw 3000 fe80::c07b:d517:e339:5a08 5005 "Hello\\r"
    $ packetsender -taw 3000 192.168.0.201 5005 "Hello\\r"
    $ packetsender -B 192.168.0.200 -taw 3000 192.168.0.201 5005 "Hello\\r"
    $ packetsender -B fe80::a437:399a:3091:266a%ethernet_32769 -taw 3000 fe80::c07b:d517:e339:5a08 5005 "Hello\\r"
    $ packetsender -B fe80::a437:399a:3091:266a -taw 3000 fe80::c07b:d517:e339:5a08 5005 "Hello\\r"

.fam T
.fi
.SH SEE ALSO
\fBtcpdump\fP(8), \fBwireshark\fP(1), https://packetsender.com/documentation
.SH AUTHOR
Packet Sender was written by Dan Nagle <dan@dannagle.com> and is available at
https://packetsender.com
.PP
This manual page was written by Joao Eriberto Mota Filho <eriberto@debian.org>
for the Debian project (but may be used by others).