101 lines
2.1 KiB
Markdown
101 lines
2.1 KiB
Markdown
# knotctl
|
|
|
|
This is a commandline tool for knotapi
|
|
|
|
https://gitlab.nic.cz/knot/knot-dns-rest
|
|
|
|
## Usage
|
|
```
|
|
usage: knotctl [-h] [--json | --no-json]
|
|
{add,complete,config,delete,list,update} ...
|
|
|
|
positional arguments:
|
|
{add,complete,config,delete,list,update}
|
|
|
|
options:
|
|
-h, --help show this help message and exit
|
|
--json, --no-json
|
|
```
|
|
### ADD
|
|
```
|
|
usage: knotctl add [-h] -d DATA -n NAME -r RTYPE -t TTL -z ZONE
|
|
|
|
options:
|
|
-h, --help show this help message and exit
|
|
-d DATA, --data DATA
|
|
-n NAME, --name NAME
|
|
-r RTYPE, --rtype RTYPE
|
|
-t TTL, --ttl TTL
|
|
-z ZONE, --zone ZONE
|
|
```
|
|
### COMPLETE
|
|
```
|
|
usage: knotctl complete [-h] [-s SHELL]
|
|
|
|
options:
|
|
-h, --help show this help message and exit
|
|
-s SHELL, --shell SHELL
|
|
```
|
|
|
|
For bash: add this to .bashrc
|
|
```
|
|
source <(knotctl complete)
|
|
```
|
|
For fish, run:
|
|
```
|
|
knotctl complete --shell fish > ~/.config/fish/completions/knotctl.fish
|
|
```
|
|
For tcsh: add this to .cshrc
|
|
```
|
|
complete "knotctl" 'p@*@`python-argcomplete-tcsh "knotctl"`@' ;
|
|
```
|
|
For zsh: add this to .zshrc
|
|
```
|
|
autoload -U bashcompinit
|
|
bashcompinit
|
|
source <(knotctl complete)
|
|
```
|
|
### CONFIG
|
|
```
|
|
usage: knotctl config [-h] [-b BASEURL] [-p PASSWORD] [-u USERNAME]
|
|
|
|
options:
|
|
-h, --help show this help message and exit
|
|
-b BASEURL, --baseurl BASEURL
|
|
-p PASSWORD, --password PASSWORD
|
|
-u USERNAME, --username USERNAME
|
|
```
|
|
### DELETE
|
|
```
|
|
usage: knotctl delete [-h] [-d DATA] [-n NAME] [-r RTYPE] -z ZONE
|
|
|
|
options:
|
|
-h, --help show this help message and exit
|
|
-d DATA, --data DATA
|
|
-n NAME, --name NAME
|
|
-r RTYPE, --rtype RTYPE
|
|
-z ZONE, --zone ZONE
|
|
```
|
|
### LIST
|
|
```
|
|
usage: knotctl list [-h] [-d DATA] [-n NAME] [-r RTYPE] [-z ZONE]
|
|
|
|
options:
|
|
-h, --help show this help message and exit
|
|
-d DATA, --data DATA
|
|
-n NAME, --name NAME
|
|
-r RTYPE, --rtype RTYPE
|
|
-z ZONE, --zone ZONE
|
|
```
|
|
### UPDATE
|
|
```
|
|
usage: knotctl update [-h] -d DATA -n NAME -r RTYPE -t TTL -z ZONE
|
|
|
|
options:
|
|
-h, --help show this help message and exit
|
|
-d DATA, --data DATA
|
|
-n NAME, --name NAME
|
|
-r RTYPE, --rtype RTYPE
|
|
-t TTL, --ttl TTL
|
|
-z ZONE, --zone ZONE
|
|
```
|