ascension.1 (3300B)
1 .\" This file is part of Ascension. 2 .\" Copyright (C) 2018-2020 GNUnet e.V. 3 .\" 4 .\" Permission is granted to copy, distribute and/or modify this document 5 .\" under the terms of the GNU Free Documentation License, Version 1.3 or 6 .\" any later version published by the Free Software Foundation; with no 7 .\" Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A 8 .\" copy of the license is included in the file 9 .\" ``FDL-1.3''. 10 .\" 11 .\" A copy of the license is also available from the Free Software 12 .\" Foundation Web site at http://www.gnu.org/licenses/fdl.html. 13 .\" 14 .\" Alternately, this document is also available under the General 15 .\" Public License, version 3 or later, as published by the Free Software 16 .\" Foundation. A copy of the license is included in the file 17 .\" ``GPL3''. 18 .\" 19 .\" A copy of the license is also available from the Free Software 20 .\" Foundation Web site at http://www.gnu.org/licenses/gpl.html. 21 .\" 22 .\" SPDX-License-Identifier: GPL3.0-or-later OR FDL1.3-or-later 23 .\" 24 .Dd October 2022 25 .Dt ASCENSION 1 26 .Os 27 .Sh NAME 28 .Nm Ascension 29 .Nd migrate existing DNS zones into the GNU Name System 30 .Sh SYNOPSIS 31 .Op -h 32 .Op -n NAMESERVER 33 .Op -P PORT 34 .Op -k KEYFILE 35 .Op -l LOGLEVEL 36 .Op -t TTL 37 .Op -s 38 .Op -p 39 .Op -g 40 .Op -V 41 domain 42 .Sh DESCRIPTION 43 .Nm 44 is a tool to migrate existing DNS Zones into the GNU Name System (GNS) using incremental zone transfers (AXFR/IXFR). 45 To achieve this it calls the GNUnet REST API which relies on GNUnet, 46 .Xr gnunet-arm 1 47 must be installed and running. 48 .Bl -tag -width Ds 49 .It Ar domain 50 Domain to be migrated into GNS 51 .It Fl n | \-nameserver Ar NAMESERVER 52 Nameserver to use for zone transfer 53 .It Fl P | \-port Ar PORT 54 Use the specified port when contacting the nameserver to transfer the zone 55 .It Fl k | \-keyfile Ar KEYFILE 56 DNS TSIG File containing a BIND compatible public key to authenticate for zone transfer 57 .It Fl l | \-loglevel Ar LOGLEVEL 58 Loglevel to use, 10 Debug, 20 Info, 30 Warning, 40 Error, 50 Critical 59 .It Fl t | \-ttl Ar TTL 60 Sets the minimum ttl of records added to GNS in seconds 61 .It Fl s | \-standalone 62 Migrate a zone once and then exit 63 .It Fl p | \-public 64 Set the public flag for records and publish them on the DHT. When in possession 65 of the public key of the zone in BASE32 format anyone can resolve a record 66 within the zone provided they also know the label under which the recorset is 67 stored. 68 .It Fl g | \-dryrun 69 Checks whether or not the domains nameserver supports zone transfer for the 70 given domain. When a nameserver is specified it will be checked instead. 71 .It Fl h | \-help 72 Show the usage and argument syntax of Ascension. 73 .It Fl V | \-version 74 Show the current version number 75 .El 76 .\" .Sh FILES 77 .Sh EXAMPLES 78 .Pp 79 To test if the given domains nameserver supports zone transfers for that zone: 80 .Pp 81 .Dl $ ascension nu -n zonedata.iis.se. -d 82 .Sh SEE ALSO 83 .Xr gnunet-arm 1 , 84 .Xr gnunet-gns 1 , 85 .Xr gnunet-identity 1 , 86 .Xr gnunet-namestore 1 87 .Sh HISTORY 88 The 89 .Nm 90 tool was designed and written in 2018-2022 by 91 .An rexxnor Aq Mt rexxnor+gnunet@brief.li . 92 .Sh AUTHORS 93 This man page was written by 94 .An ng0 Aq Mt ng0@gnunet.org 95 and updated by 96 .An rexxnor Aq Mt rexxnor+gnunet@brief.li 97 it first appeared in 98 .Nm 99 0.5.1. 100 .Sh BUGS 101 Report bugs by using 102 .Lk https://bugs.gnunet.org 103 or by sending electronic mail to 104 .Aq Mt bug-gnunet@gnu.org .