# go-dns

Go library for authoritative DNS operations against BIND (and compatible) nameservers:

- **Dynamic updates** — `nsupdate`-style changes (RFC 2136)
- **Zone transfer** — full zone read via **AXFR** (IXFR on [backlog](docs/backlog.md))
- **TSIG key authentication** (callers provide keys; generation out of scope)

## Status

Early project setup. The supported operation surface, zone data model, and BIND configuration requirements are defined in [docs/changes/00001-setup-project/spec.md](docs/changes/00001-setup-project/spec.md). Implementation follows the change-driven workflow (spec → plan → implement).

## Module

```bash
go get gitea.neitzel.de/konrad/go-dns
```

Module path: `gitea.neitzel.de/konrad/go-dns` — import as **`godns`**.

## Documentation

- [Project specification](docs/project-specification.md)
- [BIND TSIG configuration](docs/bind-tsig-configuration.md)
- [Product backlog](docs/backlog.md)
- [Change efforts](docs/changes/)