1,68 → 1,80 |
.TH vgwhois 1 "26 Apr 2012" Linux "User Manuals" |
.TH vgwhois 1 "23 May 2019" Linux "User Manuals" |
.SH NAME |
vgwhois \- ViaThinkSoft Global WhoIs |
VGWhoIs \- ViaThinkSoft Global WhoIs |
.SH SYNOPSIS |
.B vgwhois [-h host] [-m method:host mirror] [-L] [-e] [-v] [-?] [query] |
.B vgwhois [-C dir] [-h host] [-m method:host mirror] [-L] [-e] [-c] [-v] [-?] [query] |
.SH DESCRIPTION |
vgwhois is a generic whois client. It strives to know for all existing |
VGWhoIs is a generic whois client. It strives to know for all existing |
tlds and all ip address ranges the appropriate whois server to ask. You |
can simply call vgwhois with a query for some domain or some IP and it |
can simply call VGWhoIs 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. |
|
vgwhois can also be used as a whois server. You can call it from the |
VGWhoIs can also be used as a whois server. You can call it from the |
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 vgwhois. |
enhanced features of VGWhoIs. |
|
.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 |
\-h host Selecting a fixed whois server for this query |
\-m method:host mirror Defining a mirror for a given method and host. |
\-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 |
\-c Do not try to convert to UTF-8. Output server's stream |
\-v Output version of pattern table(s) |
\-?, \-\-help Printing this text |
|
.SH FILES |
.SH TOOLS |
.TP |
.IB /etc/vgwhois/pattern.d/* |
The pattern file(s) of vgwhois. 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 vgwhois\-pattern\-update |
is executed. |
The domain pattern file will only be extended without overwriting or deleted anything. |
.IB vgwhois\-pattern\-update |
This shortcut leads to the script is located in |
.B maintenance/pattern\-generator/vgwhois\-pattern\-update |
and can be used to get the latest information according to IPv4, IPv6, ASN and TLD |
resources from the RIRs. The |
.B main/pattern/(ipv4_*|ipv6_*|tld|asn) |
files will be overwritten. You can run this script as cronjob to have up-to-date |
pattern files. New TLDs are automatically added to the pattern files. |
However, changed whois server names need manual changing of the pattern files. |
|
.TP |
.IB /etc/vgwhois/debconf.inc |
File created depending on debconf question sending mail. Please do |
not change manually but instead use dpkg\-reconfigure! |
.IB vgwhois\-qa\-check |
This shortcut leads to the script is located in |
.B maintenance/qa\-monitor/run |
and performs some basic checks to determine if pattern files need an update. |
For example, it will be checked if whois servers in the list are dead. |
|
.TP |
.IB /usr/share/vgwhois/maintenance/pattern\-generator/vgwhois\-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. |
.IB vgwhois\-update |
If you have installed VGWhoIs via SVN, an SVN update will be performed |
to download the latest version of VGWhoIs and its pattern files. |
|
.SH DIRECTORIES |
|
.TP |
.IB /usr/share/vgwhois/maintenance/ |
In this directory you will find programs which you can use to maintain the pattern files. |
.IB main/ |
Contains the main executable and other libraries. |
|
.TP |
.IB /usr/share/vgwhois/subprogram/ |
.IB main/pattern/ |
This directory contains the pattern files of vgwhois which |
contain a 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. |
|
.TP |
.IB main/subprograms/ |
In this directory you'll find "sub programs". They are called by vgwhois by definition in the |
pattern file and can do complex parsing. You can also call the sub programs independently. |
|
.TP |
.IB /var/cache/vgwhois/maintenance/pattern\-generator/ |
In this directory, |
.B /usr/share/vgwhois/maintenance/pattern\-generator/vgwhois\-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. |
.IB maintenance/ |
In this directory you will find programs which you can use to maintain the pattern files. |
|
.SH AUTHORS |
2010\-2019 Daniel Marschall <daniel\-marschall@viathinksoft.de> |
|
70,4 → 82,5 |
|
Some early parts by Lutz Donnerhacke <Lutz.Donnerhacke@Jena.Thur.de> |
.SH VERSION |
2019xxxx WIP |
20190523 |
|