Skip to content

Building 70 Projects ranging from beginner to advanced so anyone can — learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company 👇

5.3 KB
Raw Blame
// ©AngelaMos | 2026
// cli.zig

const std = @import("std");
const build_config = @import("build_config");
const output = @import("output");

const banner_art =
    \\  ____  _                 _
    \\ |_  /(_) _ _   __ _  ___| | __ _
    \\  / / | || ' \ / _` |/ -_) |/ _` |
    \\ /___||_||_||_|\__, |\___|_|\__,_|
    \\               |___/
;

pub fn printBanner(io: std.Io, env: *std.process.Environ.Map) !void {
    var buf: [1024]u8 = undefined;
    var fw = std.Io.File.stdout().writer(io, &buf);
    const out = &fw.interface;
    const level = output.envLevel(io, std.Io.File.stdout(), env, .auto);
    try output.bannerWordmark(out, level, banner_art);
    try out.print("  zingela {s}  stateless mass scanner (Zig 0.16)\n\n", .{build_config.version});
    try out.flush();
}

pub fn printVersion(io: std.Io) !void {
    var buf: [64]u8 = undefined;
    var fw = std.Io.File.stdout().writer(io, &buf);
    const out = &fw.interface;
    try out.print("zingela {s}\n", .{build_config.version});
    try out.flush();
}

pub fn printHelp(io: std.Io, env: *std.process.Environ.Map) !void {
    try printBanner(io, env);
    var buf: [512]u8 = undefined;
    var fw = std.Io.File.stdout().writer(io, &buf);
    const out = &fw.interface;
    try out.writeAll(
        \\usage: zingela <command> [options]
        \\
        \\commands:
        \\  smoke [ifname]   send one hand-built SYN via AF_PACKET (default ifname: lo)
        \\  tx [options]     PACKET_TX_RING SYN blast over a target range (privileged)
        \\  scan [options]   SYN scan: transmit + classify replies open/closed/filtered (privileged)
        \\  --version, -V    print version
        \\  --help, -h       print this help
        \\
        \\tx / scan options:
        \\  --target <cidr>  target range, required (e.g. 10.0.0.0/24)
        \\  --ports <list>   comma-separated dst ports (default 80; --udp: 53,123,161)
        \\  --rate <pps>     token-bucket rate, packets per second (default 10000)
        \\  --count <n>      stop after n packets (default: every target once)
        \\  --iface <name>   egress interface (default lo)
        \\  --src-ip <addr>  source IPv4 (default: resolved from --iface)
        \\  --src-port <n>   source port; UDP uses it as the cookie-range base (default 40000)
        \\  --gw-mac <mac>   gateway/dst MAC aa:bb:cc:dd:ee:ff (default 00:..:00)
        \\  --seed <n>       permutation seed (default: per-scan CSPRNG)
        \\  --backend <b>    TX path: auto | xdp | afpacket | connect (default auto;
        \\                   xdp needs a -Dxdp build; connect = unprivileged TCP connect scan)
        \\
        \\scan-only options:
        \\  --udp            UDP scan: per-protocol payloads, ICMP type3/code3 = closed,
        \\                   silent ports reported honestly as open|filtered
        \\  --banners        SYN-scan only: phase-2 service/banner grab on open ports
        \\                   (NULL probe + HTTP GET, TLS detected not decrypted, no JA4);
        \\                   auto-installs a scoped RST-drop so the grab survives the kernel
        \\  --wait <ms>      receive drain window after transmit (default 2000)
        \\  --json           emit NDJSON results to stdout (visuals go to stderr)
        \\  --color <when>   auto | always | never (default auto)
        \\
        \\connect-scan options (--backend connect / --connect; no CAP_NET_RAW needed):
        \\  --connect              TCP connect() scan via the OS stack (open/closed/filtered)
        \\  --concurrency <n>      concurrent connect workers (default 128)
        \\  --connect-timeout <ms> per-connect timeout, filtered on no reply (default 3000)
        \\
        \\IPv6 scan (a --target with ':' is IPv6; raw stateless SYN, or add --connect):
        \\  --target <cidr6>       bounded IPv6 prefix, e.g. 2001:db8::/112 (::/0 is refused)
        \\  --src-ip6 <addr>       source IPv6 (default: resolved from --iface via /proc/net/if_inet6)
        \\  --gw-ip6 <addr>        next-hop IPv6 to resolve via NDP (default: the iface v6 default route)
        \\  --gw-mac <mac>         skip NDP and stamp this next-hop MAC directly
        \\  --max-hosts <n>        host-address cap per IPv6 prefix (default 1048576)
        \\
        \\stealth / evasion (tx + scan; every flag requires --authorized-scan):
        \\  --authorized-scan          confirm you are authorized to scan the target
        \\  --os-template <os>         SYN fingerprint none|masscan|linux|windows|macos
        \\  --scan-type <t>            syn|fin|null|xmas|maimon|ack|window (default syn)
        \\  --jitter <mode>            poisson | none: exponential inter-packet timing
        \\  --source-port-rotation     vary the source port per probe (cookie still matches)
        \\  --decoys <list>            spoofed decoys ip1,ip2,RND:N (real probe always sent)
        \\  --suppress-rst             drop our own kernel RSTs on the scan port range
        \\  (idle-scan, fragmentation, TTL, and MAC/source-route spoofing are deliberately
        \\   omitted as obsolete in 2026; run with --authorized-scan for the rationale)
        \\
        \\authorized use only. responsible default rate; needs CAP_NET_RAW
        \\(grant once: sudo setcap cap_net_raw,cap_net_admin=eip ./zig-out/bin/zingela)
        \\
    );
    try out.flush();
}

test "version string is non-empty" {
    try std.testing.expect(build_config.version.len > 0);
}