[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] [ascension] 09/45: updated README
From: |
gnunet |
Subject: |
[GNUnet-SVN] [ascension] 09/45: updated README |
Date: |
Fri, 25 Jan 2019 10:02:09 +0100 |
This is an automated email from the git hooks/post-receive script.
rexxnor pushed a commit to branch master
in repository ascension.
commit 81683c98e459b37667fb94231ff8daa250047530
Author: rexxnor <address@hidden>
AuthorDate: Wed Sep 26 21:47:52 2018 +0200
updated README
---
README.md | 47 +++++++++++++++++++++++++++++++++++++++--------
1 file changed, 39 insertions(+), 8 deletions(-)
diff --git a/README.md b/README.md
index 010e377..b76e081 100644
--- a/README.md
+++ b/README.md
@@ -1,27 +1,58 @@
# GNS Migrator
The main goal is to develop a tool to easily migrate existing DNS Zones to the
-GNU Name System
+GNU Name System using incremental Zone Transfers. (IXFR)
-## How to use
+## How to install
+To install the gnsmigrator simply execute one of the following commands:
+
+```bash
+# System wide installation
+sudo python3 setup.py install
+
+# Local installation through virtualenv
+python3 -m venv .venv
+source .venv/bin/activate
+python3 setup.py install
+```
-To use the program simply execute python3 on the gnsmigrator.py file.
-At a later stage this will be possible to do by installing the program and
after execute it directly using "gnsmigrator"
+## How to install (Developer)
+```bash
+# installation through virtualenv
+python3 -m venv .venv
+source .venv/bin/activate
+python3 setup.py develop
+```
+## How to use
+If you have installed it, simply execute gnsmigrator with one of several
options..
+You can also just run the file gnsmigrator.py itself directly.
Taken from the dosctring of the gnsmigrator.py file:
```
GNS Migrator
Usage:
- gnsmigrator.py <file>
+ gnsmigrator.py (-c <csv> | -f <txtfile>)
+ gnsmigrator.py (-c <csv> | -f <txtfile>) -r <resolver>
gnsmigrator.py -h | --help
- gnsmigrator.py --version
+ gnsmigrator.py -v | --version
Options:
- <file> CSV File containing domains to transfer
+ <csv> CSV File containing domains to transfer
+ <txtfile> Text File containing domains to transfer
+ <resolver> DNS Server that resolves missing domains
-h --help Show this screen.
- --version Show version.
+ -v --version Show version.
```
+Example use:
+```
+# Reads domains from CSV, setup GNS Zones and adds records from zone transfer
+gnsmigrator -c domainlist.csv
+# Reads domains from Textfile, setup GNS Zones and adds records from zone
transfer
+gnsmigrator -f domainlist.txt
+# Does the above and adds GNS2DNS records for every non-zone local NS record
using provided resolver
+gnsmigrator -f domainlist.txt -r 1.1.1.1
+```
--
To stop receiving notification emails like this one, please contact
address@hidden
- [GNUnet-SVN] [ascension] branch master created (now 5ea0f07), gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 04/45: Merge branch 'master' of gitlab.ti.bfh.ch:gerbp6/gnsmigrator, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 01/45: added gitignore and README, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 07/45: fixes, added a few tests, updated README and requirements, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 14/45: reworked the incremental zone transfer, added notice for bind, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 11/45: added ttl of SOA to zone for later implementation of timer, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 09/45: updated README,
gnunet <=
- [GNUnet-SVN] [ascension] 23/45: fixed non existing file, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 19/45: fixed some minor bugs, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 16/45: fixed special cases with GNS2DNS, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 25/45: fixed bugs, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 20/45: fixed zonemaster to zonedata in README, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 13/45: added zone merging of full and incremental zones, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 05/45: initial prototype, bootstrapping zones and zone transfer, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 17/45: updated requirements and README, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 22/45: finished refactoring, fixed a few bugs, gnunet, 2019/01/25
- [GNUnet-SVN] [ascension] 10/45: added incremental zone transfer logic, gnunet, 2019/01/25