{"id":13459356,"url":"https://github.com/ogham/dog","last_synced_at":"2025-05-14T06:13:58.666Z","repository":{"id":37583632,"uuid":"258827107","full_name":"ogham/dog","owner":"ogham","description":"A command-line DNS client.","archived":false,"fork":false,"pushed_at":"2024-05-29T11:36:13.000Z","size":885,"stargazers_count":6329,"open_issues_count":76,"forks_count":188,"subscribers_count":37,"default_branch":"master","last_synced_at":"2025-04-09T02:16:13.891Z","etag":null,"topics":["client","command-line","dns","rust"],"latest_commit_sha":null,"homepage":"https://dns.lookup.dog/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"eupl-1.2","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ogham.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"ogham"}},"created_at":"2020-04-25T16:53:10.000Z","updated_at":"2025-04-07T17:39:53.000Z","dependencies_parsed_at":"2023-01-23T15:15:40.919Z","dependency_job_id":"4b928eab-c3e2-4344-b8c3-11f165940a48","html_url":"https://github.com/ogham/dog","commit_stats":{"total_commits":180,"total_committers":17,"mean_commits":"10.588235294117647","dds":0.09999999999999998,"last_synced_commit":"721440b12ef01a812abe5dc6ced69af6e221fad5"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogham%2Fdog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogham%2Fdog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogham%2Fdog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogham%2Fdog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ogham","download_url":"https://codeload.github.com/ogham/dog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254083783,"owners_count":22011902,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["client","command-line","dns","rust"],"created_at":"2024-07-31T09:01:18.192Z","updated_at":"2025-05-14T06:13:58.635Z","avatar_url":"https://github.com/ogham.png","language":"Rust","readme":"\u003cdiv align=\"center\"\u003e\n\u003ch1\u003edog\u003c/h1\u003e\n\n[dog](https://dns.lookup.dog/) is a command-line DNS client.\n\n\u003ca href=\"https://travis-ci.org/github/ogham/dog\"\u003e\n    \u003cimg src=\"https://travis-ci.org/ogham/dog.svg?branch=master\" alt=\"Build status\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://saythanks.io/to/ogham%40bsago.me\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg\" alt=\"Say thanks!\" /\u003e\n\u003c/a\u003e\n\u003c/div\u003e\n\n![A screenshot of dog making a DNS request](dog-screenshot.png)\n\n---\n\nDogs _can_ look up!\n\n**dog** is a command-line DNS client, like `dig`.\nIt has colourful output, understands normal command-line argument syntax, supports the DNS-over-TLS and DNS-over-HTTPS protocols, and can emit JSON.\n\n## Examples\n\n    dog example.net                          Query a domain using default settings\n    dog example.net MX                       ...looking up MX records instead\n    dog example.net MX @1.1.1.1              ...using a specific nameserver instead\n    dog example.net MX @1.1.1.1 -T           ...using TCP rather than UDP\n    dog -q example.net -t MX -n 1.1.1.1 -T   As above, but using explicit arguments\n\n---\n\n## Command-line options\n\n### Query options\n\n    \u003carguments\u003e              Human-readable host names, nameservers, types, or classes\n    -q, --query=HOST         Host name or domain name to query\n    -t, --type=TYPE          Type of the DNS record being queried (A, MX, NS...)\n    -n, --nameserver=ADDR    Address of the nameserver to send packets to\n    --class=CLASS            Network class of the DNS record being queried (IN, CH, HS)\n\n### Sending options\n\n    --edns=SETTING           Whether to OPT in to EDNS (disable, hide, show)\n    --txid=NUMBER            Set the transaction ID to a specific value\n    -Z=TWEAKS                Set uncommon protocol-level tweaks\n\n### Protocol options\n\n    -U, --udp                Use the DNS protocol over UDP\n    -T, --tcp                Use the DNS protocol over TCP\n    -S, --tls                Use the DNS-over-TLS protocol\n    -H, --https              Use the DNS-over-HTTPS protocol\n\n### Output options\n\n    -1, --short              Short mode: display nothing but the first result\n    -J, --json               Display the output as JSON\n    --color, --colour=WHEN   When to colourise the output (always, automatic, never)\n    --seconds                Do not format durations, display them as seconds\n    --time                   Print how long the response took to arrive\n\n\n---\n\n## Installation\n\nTo install dog, you can download a pre-compiled binary, or you can compile it from source. You _may_ be able to install dog using your OS’s package manager, depending on your platform.\n\n\n### Packages\n\n- For Arch Linux, install the [`dog`](https://www.archlinux.org/packages/community/x86_64/dog/) package.\n- For Homebrew on macOS, install the [`dog`](https://formulae.brew.sh/formula/dog) formula.\n- For NixOS, install the [`dogdns`](https://search.nixos.org/packages?channel=unstable\u0026show=dogdns\u0026query=dogdns) package.\n\n\n### Downloads\n\nBinary downloads of dog are available from [the releases section on GitHub](https://github.com/ogham/dog/releases/) for 64-bit Windows, macOS, and Linux targets. They contain the compiled executable, the manual page, and shell completions.\n\n\n### Compilation\n\ndog is written in [Rust](https://www.rust-lang.org).\nYou will need rustc version [1.45.0](https://blog.rust-lang.org/2020/07/16/Rust-1.45.0.html) or higher.\nThe recommended way to install Rust for development is from the [official download page](https://www.rust-lang.org/tools/install), using rustup.\n\nTo build, download the source code and run:\n\n    $ cargo build\n    $ cargo test\n\n- The [just](https://github.com/casey/just) command runner can be used to run some helpful development commands, in a manner similar to `make`.\nRun `just --list` to get an overview of what’s available.\n\n- If you are compiling a copy for yourself, be sure to run `cargo build --release` or `just build-release` to benefit from release-mode optimisations.\nCopy the resulting binary, which will be in the `target/release` directory, into a folder in your `$PATH`.\n`/usr/local/bin` is usually a good choice.\n\n- To compile and install the manual pages, you will need [pandoc](https://pandoc.org/).\nThe `just man` command will compile the Markdown into manual pages, which it will place in the `target/man` directory.\nTo use them, copy them into a directory that `man` will read.\n`/usr/local/share/man` is usually a good choice.\n\n\n### Container image\n\nTo build the container image of dog, you can use Docker or Kaniko. Here an example using Docker:\n\n    $ docker build -t dog .\n\nYou can then run it using the following command:\n\n    $ docker run -it --rm dog\n\nTo run dog directly, you can then define the following alias:\n\n    $ alias dog=\"docker run -it --rm dog\"\n\n\n### End-to-end testing\n\ndog has an integration test suite written as [Specsheet](https://specsheet.software/) check documents.\nIf you have a copy installed, you can run:\n\n    $ just xtests\n\nSpecsheet will test the compiled binary by making DNS requests over the network, checking that dog returns the correct results and does not crash.\nNote that this will expose your IP address.\nFor more information, read [the xtests README](xtests/README.md).\n\n\n### Feature toggles\n\ndog has three Cargo features that can be switched off to remove functionality.\nWhile doing so makes dog less useful, it results in a smaller binary that takes less time to build.\n\nThere are three feature toggles available, all of which are active by default:\n\n- `with_idna`, which enables [IDNA](https://en.wikipedia.org/wiki/Internationalized_domain_name) processing\n- `with_tls`, which enables DNS-over-TLS\n- `with_https`, which enables DNS-over-HTTPS (requires `with_tls`)\n\nUse `cargo` to build a binary that uses feature toggles. For example, to disable TLS and HTTPS support but keep IDNA support enabled, you can run:\n\n    $ cargo build --no-default-features --features=with_idna\n\nThe list of features that have been disabled can be checked at runtime as part of the `--version` string.\n\n\n---\n\n## Documentation\n\nFor documentation on how to use dog, see the website: \u003chttps://dns.lookup.dog/\u003e\n\n\n## See also\n\n`mutt`, `tail`, `sleep`, `roff`\n\n\n## Licence\n\ndog’s source code is licenced under the [European Union Public Licence](https://choosealicense.com/licenses/eupl-1.2/).\n","funding_links":["https://github.com/sponsors/ogham"],"categories":["Rust","\u003ca name=\"dns\"\u003e\u003c/a\u003edns","Productivity","Rust (42)","rust","Tools","Network","\u003ca name=\"networking\"\u003e\u003c/a\u003eNetworking","DNS","Lovely Commands","Applications","Projects"],"sub_categories":["Kubernetes","Rust","DNS","Purple Team","System tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fogham%2Fdog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fogham%2Fdog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fogham%2Fdog/lists"}