dnstapir-cli

CLI utility primarily to interact with other DNS TAPIR components. For this the config details needed to connect to eg. dnstapir-pop are located in the config files in the /etc/dnstapir/ directory.

For some uses, though, dnstapir-cli is used in "standalone" mode. One example of this is the creation and manipulation of DAWG files containing large lists of domain names in a compact format. To run dnstapir-cli in standalone mode, without the need for any config files, use the command flag --standalone.

dnstapir-cli has a large number of commands and subcommands. The entire set of commands is structured as a tree with the root in the tapi-cli command. All commands, regardless of where in the tree of commands they are located, have online help via the flag -h. I.e. to get help on the dnstapir-cli pop ping command, run:

dnstapir-cli pop ping -h
Send an API ping request to dnstapir-pop and present the response

Usage:
  dnstapir-cli pop ping [flags]

Flags:
  -c, --count int   #pings to send
  -h, --help        help for ping
  -n, --newapi      use new api client

Global Flags:
      --config string   config file (default is /etc/dnstapir/dnstapir-pop.yaml)
  -d, --debug           Debugging output
  -H, --headers         Show column headers
      --tls             Use a TLS connection to dnstapir-pop (default true)
  -v, --verbose         Verbose mode

The flag -h also lists all subcommands underneath the command in question.

The dnstapir-cli command has a number of subcommands, each of which is a command group. The command groups are:

dnstapir-cli -h                
CLI  utility used to interact with dnstapir-pop, i.e. the DNS TAPIR Policy Processor

Usage:
  dnstapir-cli [command]

Available Commands:
  api         request a dnstapir-pop api summary
  bump        Instruct dnstapir-pop to bump the SOA serial of the RPZ zone
  completion  Generate the autocompletion script for the specified shell
  dawg        Generate or interact with data stored in a DAWG file; only useable via sub-commands
  debug       A brief description of your command
  help        Help about any command
  pop         Prefix command, only usable via sub-commands
  rpz         Instruct dnstapir-pop to modify the RPZ zone; must use sub-command

Flags:
      --config string   config file (default is /etc/dnstapir/dnstapir-pop.yaml)
  -d, --debug           Debugging output
  -H, --headers         Show column headers
  -h, --help            help for dnstapir-cli
      --tls             Use a TLS connection to dnstapir-pop (default true)
  -v, --verbose         Verbose mode

Use "dnstapir-cli [command] --help" for more information about a command.

Many of the commands are only there as debugging tools. They are not intended for use in production.