Welcome to IpSurv¶
Welcome to IpSurv’s documentation! IpSurv are investigation tools for surveying IP addresses, network investigation, test and debugging - “ipsurv, ipscap, ipsend”. Those tools allow for packet capture, such as tcpdump, and packet sending tests. Each tools and internal program are extensible using Python.
Github¶
The latest version and documentation may be found on GitHub. The Github URL is the following.
Commands¶
Command |
Description |
|---|---|
ipsurv |
ipsurv is a surveying IP tool. You can conduct bulk surveys of specified IPs, URLs, and more. It also allows retrieving country codes for IP addresses, performing ping tests, and checking ports. |
ipscap |
ipscap is a packet capture tool like tcpdump which supports “ICMP, TCP, UDP” protocols. ipscap has various filtering options, displays IP-header and TCP-header, UDP-header, and dumping files functions.
|
ipsend |
ipsend is a network transmission tool that supports TCP, SSL, UDP, and Raw sockets, as well as interactive transmission. |
ipserver |
ipserver is simple server on “TCP, UDP, SSL, HTTP, HTTPS” for debugging or network investigation. https://github.com/deer-hunt/ipserver. |
It’s best to refer to the help to recognize the functions.
$ ipsurv --help
# ipscap --help
$ ipsend --help
Installation¶
PyPI
$ pip install ipsurv
or
$ pip3 install ipsurv
Conda
$ conda install conda-forge::ipsurv
ipscap is also installed with it.
Requirements¶
"python" and "pip" command
Python 3.0 or later version.
If you use in Python 3.0 - 3.2, please run
`pip install ipaddress`.If you’d like to use in Python 2.7, you can refactor to Python 2.7 code easily. See “development_debug.md”.
“ipsurv” command¶
Introduction¶
Usage
$ cat ips.txt|ipsurv 192.168.1.10
$ ipsurv 192.168.1.10 192.168.1.11
$ ipsurv wikipedia.org
$ ipsurv https://anaconda.org/ --format=web --http=1
$ ipsurv 192.168.1.10 --host_only
# Use GeoIP2: Dependency "geoip2" module.
$ ipsurv wikipedia.org --geoip_only
# Survey self IP
$ ipsurv self
Command options
“ipsurv” have many Command options. For details on Command options, please refer here.
ipsurv [-h] [--verbose {0,1,2,3}] [--debug] [--log {string}]
[--disable_env] [--resolve {0,1}] [--identify_int]
[--autodetect] [--begin {number}] [--end {number}]
[--collect {string}] [--all_collect] [--timeout {string}]
[--group {string}] [--skip_duplicate {0,1,2}] [--range {string}]
[--format {string}] [--no_original] [--sequence] [--add_ip]
[--ident] [--enclose {string}] [--delimiter {string}]
[--alt_delimiter {string}] [--headers {0,1,2,3}]
[--json {0,1,2}] [--json_list] [--exhaustive] [--icmp {0,1}]
[--tcp {number}] [--udp {number}] [--http {0,1,2}] [--json_all]
[--geoip_only] [--host_only] [--version]
[target [target ...]]
“ipscap” command¶
Introduction¶
Usage
# ipscap --exclude_ssh
# ipscap --force
# ipscap --port="80;53" --find="GET"
# ipscap --find="HTTP/1.1 \d01"
# ipscap --find="http" --find_mode=MATCH
# ipscap --condition="port=80,443,53,-1" --protocol=TCP,UDP,ICMP
# ipscap --find="HTTP" --tracking
# ipscap --port=80,443 --stat_group=1
# ipscap --output=HEADER # HEADER only
# ipscap --output=BINARY --port="80" # Binary of payload
# ipscap --output=BINARY_ALL --port="80" # Binary of payload with headers.
# ipscap --output=BASE64 --port="80" # BASE64 of payload
# ipscap --output=LINE --port="80" #LINE
Command options
“ipscap” have many Command options. For details on Command options, please refer here.
ipscap [-h] [--verbose {0,1,2,3}] [--debug] [--log {string}]
[--find {string}] [--find_mode [REGEX, MATCH, BINARY, HEX]]
[--port {int}] [--protocol [ICMP, TCP, UDP]] [--ip {string}]
[--condition {string}] [--tracking] [--stat_mode {0,1,2}]
[--stat_group {0,1,2}]
[--output [NONE, HEADER, TEXT, BINARY, BINARY_ALL, HEX, HEX_ALL, BASE64, BASE64_ALL, LINE]]
[--dumpfile {0,1,2}] [--timeout {float}] [--exclude_ssh]
[--web_port] [--general_port] [--force] [--version]
ipscap’s documents¶
“ipsend” command¶
Introduction¶
Usage
$ ipsend --mode=TCP --dest=google.com --port=80 --interactive=1
$ ipsend --dest=google.com --http -I
$ ipsend --dest=google.com --port=80 --interactive=2
$ ipsend "GET /index.html HTTP/1.1\n" --dest=google.com --http
$ ipsend "GET / HTTP/1.1\n" --dest=google.com --https
$ ipsend --dest=google.com --https -I --output=BASE64
$ ipsend --mode=UDP --dest=8.8.8.8 --port=53
$ ipsend --mode=TCP --dest=wikipedia.org --http -I --output=BINARY
$ ipsend --mode=SSL --dest=google.com --port=443 -I
$ ipsend --mode=SSL --dest=google.com --https -I --output=BINARY
$ ipsend --mode=SSL --dest=google.com --https -I --ssl_context=TLS1.2
$ ipsend '47 45 54 20 2f 69 6e 64 65 78 2e 68 74 6d 6c 20 48 54 54 50 2f 31 2e 31 0a 0a 0a' --mode=TCP --dest=172.217.31.174 --port=80 --input=HEX
$ ipsend 'R0VUIC9pbmRleC5odG1sIEhUVFAvMS4xCkhvc3Q6IHd3dy5nb29nbGUuY29tCgo=' --mode=TCP --dest=172.217.31.174 --port=80 --input=BASE64
$ ipsend "GET /index.html HTTP/1.1\n" --dest=google.com --http
Mode: TCP
Input: TEXT / Output: TEXT
Destination: google.com
Port: 80
HTTP/1.1 200 OK
Date: Sat, 25 Jan 2025 ~~:~~:~~ GMT
Expires: -1
Cache-Control: private, max-age=0
Content-Type: text/html; charset=ISO-8859-1
~~~~~~~~~~~
Command options
“ipsend” have many Command options. For details on Command options, please refer here.
ipsend [-h] [--verbose {0,1,2,3}] [--debug] [--log {string}]
[--mode {TCP,UDP,SSL,IP_HEADER,TCP_HEADER,UDP_HEADER,ICMP_HEADER,IP_PAYLOAD,TCP_PAYLOAD,UDP_PAYLOAD,ICMP_PAYLOAD}]
[--input {TEXT,BINARY,HEX,BASE64}]
[--output {NONE,TEXT,BINARY,HEX,BASE64}]
[--interactive {int}]
[--ssl_context {SSLV3,TLS1.0,TLS1.1,TLS1.2,TLS1.3}]
[--output_send {int}] [--auto_nl {bool}] [--dest {string}]
[--port {int}] [--timeout {float}] [--dumpfile]
[--ip_flags {int}] [--ip_identification {int}]
[--ip_ttl {int}] [--ip_protocol {int}] [--src_ip {int}]
[--src_port {int}] [--dest_ip {int}] [--dest_port {int}]
[--tcp_flags {str}] [--tcp_seq {int}] [--tcp_ack {int}]
[--tcp_window {int}] [--icmp_type {int}]
[--icmp_code {int}] [--icmp_id {int}] [--icmp_seq {int}]
[-I] [--http] [--https] [--version]
ipsend’s documents¶
Modules and Classes reference¶
The following is the documentation for the module and class. Github source