1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
.\" This file is part of Ascension.
.\" Copyright (C) 2018,2019 GNUnet e.V.
.\"
.\" Permission is granted to copy, distribute and/or modify this document
.\" under the terms of the GNU Free Documentation License, Version 1.3 or
.\" any later version published by the Free Software Foundation; with no
.\" Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
.\" copy of the license is included in the file
.\" ``FDL-1.3''.
.\"
.\" A copy of the license is also available from the Free Software
.\" Foundation Web site at http://www.gnu.org/licenses/fdl.html.
.\"
.\" Alternately, this document is also available under the General
.\" Public License, version 3 or later, as published by the Free Software
.\" Foundation. A copy of the license is included in the file
.\" ``GPL3''.
.\"
.\" A copy of the license is also available from the Free Software
.\" Foundation Web site at http://www.gnu.org/licenses/gpl.html.
.\"
.\" SPDX-License-Identifier: GPL3.0-or-later OR FDL1.3-or-later
.\"
.Dd May 9, 2019
.Dt ASCENSION 1
.Os
.Sh NAME
.Nm ascension
.Nd migrate existing DNS zones into the GNU Name System
.Sh SYNOPSIS
.Nm
.Op Ar domain Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run
.Nm
.Op Ar domain port Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run
.Nm
.Op Ar domain Fl n Ar transferns Fl d Fl p Fl s Fl -minimum-ttl=<ttl> -dry-run
.Nm
.Op Ar domain Fl n Ar transferns Ar port Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run
.Sh DESCRIPTION
.Nm
is a tool to migrate existing DNS Zones into the GNU Name System (GNS) using incremental zone transfers (AXFR/IXFR).
To achieve this it uses
.Xr gnunet-identity 1 ,
.Xr gnunet-namestore 1 ,
.Xr gnunet-gns 1 .
As
.Nm
relies on these 3 GNUnet services,
.Xr gnunet-arm 1
must be installed and running.
.Bl -tag -width Ds
.It Ar domain Fl d Fl p Fl s -minimum-ttl=<ttl> -dry-run
Migrate the DOMAIN passed as domain.
The debug, public and standalone options are optional.
.It Ar domain port Fl d Fl p Fl s -minimum-ttl=<ttl -dry-run>
Migrate the DOMAIN domain, using port for zone transfer.
The debug, public and standalone options are optional.
.It Ar domain Fl n Ar transferns Fl d Fl p Fl s -minimum-ttl=<ttl -dry-run>
Migrate the DOMAIN domain from the DNS server transferns.
The debug, public and standalone options are optional.
.It Ar domain Fl n Ar transferns Ar port Fl d Fl p Fl s -minimum-ttl=<ttl -dry-run>
Migrate the DOMAIN domain from the DNS server transferns using port for the zone transfer.
The debug, public and standalone options are optional.
.It Fl s | \-standalone
Run Ascension once
.It Fl d | \-debug
Enable debugging
.It Fl h | \-help
Print short help on options
.It Fl p | \-public
Make records public on the DHT
.It Fl v | \-version
Print ascension version number
.El
.\" .Sh FILES
.Sh EXAMPLES
To transfer the sy TLD from ns1.tld.sy:
.Pp
.Dl $ ascension sy -n ns1.tld.sy.
.Pp
To transfer the nu TLD from zonedata.iis.se with debug options enabled:
.Pp
.Dl $ ascension nu -n zonedata.iis.se. -d
.Sh SEE ALSO
.Xr gnunet-arm 1 ,
.Xr gnunet-gns 1 ,
.Xr gnunet-identity 1 ,
.Xr gnunet-namestore 1
.Sh HISTORY
The
.Nm
tool was designed and written in 2018 by
.An rexxnor Aq Mt rexxnor+gnunet@brief.li .
.Sh AUTHORS
This man page was written by
.An ng0 Aq Mt ng0@gnunet.org
and updated by
.An rexxnor Aq Mt rexxnor+gnunet@brief.li
it first appeared in
.Nm
0.5.1.
.Sh BUGS
Report bugs by using
.Lk https://bugs.gnunet.org
or by sending electronic mail to
.Aq Mt bug-gnunet@gnu.org .
|
