.\" Text automatically generated by txt2man
.TH packetsender 1 "27 Apr 2020" "packetsender-6.2.6" "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 this help.
.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).
.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-n\fP, \fB--name\fP <name>
Send previously saved packet named <name>. Other \fIoptions\fP
overrides saved packet parameters.
.RE
.PP
Arguments:
.RS
.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 packetsender.com, \fIport\fP 22. The command will wait 500 ms for a
reply.
.PP
.nf
.fam C
    $ packetsender -taw 500 packetsender.com 22 "Hello\\nWorld"

.fam T
.fi
The command below uses SSL and will ignore or abandon on SSL errors. The
default is to ignore.
.PP
.nf
.fam C
    $ packetsender -saw 500 expired.packetsender.com 443 "GET / HTTP/1.0\\r\\n\\r\\n"

.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:
.PP
.nf
.fam C
      https://packetsender.com

.fam T
.fi
This manual page was written by Joao Eriberto Mota Filho <eriberto@debian.org>
for the Debian project (but may be used by others).