Have you ever wanted to check where a domain points, find its mail servers,
or understand why a name is not resolving on your Amiga? This package gives
you two small commands for doing exactly that.

adig is the DNS lookup command from c-ares, ported to classic m68k AmigaOS.
Its command line and output are similar to BIND dig. It can query A, AAAA, MX,
NS, PTR, SOA, SRV, TXT, CAA and other DNS record types.

ahost is the quick companion command from c-ares. Give it a host name to see
its IPv4 address, or an IPv4 address to find the associated host name. Use
adig when you want to choose a DNS server or inspect a particular record.

c-ares project: https://c-ares.org/

Things you can do
-----------------

Ask a particular DNS server for a site's IPv4 address:

  adig @1.1.1.1 amiga.org A

Find where email for a domain is delivered:

  adig @1.1.1.1 amiga.org MX

Find the authoritative DNS servers for a domain:

  adig @1.1.1.1 amiga.org NS

Look up the name belonging to an IP address:

  adig @1.1.1.1 -x 8.8.8.8

Check whether two DNS servers give the same answer:

  adig @192.168.1.1 amiga.org A
  adig @1.1.1.1 amiga.org A

Quickly find the IPv4 address for a site:

  ahost amiga.org

Quickly look up the name belonging to an IPv4 address:

  ahost 8.8.8.8

1.1.1.1 is a public DNS server. 192.168.1.1 is an example router address;
your router may use a different address.

The archive includes two builds of each command:

  adig-68000           Build for 68000 systems
  adig-020             Build for 68020/68030/68040/68060 systems
  ahost-68000          Build for 68000 systems
  ahost-020            Build for 68020/68030/68040/68060 systems

International names are entered in their DNS form. For example,
xn--mnchen-3ya.de represents a name whose second letter is a u with an umlaut.

Double-click Install-adig for a guided text-based installation. It detects
the CPU and recommends a build, while leaving the final choice and install
destination to you. The destination entered is the adig path; ahost is placed
in the same directory under the name ahost.

Manual installation is also possible. Copy the matching pair. For example:

  Copy adig-68000 C:adig
  Copy ahost-68000 C:ahost

Start the TCP/IP stack before using either command. Roadshow may keep
DHCP-provided DNS servers internally instead of writing them to
name_resolution. If either command cannot find a server automatically,
specify one:

  adig @192.168.1.1 amiga.org MX
  ahost -s 192.168.1.1 amiga.org

Requirements
------------

  - Kickstart/AmigaOS 2.04 (V37) or newer
  - A 68000, 68020, 68030, 68040 or 68060 CPU
  - Roadshow or another bsdsocket.library V3 compatible TCP/IP stack
  - A configured and running IPv4 connection

The full command-line reference, installation help and known limitations are
in the included plain README.

License
-------

c-ares, adig and ahost are distributed under the MIT License. The complete
license and upstream author list are included as LICENSE and AUTHORS. The
executable builds use clib2 by Olaf Barthel and contributors under its BSD
3-Clause license, included as CLIB2-LICENSE. No separate library installation
is needed.

This is an unofficial port and comes with no warranty or support.

Contact
-------

AmigaOS port feedback: RLH <rlh_amiga@protonmail.com>

History
-------

1.1.0 (05.09.2026)

  - Added the c-ares ahost companion command.
  - Both commands are installed together after one CPU choice.

1.0.1 (04.09.2026)

  - Initial Aminet release.
  - Architecture-specific builds for 68000 and 68020+ systems.
  - Native guided text installer.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
drwxr-xr-x   501/20          0       0 ****** -lhd- 0000 Sep  4 22:00 adig/
-rw-r--r--   501/20        785    1258  62.4% -lh5- b7bf Sep  4 22:00 adig/AUTHORS
-rw-r--r--   501/20        798    1512  52.8% -lh5- 16fb Sep  4 22:00 adig/CLIB2-LICENSE
-rwxr-xr-x   501/20      12868   22352  57.6% -lh5- fbde Sep  4 22:00 adig/Install-adig
-rw-r--r--   501/20        130     246  52.8% -lh5- aa46 Sep  4 22:00 adig/Install-adig.info
-rw-r--r--   501/20        716    1211  59.1% -lh5- 11fa Sep  4 22:00 adig/LICENSE
-rw-r--r--   501/20       2294    5312  43.2% -lh5- b3cf Sep  4 22:00 adig/README
-rw-r--r--   501/20         94     120  78.3% -lh5- 1778 Sep  4 22:00 adig/Test
-rw-r--r--   501/20         75      93  80.6% -lh5- 35cf Sep  4 22:00 adig/VERSION
-rwxr-xr-x   501/20      69331  118188  58.7% -lh5- e009 Sep  4 22:00 adig/adig-020
-rwxr-xr-x   501/20      70993  122848  57.8% -lh5- 21a4 Sep  4 22:00 adig/adig-68000
-rwxr-xr-x   501/20      67471  113568  59.4% -lh5- 66ad Sep  4 22:00 adig/ahost-020
-rwxr-xr-x   501/20      69283  118564  58.4% -lh5- bef2 Sep  4 22:00 adig/ahost-68000
-rw-r--r--   501/20         85     246  34.6% -lh5- 058c Sep  4 22:00 adig.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        14 files  294923  505518  58.3%            Sep  7 01:22