ascension.1 (3452B)
1 .\" This file is part of Ascension. 2 .\" Copyright (C) 2018,2019 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 May 9, 2019 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 .Nm 32 .Op Ar domain Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run 33 .Nm 34 .Op Ar domain port Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run 35 .Nm 36 .Op Ar domain Fl n Ar transferns Fl d Fl p Fl s Fl -minimum-ttl=<ttl> -dry-run 37 .Nm 38 .Op Ar domain Fl n Ar transferns Ar port Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run 39 .Sh DESCRIPTION 40 .Nm 41 is a tool to migrate existing DNS Zones into the GNU Name System (GNS) using incremental zone transfers (AXFR/IXFR). 42 To achieve this it uses 43 .Xr gnunet-identity 1 , 44 .Xr gnunet-namestore 1 , 45 .Xr gnunet-gns 1 . 46 As 47 .Nm 48 relies on these 3 GNUnet services, 49 .Xr gnunet-arm 1 50 must be installed and running. 51 .Bl -tag -width Ds 52 .It Ar domain Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run 53 Migrate the DOMAIN passed as domain. 54 The debug, public and standalone options are optional. 55 .It Ar domain port Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run 56 Migrate the DOMAIN domain, using port for zone transfer. 57 The debug, public and standalone options are optional. 58 .It Ar domain Fl n Ar transferns Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run 59 Migrate the DOMAIN domain from the DNS server transferns. 60 The debug, public and standalone options are optional. 61 .It Ar domain Fl n Ar transferns Ar port Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run 62 Migrate the DOMAIN domain from the DNS server transferns using port for the zone transfer. 63 The debug, public and standalone options are optional. 64 .It Fl s | \-standalone 65 Run Ascension once 66 .It Fl d | \-debug 67 Enable debugging 68 .It Fl h | \-help 69 Print short help on options 70 .It Fl p | \-public 71 Make records public on the DHT 72 .It Fl v | \-version 73 Print ascension version number 74 .El 75 .\" .Sh FILES 76 .Sh EXAMPLES 77 To transfer the sy TLD from ns1.tld.sy: 78 .Pp 79 .Dl $ ascension sy -n ns1.tld.sy. 80 .Pp 81 To transfer the nu TLD from zonedata.iis.se with debug options enabled: 82 .Pp 83 .Dl $ ascension nu -n zonedata.iis.se. -d 84 .Sh SEE ALSO 85 .Xr gnunet-arm 1 , 86 .Xr gnunet-gns 1 , 87 .Xr gnunet-identity 1 , 88 .Xr gnunet-namestore 1 89 .Sh HISTORY 90 The 91 .Nm 92 tool was designed and written in 2018 by 93 .An rexxnor Aq Mt rexxnor+gnunet@brief.li . 94 .Sh AUTHORS 95 This man page was written by 96 .An ng0 Aq Mt ng0@gnunet.org 97 and updated by 98 .An rexxnor Aq Mt rexxnor+gnunet@brief.li 99 it first appeared in 100 .Nm 101 0.5.1. 102 .Sh BUGS 103 Report bugs by using 104 .Lk https://bugs.gnunet.org 105 or by sending electronic mail to 106 .Aq Mt bug-gnunet@gnu.org .