Documentation ¶
Overview ¶
Shaman is a small, clusterable, lightweight, api-driven dns server.
Usage ¶
To start shaman as a server, simply run (with administrator privileges):
shaman -s
For more specific usage information, refer to the help doc `shaman -h`:
Usage: shaman [flags] shaman [command] Available Commands: add Add a domain to shaman delete Remove a domain from shaman list List all domains in shaman get Get records for a domain update Update records for a domain reset Reset all domains in shaman Flags: -C, --api-crt string Path to SSL crt for API access -k, --api-key string Path to SSL key for API access -p, --api-key-password string Password for SSL key -H, --api-listen string Listen address for the API (ip:port) (default "127.0.0.1:1632") -c, --config-file string Configuration file to load -O, --dns-listen string Listen address for DNS requests (ip:port) (default "127.0.0.1:53") -d, --domain string Parent domain for requests (default ".") -i, --insecure Disable tls key checking (client) and listen on http (api) -2, --l2-connect string Connection string for the l2 cache (default "scribble:///var/db/shaman") -l, --log-level string Log level to output [fatal|error|info|debug|trace] (default "INFO") -s, --server Run in server mode -t, --token string Token for API Access (default "secret") -T, --ttl int Default TTL for DNS records (default 60) -v, --version Print version info and exit
Directories ¶
Path | Synopsis |
---|---|
Package api provides a restful interface to manage entries in the DNS database.
|
Package api provides a restful interface to manage entries in the DNS database. |
Package cache provides a pluggable backend for persistent record storage.
|
Package cache provides a pluggable backend for persistent record storage. |
Package commands provides the cli functionality.
|
Package commands provides the cli functionality. |
Package config is a central location for configuration options.
|
Package config is a central location for configuration options. |
Package shaman contains the logic to add/remove DNS entries.
|
Package shaman contains the logic to add/remove DNS entries. |
common
Package common contains common structs used in shaman
|
Package common contains common structs used in shaman |
Package server contains logic to handle DNS requests.
|
Package server contains logic to handle DNS requests. |
Click to show internal directories.
Click to hide internal directories.