diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 43 |
1 files changed, 19 insertions, 24 deletions
| @@ -1,4 +1,4 @@ | |||
| 1 | # Ascension | 1 | #Ascension |
| 2 | 2 | ||
| 3 | Tool to easily migrate existing DNS Zones into the GNU Name System using | 3 | Tool to easily migrate existing DNS Zones into the GNU Name System using |
| 4 | incremental zone transfers (AXFR/IXFR). | 4 | incremental zone transfers (AXFR/IXFR). |
| @@ -35,30 +35,25 @@ You can also just run the file ascension.py itself directly. | |||
| 35 | 35 | ||
| 36 | Taken from the docstring of the ascension.py file: | 36 | Taken from the docstring of the ascension.py file: |
| 37 | ``` | 37 | ``` |
| 38 | Ascension | 38 | usage: ascension.py [-h] [-n NAMESERVER] [-P PORT] [-t] [-s] [-p] [-g] [-v] [-V] domain |
| 39 | |||
| 40 | Easy tool to migrate DNS zones into GNS | ||
| 39 | 41 | ||
| 40 | Usage: | 42 | positional arguments: |
| 41 | ascension <domain> [-d] [-p] [-s] [--minimum-ttl=<ttl>] [--dry-run] | 43 | domain Domain to be migrated |
| 42 | ascension <domain> <port> [-d] [-p] [-s] [--minimum-ttl=<ttl>] [--dry-run] | ||
| 43 | ascension <domain> -n <transferns> [-d] [-p] [-s] [--minimum-ttl=<ttl>] [--dry-run] | ||
| 44 | ascension <domain> -n <transferns> <port> [-d] [-p] [-s] [--minimum-ttl=<ttl>] [--dry-run] | ||
| 45 | ascension -p | --public | ||
| 46 | ascension -s | --debug | ||
| 47 | ascension -s | --standalone | ||
| 48 | ascension -h | --help | ||
| 49 | ascension -v | --version | ||
| 50 | 44 | ||
| 51 | Options: | 45 | optional arguments: |
| 52 | <domain> Domain to migrate | 46 | -h, --help show this help message and exit |
| 53 | <port> Port for zone transfer | 47 | -n NAMESERVER, --nameserver NAMESERVER |
| 54 | <transferns> DNS Server that does the zone transfer | 48 | Nameserver to use for migrating |
| 55 | --minimum-ttl=<ttl> Minimum TTL for records to migrate [default: 3600] | 49 | -P PORT, --port PORT Port to use for zone transfer with nameserver |
| 56 | --dry-run Only try if a zone transfer is allowed | 50 | -t, --ttl Sets TTL of records lower than TTL to specified TTL |
| 57 | -p --public Make records public on the DHT | 51 | -s, --standalone Run ascension once and not as daemon |
| 58 | -s --standalone Run ascension once | 52 | -p, --public Push records to the public DHT |
| 59 | -d --debug Enable debugging | 53 | -g, --dryrun Tests if zone is transferrable without changing anything |
| 60 | -h --help Show this screen. | 54 | -v, --verbose Enable verbose debugging |
| 61 | -v --version Show version. | 55 | -V, --version show program's version number and exit |
| 56 | Ascension | ||
| 62 | ``` | 57 | ``` |
| 63 | 58 | ||
| 64 | Example use: | 59 | Example use: |
| @@ -66,5 +61,5 @@ Example use: | |||
| 66 | # Transfers the sy TLD from ns1.tld.sy. | 61 | # Transfers the sy TLD from ns1.tld.sy. |
| 67 | ascension sy -n ns1.tld.sy. | 62 | ascension sy -n ns1.tld.sy. |
| 68 | # Transfers the nu TLD from zonedata.iis.se with debug options enabled | 63 | # Transfers the nu TLD from zonedata.iis.se with debug options enabled |
| 69 | ascension nu -n zonedata.iis.se. -d | 64 | ascension nu -n zonedata.iis.se. -v |
| 70 | ``` | 65 | ``` |