Command arguments

This document is description of ipsend’s command arguments.

General and Debugging

--verbose

Verbose mode. Level - 1:TRACE_ERROR, 2:INFO, 3:DEBUG.

  • Type: int

  • Default: 0

  • Choices:

Value

Description

1

TRACE_ERROR. Output error with trace.

2

INFO. Output setting values and internal values.

3

DEBUG. Output maximum debug information.

  • Example:

--verbose=1
--verbose=2
--verbose=3

--debug

--debug is equivalent to --verbose=3.

  • Type: bool

  • Default: False

  • Example:

--debug

--log

Verbose log filename.

  • Type: str

  • Default: None

  • Example:

--log=verbose.log

Primary options

--mode

Transmission mode. Default: TCP.

  • Type: str

  • Default: TCP

  • Choices: TCP, UDP, SSL, IP_HEADER, TCP_HEADER, UDP_HEADER, ICMP_HEADER, IP_PAYLOAD, TCP_PAYLOAD, UDP_PAYLOAD, ICMP_PAYLOAD

Value

Description

TCP

TCP protocol.

UDP

UDP protocol.

SSL

SSL protocol.

IP_HEADER

IP Header which contains Protocol headers and payload.

TCP_HEADER

TCP Header which contains payload.

UDP_HEADER

UDP Header which contains payload.

ICMP_HEADER

ICMP Header which contains payload.

IP_PAYLOAD

IP Payload. The header data is generated by parameters automatically.

TCP_PAYLOAD

TCP Payload. The header data is generated by parameters automatically.

UDP_PAYLOAD

UDP Payload. The header data is generated by parameters automatically.

ICMP_PAYLOAD

ICMP Payload. The header data is generated by parameters automatically.

  • Example:

--mode=TCP
--mode=UDP
--mode=SSL

--input

Input format. Default: TEXT.

  • Type: str

  • Default: TEXT

  • Choices: TEXT, BINARY, HEX, BASE64

Value

Description

TEXT

Text format

BINARY

Binary format

HEX

Hexadecimal format

BASE64

Base64 encoded format

  • Example:

--input=TEXT
--input=BINARY

--output

Output format. Default: TEXT.

  • Type: str

  • Default: TEXT

  • Choices: NONE, TEXT, BINARY, HEX, BASE64

Value

Description

TEXT

Text format

BINARY

Binary format

HEX

Hexadecimal format

BASE64

Base64 encoded format

  • Example:

--output=TEXT
--output=HEX

--interactive

Enable INTERACTIVE mode.

  • Type: int

  • Default: 0

Value

Description

0

INSTANT mode.

1

Enable INTERACTIVE mode. Line-break to send.

2

Enable INTERACTIVE mode. Ctrl-key to send

  • Example:

--interactive=1
--interactive=2

--ssl_context

SSL context in SSL protocol.

  • Type: str

  • Default: None

  • Choices: SSLV3, TLS1.0, TLS1.1, TLS1.2, TLS1.3

  • Example:

--ssl_context=TLS1.2

--output_send

Output Send-data in INSTANT mode.

  • Type: int

  • Default: 0

Value

Description

1

Output & Send.

2

Only output.

  • Example:

--output_send=1

--auto_nl

Append Line-break in INSTANT mode and TEXT input format.

  • Type: bool

  • Default: True

  • Example:

--auto_nl=True

--dest

Destination IP or Hostname.

  • Type: str

  • Default: ''

  • Example:

--dest=google.com
--dest=192.168.1.100

--port

Destination port.

  • Type: int

  • Default: 0

  • Example:

--port=80
--port=443

--dumpfile

Dump response data to files. Dir: ./dump_logs/

  • Type: bool

  • Default: False

  • Example:

--dumpfile

--timeout

Timeout. Default: 20.0

  • Type: float

  • Default: 20.0

  • Example:

--timeout=30.0

Header mode options

Header mode options is available only in IP_HEADER, TCP_HEADER, UDP_HEADER, ICMP_HEADER, IP_PAYLOAD, TCP_PAYLOAD, UDP_PAYLOAD, ICMP_PAYLOAD mode.

--ip_flags

IP flags.

  • Type: int

  • Default: 0

  • Example:

--ip_flags=2

--ip_identification

IP identification.

  • Type: int

  • Default: 0

  • Example:

--ip_identification=12345

--ip_ttl

IP TTL.

  • Type: int

  • Default: 64

  • Example:

--ip_ttl=128

--ip_protocol

IP Protocol number.

  • Type: int

  • Default: 6

  • Example:

--ip_protocol=17

--src_ip

Source IP.

  • Type: str

  • Default: ''

  • Example:

--src_ip=192.168.1.1

--src_port

Source port.

  • Type: int

  • Default: 0

  • Example:

--src_port=12345

--dest_ip

Destination IP.

  • Type: str

  • Default: ''

  • Example:

--dest_ip=8.8.8.8

--dest_port

Destination port.

  • Type: int

  • Default: 0

  • Example:

--dest_port=80

--tcp_flags

TCP flags. ex: FIN,SYN,RST,PSH,ACK

  • Type: str

  • Default: ''

  • Example:

--tcp_flags=SYN,ACK

--tcp_seq

TCP sequence number.

  • Type: int

  • Default: 0

  • Example:

--tcp_seq=12345

--tcp_ack

TCP acknowledgment number.

  • Type: int

  • Default: 0

  • Example:

--tcp_ack=12346

--tcp_window

TCP window size.

  • Type: int

  • Default: 0

  • Example:

--tcp_window=65535

--icmp_type

ICMP type.

  • Type: int

  • Default: 0

  • Example:

--icmp_type=8

--icmp_code

ICMP code.

  • Type: int

  • Default: 0

  • Example:

--icmp_code=0

--icmp_id

ICMP identifier.

  • Type: int

  • Default: 0

  • Example:

--icmp_id=12345

--icmp_seq

ICMP sequence number.

  • Type: int

  • Default: 0

  • Example:

--icmp_seq=1

Shortcut

-I

-I is equivalent to --interactive=1.

  • Type: bool

  • Default: False

  • Example:

ipsend --dest=wikipedia.org --port=80 -I

--http

--http is equivalent to --port=80.

  • Type: bool

  • Default: False

  • Example:

ipsend --dest=wikipedia.org --port=80 --http

--https

--https is equivalent to --port=443 --mode=SSL.

  • Type: bool

  • Default: False

  • Example:

ipsend --dest=wikipedia.org --port=80 --https

Miscellaneous

--version

Show version information.

  • Type: bool

  • Default: False

  • Example:

ipsend --version