Network Commands¶

The network-base group provides host reachability checks, HTTP probing, port scanning, service detection, geolocation, WHOIS, comprehensive domain information, traceroute, and local network information commands.

nadzoring network-base --help

network-base ping¶

Check ICMP reachability for one or more hosts.

nadzoring network-base ping [OPTIONS] HOST [HOST ...]

nadzoring network-base ping 8.8.8.8
nadzoring network-base ping google.com 1.1.1.1 cloudflare.com
nadzoring network-base ping -o json https://example.com

Python API¶

from nadzoring.network_base.ping_address import ping_addr

# Works with IPs, hostnames, and full URLs
if ping_addr("8.8.8.8"):
    print("Reachable")

# Note: ICMP may be blocked even for live hosts
reachable = ping_addr("https://google.com")

network-base http-ping¶

Probe a URL and measure DNS resolution, time-to-first-byte (TTFB), and total download time.

nadzoring network-base http-ping [OPTIONS] URL

Options¶

Option	Default	Description
`--timeout`	`10.0`	Request timeout in seconds
`--no-ssl-verify`	off	Skip SSL certificate verification
`--no-follow-redirects`	off	Do not follow HTTP redirects
`--show-headers`	off	Include response headers in output

Examples¶

nadzoring network-base http-ping https://example.com
nadzoring network-base http-ping --show-headers https://github.com
nadzoring network-base http-ping --timeout 5 --no-ssl-verify https://self-signed.example.com

Python API¶

from nadzoring.network_base.http_ping import http_ping

result = http_ping("https://example.com")

if result.error:
    print("Failed:", result.error)
else:
    print(f"Status:  {result.status_code}")
    print(f"DNS:     {result.dns_ms} ms")
    print(f"TTFB:    {result.ttfb_ms} ms")
    print(f"Total:   {result.total_ms} ms")
    print(f"Size:    {result.content_length} bytes")
    if result.final_url:
        print(f"Redirect→ {result.final_url}")

network-base host-to-ip¶

Resolve a hostname to its IPv4 address.

nadzoring network-base host-to-ip [OPTIONS] HOSTNAME

nadzoring network-base host-to-ip example.com
nadzoring network-base host-to-ip google.com github.com

Python API¶

from nadzoring.utils.validators import resolve_hostname

ip = resolve_hostname("example.com")
if ip is None:
    print("Resolution failed")
else:
    print(ip)  # "93.184.216.34"

network-base parse-url¶

Parse a URL into its components (scheme, hostname, port, path, query, fragment, etc.).

nadzoring network-base parse-url [OPTIONS] URL [URL ...]

nadzoring network-base parse-url https://example.com/path?q=1#section
nadzoring network-base parse-url "postgresql://user:pass@localhost:5432/db"

Python API¶

from nadzoring.network_base.parse_url import parse_url

result = parse_url("https://user:pass@example.com:8080/path?key=value#frag")
print(result["protocol"])   # 'https'
print(result["hostname"])   # 'example.com'
print(result["port"])       # 8080
print(result["username"])   # 'user'
print(result["password"])   # 'pass'
print(result["path"])       # '/path'
print(result["query_params"])  # [('key', 'value')]
print(result["fragment"])   # 'frag'

network-base geolocation¶

Get geographic information for a public IP address.

nadzoring network-base geolocation [OPTIONS] IP [IP ...]

nadzoring network-base geolocation 8.8.8.8
nadzoring network-base geolocation 8.8.8.8 1.1.1.1 -o json

Python API¶

from nadzoring.network_base.geolocation_ip import geo_ip

result = geo_ip("8.8.8.8")

if not result:
    print("Geolocation unavailable")
else:
    print(f"{result['city']}, {result['country']}")
    print(f"Lat/Lon: {result['lat']}, {result['lon']}")

Note

ip-api.com rate-limits free callers to 45 requests per minute. Private addresses (e.g. 192.168.x.x) return an empty result.

network-base whois¶

Perform a WHOIS lookup for a domain or IP address.

nadzoring network-base whois [OPTIONS] TARGET

nadzoring network-base whois example.com
nadzoring network-base whois 8.8.8.8
nadzoring network-base whois -o json --save whois.json example.com

Note

Requires the whois system utility. See /installation for installation instructions.

network-base domain-info¶

Retrieve comprehensive information about a domain in a single call. Aggregates WHOIS registration data, DNS record lookups (A, AAAA, MX, NS, TXT), IP geolocation for the primary resolved address, and reverse DNS.

nadzoring network-base domain-info [OPTIONS] DOMAIN [DOMAIN ...]

nadzoring network-base domain-info example.com

# Multiple domains
nadzoring network-base domain-info google.com github.com cloudflare.com

# Export as JSON
nadzoring network-base domain-info -o json --save domain_report.json example.com

Python API¶

from nadzoring.network_base.domain_info import get_domain_info

info = get_domain_info("example.com")

# WHOIS registration data
print(info["whois"]["registrar"])
print(info["whois"]["creation_date"])
print(info["whois"]["expiry_date"])

# Resolved IP addresses
print(info["dns"]["ipv4"])    # '93.184.216.34'
print(info["dns"]["ipv6"])    # '2606:2800:220:1:248:1893:25c8:1946'

# DNS records by type
for rtype, records in info["dns"]["records"].items():
    print(f"  {rtype}: {records}")

# Geolocation of the primary IP
geo = info["geolocation"]
if geo:
    print(f"{geo['city']}, {geo['country']}  ({geo['lat']}, {geo['lon']})")

# Reverse DNS for the primary IP
print(info["reverse_dns"])    # 'example.com' or None

network-base port-scan¶

Scan TCP or UDP ports on one or more targets.

nadzoring network-base port-scan [OPTIONS] TARGET [TARGET ...]

Options¶

Option	Default	Description
`--mode`	`fast`	Scan mode: `fast` (common ports), `full` (1–65535), `custom`
`--protocol`	`tcp`	Protocol: `tcp` or `udp`
`--ports`	—	Custom port list or range (e.g. `22,80,443` or `1-1024`)
`--timeout`	`2.0`	Per-port connection timeout in seconds
`--workers`	`50`	Number of concurrent threads
`--no-banner`	off	Disable banner grabbing
`--show-closed`	off	Show closed ports in results

Examples¶

nadzoring network-base port-scan example.com
nadzoring network-base port-scan --mode full 192.168.1.1
nadzoring network-base port-scan --mode custom --ports 1-1024 example.com
nadzoring network-base port-scan --protocol udp --mode fast example.com

Python API¶

from nadzoring.network_base.port_scanner import ScanConfig, scan_ports

config = ScanConfig(
    targets=["example.com"],
    mode="fast",
    protocol="tcp",
    timeout=2.0,
)
results = scan_ports(config)

for scan in results:
    print(f"Target: {scan.target}  ({scan.target_ip})")
    print(f"Open ports: {scan.open_ports}")
    for port in scan.open_ports:
        r = scan.results[port]
        print(f"  {port}/tcp  {r.service}  {r.response_time}ms")
        if r.banner:
            print(f"  Banner: {r.banner[:80]}")

network-base detect-service¶

Actively connect to ports on a target host and detect the actual running services by analyzing banners.

nadzoring network-base detect-service [OPTIONS] TARGET PORTS...

Options¶

Option	Default	Description
`--timeout`	`3.0`	Connection timeout in seconds
`--no-probe`	off	Disable sending protocol-specific probes

Examples¶

# Detect services on common ports
nadzoring network-base detect-service example.com 80 443 22

# Multiple ports including database
nadzoring network-base detect-service 192.168.1.100 3306 5432 6379

# Longer timeout for slow services
nadzoring network-base detect-service --timeout 5 example.com 8080

# JSON output for scripting
nadzoring network-base detect-service -o json example.com 80 443

Python API¶

from nadzoring.network_base.service_detector import detect_service_on_host

# Detect service on port 80
result = detect_service_on_host("example.com", 80)

if result.detected_service:
    print(f"Service: {result.detected_service} (method: {result.method})")
    print(f"Banner: {result.banner}")
else:
    print(f"Fallback guess: {result.guessed_service}")
    if result.error:
        print(f"Error: {result.error}")

network-base port-service¶

Identify the service name associated with a port number.

nadzoring network-base port-service [OPTIONS] PORT [PORT ...]

nadzoring network-base port-service 80 443 22 3306

Python API¶

from nadzoring.network_base.service_on_port import get_service_on_port

print(get_service_on_port(80))    # "http"
print(get_service_on_port(22))    # "ssh"
print(get_service_on_port(9999))  # "unknown"

network-base traceroute¶

Trace the network path to a target host.

nadzoring network-base traceroute [OPTIONS] TARGET

Options¶

Option	Default	Description
`--max-hops`	`30`	Maximum number of hops
`--timeout`	`2.0`	Per-hop timeout in seconds
`--sudo`	off	Prefix command with `sudo` (Linux only)

nadzoring network-base traceroute 8.8.8.8
nadzoring network-base traceroute --max-hops 20 --sudo example.com

Note

On Linux, traceroute requires raw-socket privileges. Use --sudo, run as root, or grant the capability to the binary. tracepath is tried automatically as a fallback.

Python API¶

from nadzoring.network_base.traceroute import traceroute

hops = traceroute("8.8.8.8", max_hops=15)
for hop in hops:
    rtts = [f"{r}ms" if r else "*" for r in hop.rtt_ms]
    print(f"{hop.hop:2}  {hop.ip or '*':16}  {' '.join(rtts)}")

network-base connections¶

List active TCP/UDP connections (like netstat / ss).

nadzoring network-base connections [OPTIONS]

nadzoring network-base connections
nadzoring network-base connections --protocol tcp --state LISTEN
nadzoring network-base connections -o json --save conns.json

network-base route¶

Display the system IP routing table.

nadzoring network-base route [OPTIONS]

nadzoring network-base route
nadzoring network-base route -o json

network-base params¶

Show local network interface parameters: interface name, IPv4/IPv6, MAC address, gateway, and public IP.

nadzoring network-base params [OPTIONS]

nadzoring network-base params
nadzoring network-base params -o json --save net.json