ascension

Migrate DNS zones to the GNU Name System
Log | Files | Refs | README | LICENSE

ascension.1 (3107B)

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