{"id":50405267,"url":"https://github.com/simonpainter/network-tools","last_synced_at":"2026-05-31T01:04:24.185Z","repository":{"id":356744596,"uuid":"1216328038","full_name":"simonpainter/network-tools","owner":"simonpainter","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-09T13:52:02.000Z","size":40,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-09T15:43:32.344Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simonpainter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-20T19:49:18.000Z","updated_at":"2026-05-09T13:52:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/simonpainter/network-tools","commit_stats":null,"previous_names":["simonpainter/network-tools"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/simonpainter/network-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonpainter%2Fnetwork-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonpainter%2Fnetwork-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonpainter%2Fnetwork-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonpainter%2Fnetwork-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simonpainter","download_url":"https://codeload.github.com/simonpainter/network-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonpainter%2Fnetwork-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33715214,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-31T01:04:23.503Z","updated_at":"2026-05-31T01:04:24.181Z","avatar_url":"https://github.com/simonpainter.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# network-tools\n\nA collection of Bash network diagnostic utilities.\n\n## Tools\n\n### dnsping\n\nDNS query \"ping\" using `dig`. Sends repeated DNS queries to a resolver and reports the response status (NOERROR, NXDOMAIN, SERVFAIL, etc.) and round-trip time for each query, with summary statistics on exit.\n\n**Usage:**\n```bash\n./dnsping example.com\n./dnsping -s 1.1.1.1 -c 5 cloudflare.com\n./dnsping -t MX -d google.com     # show first answer\n./dnsping -s 9.9.9.9 -T example.com  # force TCP\n./dnsping -x 1.1.1.1             # reverse lookup\n```\n\n**Options:**\n| Flag | Description |\n|------|-------------|\n| `-s SERVER` | DNS server to query (default: system resolver) |\n| `-c COUNT` | Stop after COUNT queries (default: run forever) |\n| `-i INTERVAL` | Seconds between queries (default: 1) |\n| `-t TYPE` | Query type: A, AAAA, MX, NS, etc. (default: A) |\n| `-T` | Force TCP instead of UDP |\n| `-x` | Reverse (PTR) lookup |\n| `-d` | Show first answer in response |\n\n**Requirements:** `dig` (from `bind-utils` or `dnsutils`)\n\n---\n\n### httping\n\nHTTP/HTTPS \"ping\" using `curl`. Sends repeated HEAD (or GET) requests to a URL and reports the HTTP status code and round-trip time for each request, with summary statistics on exit.\n\n**Usage:**\n```bash\n./httping https://example.com\n./httping -c 5 -i 0.5 https://example.com\n./httping -d https://example.com        # detailed timings\n./httping -G -c 10 https://api.example.com/health\n```\n\n**Options:**\n| Flag | Description |\n|------|-------------|\n| `-c COUNT` | Stop after COUNT requests (default: run forever) |\n| `-i INTERVAL` | Seconds between requests (default: 1) |\n| `-t TIMEOUT` | Per-request timeout in seconds (default: 5) |\n| `-G` | Use GET instead of HEAD |\n| `-d` | Show detailed timing breakdown |\n| `--no-color` | Disable colour output |\n\n**Requirements:** `curl`\n\n---\n\n### ntpping\n\nNTP query \"ping\" using `sntp`. Sends repeated SNTP queries to a time server and reports the clock offset and round-trip delay for each query, with summary statistics on exit.\n\n**Usage:**\n```bash\n./ntpping pool.ntp.org\n./ntpping -c 5 time.cloudflare.com\n./ntpping -i 0.5 -W 2 time.google.com\n./ntpping -4 0.uk.pool.ntp.org      # force IPv4\n```\n\n**Options:**\n| Flag | Description |\n|------|-------------|\n| `-c COUNT` | Stop after COUNT queries (default: run forever) |\n| `-i INTERVAL` | Seconds between queries (default: 1) |\n| `-W TIMEOUT` | Per-query timeout in seconds (default: 2) |\n| `-4` | Force IPv4 |\n| `-6` | Force IPv6 |\n| `-n` | Disable colour output |\n\nOffset is the local clock's difference from the server (positive = local clock is ahead). Delay is the round-trip network delay reported by `sntp`. Lines are colour-coded by absolute offset (green ≤ 10ms, yellow ≤ 100ms, red \u003e 100ms).\n\n**Requirements:** `sntp` (from `ntp`, `ntpsec`, or `sntp` package; pre-installed on macOS)\n\n---\n\n### uping\n\n\u003e **uping has moved** — it now lives in its own repository: [simonpainter/uping](https://github.com/simonpainter/uping)\n\n---\n\n## Requirements\n\n- Bash 4+\n- `dig` (for dnsping)\n- `curl` (for httping)\n- `sntp` (for ntpping)\n\n## Installation\n\nClone the repo and install the tools to your `PATH`.\n\n```bash\n# Install dependencies (curl and sntp ship with macOS; dig comes from bind)\nbrew install bind\n\n# Install the bash tools\ngit clone https://github.com/simonpainter/network-tools.git\ncd network-tools\nsudo install -m 0755 dnsping httping ntpping /usr/local/bin/\n```\n\nIf you'd rather not use `sudo`, copy them to `~/bin` (and make sure that's on your `PATH`):\n\n```bash\nmkdir -p ~/bin\ninstall -m 0755 dnsping httping ntpping ~/bin/\n```\n\nAfter installation, verify with:\n\n```bash\ndnsping -c 1 example.com\nhttping -c 1 https://example.com\nntpping -c 1 pool.ntp.org\n```\n\n### Uninstall\n\n```bash\nsudo rm /usr/local/bin/{dnsping,httping,ntpping}\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonpainter%2Fnetwork-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimonpainter%2Fnetwork-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonpainter%2Fnetwork-tools/lists"}