Diff of /usr/share/man/man1/gwhois.1

Last modified: 2015-05-06 10:34:55

Download viathinksoft-patched | Download 20120626-1.1

--- /home/vwhois/public_html/gwhois_fork/source_20120626-1.1/package/gwhois.1      2015-04-17 23:30:06.000000000 +0200
+++ /home/vwhois/public_html/gwhois_fork/source_patch/package/man/man1/gwhois.1      2015-05-06 10:34:55.000000000 +0200
 -1,31 +1,75 
-.TH gwhois 1 "19 Jan 2002" Linux "User Manuals"
+.TH gwhois 1 "26 Apr 2012" Linux "User Manuals"
 .SH NAME
 gwhois \- generic whois client / server
 .SH SYNOPSIS
-.B gwhois <query>
+.B gwhois [-C dir] [-h host] [-m method:host mirror] [-L] [-e] [-v] [-?] [query]
 .SH DESCRIPTION
 gwhois is a generic whois client. It strives to know for all existing
-tlds and all ip address ranges the appropiate whois server to ask. You
-can simply call gwhois with a query for some domain or some ip and it
+tlds and all ip address ranges the appropriate whois server to ask. You
+can simply call gwhois with a query for some domain or some IP and it
 will ask the right server for you! It can even query webforms which
 are unfortunately the only query type supported by many bad registries.
 
 gwhois can also be used as a whois server. You can call it from the
-inetd and make it accessable via a normal standard whois client. This
+inetd and make it accessible via a normal standard whois client. This
 allows for example using a windows client and still make use of the
 enhanced features of gwhois.
+.SH OPTIONS
+Try find information about the query (might be multiple words).
+If no query is given, use the first line from stdin
+
+ Options:
+   \-C dir                  Setting an alternate configuration directory
+                           default: /etc/gwhois
+   \-h host                 Selecting a fixed whois server for this query
+   \-m method:host mirror   Defining a mirror for a given method and host.
+   \-L                      Use lynx \-source instead of LWP::Simple
+   \-e                      Do not protect e\-mail\-addresses
+   \-v                      Output version of pattern table(s)
+   \-?, \-\-help              Printing this text
+
 .SH FILES
 .TP
-.IB /etc/gwhois/pattern
-The pattern file of gwhois. Contains the list of domain and ip to
+.IB /etc/gwhois/pattern.d/*
+The pattern file(s) of gwhois. Contains the list of domain and IP to
 server mappings. It is in a machine readable regexp format but should
 be easy to understand by humans, too. If you have additions and
 corrections please report them always to the authors!
+Attention: IPv4, IPv6, TLD and ASN pattern files will be replaced
+when the script
+.B gwhois\-pattern\-update
+is executed.
+The domain pattern file will only be extended without overwriting or deleted anything.
 .TP
 .IB /etc/gwhois/debconf.inc
 File created depending on debconf question sending mail. Please do
-not change manually but instead use dpkg-reconfigure!
-.SH AUTHOR
-Juliane Holzt <debianjulijane.de>
+not change manually but instead use dpkg\-reconfigure!
+.TP
+.IB /usr/share/gwhois/maintenance/pattern\-generator/gwhois\-pattern\-update
+You can run this script to get the latest information according to IPv4, IPv6, ASN and TLD
+resources from the RIRs. The
+.B pattern.d/(ipv4_*|ipv6_*|tld|asn)
+files will be overwritten.
+.SH DIRECTORIES
+.TP
+.IB /usr/share/gwhois/maintenance/
+In this directory you will find programs which you can use to maintain the pattern files.
+.TP
+.IB /usr/share/gwhois/subprogram/
+In this directory you'll find "sub programs". They are called by gwhois by definition in the
+pattern file and can do complex parsing. You can also call the sub programs independently.
+.TP
+.IB /var/cache/gwhois/maintenance/pattern\-generator/
+In this directory,
+.B /usr/share/gwhois/maintenance/pattern\-generator/gwhois\-pattern\-update
+will save its downloaded RIR statistics files. If you run the script multiple times (e.g. via cronjob)
+and the RIR statistics file has not changed yet, this will save traffic because the file will not be
+downloaded twice.
+.SH AUTHORS
+2010\-2015 Daniel Marschall <daniel\-marschallviathinksoft.de>
+
+1998\-2010 Juliane Holzt <debianjulijane.de>
+
+Some early parts by Lutz Donnerhacke <Lutz.DonnerhackeJena.Thur.de>
 .SH VERSION
-20100515
+2015xxxx WIP