#!/usr/bin/env bash
# Advanced Bash — scripting.rocks
# Bash 3.2+. Only scan systems you own or have explicit permission to assess.
# Browser labs use recorded probes; this optional script makes real TCP connections.
# No DNS, CIDR expansion, service payloads or network dependencies.

scanner_usage() {
    cat <<'HELP'
Usage: bash tcp_scan.sh --target IPV4 --port PORT --allow CIDR [options]
Repeat --target, --port and --allow to form a bounded, deduplicated plan.
  --timeout-seconds N   Whole seconds, 1–5 (default 1)
  --max-endpoints N     Maximum target/port pairs, 1–256 (default 64)
  --execute            Connect to the planned endpoints; otherwise preview only
  --help               Show this help
Example (preview only):
  bash tcp_scan.sh --target 127.0.0.1 --port 443 --allow 127.0.0.0/8
Use explicit canonical numeric IPv4 addresses and network-aligned allowlist CIDRs.
Allowlisting records your intended scope; it does not establish permission.
Results: open, connect_failed, timed_out. connect_failed does NOT prove a closed
port: Bash does not expose a portable structured socket error. A timeout is also
inconclusive. Connections send no service data. Scheduling can extend deadlines.
HELP
}

_scanner_connect() {
    # Fixed source, separate arguments, and no user-controlled shell startup file.
    exec env BASH_ENV= ENV= "$BASH" --noprofile --norc -c \
        ': >"/dev/tcp/$1/$2"' bash "$1" "$2"
}

_scanner_stop_child() {
    if [ -n "${scanner_pid:-}" ]; then
        kill -TERM "$scanner_pid" 2>/dev/null || :
        kill -KILL "$scanner_pid" 2>/dev/null || :
        wait "$scanner_pid" 2>/dev/null || :
        scanner_pid=
    fi
}

_scanner_cleanup() {
    _scanner_stop_child
    if [ -n "${scanner_work:-}" ]; then rm -rf -- "$scanner_work"; fi
}

_scanner_probe() {
    local address=$1 port=$2 ticks=0 limit=$((scanner_timeout * 20)) status
    _scanner_connect "$address" "$port" >"$scanner_work/probe.out" 2>"$scanner_work/probe.err" &
    scanner_pid=$!
    while kill -0 "$scanner_pid" 2>/dev/null; do
        if [ "$ticks" -ge "$limit" ]; then
            _scanner_stop_child
            printf '%s\t%s\ttimed_out\n' "$address" "$port"
            return 0
        fi
        sleep 0.05
        ticks=$((ticks + 1))
    done
    if wait "$scanner_pid"; then status=0; else status=$?; fi
    scanner_pid=
    if [ "$status" -eq 0 ]; then
        printf '%s\t%s\topen\n' "$address" "$port"
    else
        printf '%s\t%s\tconnect_failed\n' "$address" "$port"
    fi
}

scanner_main() (
    # A subshell scopes traps and shell options when the file is sourced.
    export LC_ALL=C
    local targets=() ports=() allows=() execute=no max=64 value address port
    scanner_timeout=1 scanner_work= scanner_pid=
    while [ "$#" -gt 0 ]; do
        case "$1" in
            --help) scanner_usage; return 0 ;;
            --execute) execute=yes; shift ;;
            --target|--port|--allow|--timeout-seconds|--max-endpoints)
                if [ "$#" -lt 2 ]; then printf 'Missing value for %s\n' "$1" >&2; return 2; fi
                value=$2
                case "$value" in *$'\n'*|*$'\r'*|*$'\t'*) printf 'Invalid argument\n' >&2; return 2;; esac
                case "$1" in
                    --target) targets+=("$value");;
                    --port) ports+=("$value");;
                    --allow) allows+=("$value");;
                    --timeout-seconds) scanner_timeout=$value;;
                    --max-endpoints) max=$value;;
                esac
                shift 2 ;;
            *) printf 'Unknown option: %s\n' "$1" >&2; return 2 ;;
        esac
    done
    case "$scanner_timeout" in [1-5]) ;; *) printf 'Invalid timeout\n' >&2; return 2;; esac
    case "$max" in ''|0*|*[!0-9]*) printf 'Invalid endpoint limit\n' >&2; return 2;; esac
    if [ "${#max}" -gt 3 ] || [ "$max" -gt 256 ]; then printf 'Invalid endpoint limit\n' >&2; return 2; fi
    if [ "${#targets[@]}" -eq 0 ] || [ "${#ports[@]}" -eq 0 ] || [ "${#allows[@]}" -eq 0 ]; then
        printf 'Provide at least one --target, --port and --allow\n' >&2; return 2
    fi
    scanner_work=$(mktemp -d "${TMPDIR:-/tmp}/rocks-scan.XXXXXX") || return 2
    trap '_scanner_cleanup' EXIT
    trap 'exit 130' INT
    trap 'exit 143' TERM
    printf '%s\n' "${targets[@]}" > "$scanner_work/targets"
    printf '%s\n' "${ports[@]}" > "$scanner_work/ports"
    printf '%s\n' "${allows[@]}" > "$scanner_work/allows"
    # Validate every input before creating a usable plan or opening a socket.
    if ! awk -v max="$max" '
    function ip(s,a,n,i,v) {
        n=split(s,a,".");if(n!=4)return -1;v=0
        for(i=1;i<=4;i++){if(a[i]!~/^(0|[1-9][0-9]*)$/ || length(a[i])>3 || a[i]>255)return -1;v=v*256+a[i]}
        return v
    }
    FILENAME==ARGV[1] {
        n=split($0,a,"/");v=ip(a[1]);p=a[2]
        if(n!=2 || p!~/^(0|[1-9][0-9]*)$/ || length(p)>2 || p>32 || v<0){bad=1;next}
        size=2^(32-p);if(v/size!=int(v/size)){bad=1;next}
        lo[++count]=v;hi[count]=v+size-1;next
    }
    FILENAME==ARGV[2] {
        v=ip($0);allowed=0
        if(v<16777216 || v>=3758096384){bad=1;next}
        for(i=1;i<=count;i++)if(v>=lo[i] && v<=hi[i])allowed=1
        if(!allowed){bad=1;next}hosts[$0]=v;next
    }
    {if($0!~/^[1-9][0-9]*$/ || length($0)>5 || $0>65535){bad=1;next}ports[$0]=1}
    END {
        pairs=0;for(h in hosts)for(p in ports)pairs++
        if(bad || pairs<1 || pairs>max)exit 2
        for(h in hosts)for(p in ports)printf "%.0f\t%s\t%s\n",hosts[h],h,p
    }' "$scanner_work/allows" "$scanner_work/targets" "$scanner_work/ports" > "$scanner_work/unsorted"; then
        printf 'Invalid or out-of-scope input, or endpoint limit exceeded\n' >&2; return 2
    fi
    sort -t $'\t' -k1,1n -k3,3n "$scanner_work/unsorted" | cut -f2,3 > "$scanner_work/plan"
    if [ "$execute" = no ]; then
        printf 'address\tport\tmode\n'
        while IFS=$'\t' read -r address port; do printf '%s\t%s\tpreview\n' "$address" "$port"; done < "$scanner_work/plan"
    else
        printf 'address\tport\tstate\n'
        while IFS=$'\t' read -r address port; do _scanner_probe "$address" "$port"; done < "$scanner_work/plan"
    fi
)

if [ "${BASH_SOURCE[0]}" = "$0" ]; then scanner_main "$@"; fi
