Login | ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/vgwhois/trunk/man/man1/vgwhois.1
(Generate patch)

Comparing trunk/man/man1/vgwhois.1 (file contents):
Revision 12 by daniel-marschall, Tue May 21 10:38:39 2019 UTC vs.
Revision 13 by daniel-marschall, Thu May 23 11:06:58 2019 UTC

# Line 1 | Line 1
1 < .TH vgwhois 1 "26 Apr 2012" Linux "User Manuals"
1 > .TH vgwhois 1 "23 May 2019" Linux "User Manuals"
2   .SH NAME
3 < vgwhois \- ViaThinkSoft Global WhoIs
3 > VGWhoIs \- ViaThinkSoft Global WhoIs
4   .SH SYNOPSIS
5 < .B vgwhois [-h host] [-m method:host mirror] [-L] [-e] [-v] [-?] [query]
5 > .B vgwhois [-C dir] [-h host] [-m method:host mirror] [-L] [-e] [-c] [-v] [-?] [query]
6   .SH DESCRIPTION
7 < vgwhois is a generic whois client. It strives to know for all existing
7 > VGWhoIs is a generic whois client. It strives to know for all existing
8   tlds and all ip address ranges the appropriate whois server to ask. You
9 < can simply call vgwhois with a query for some domain or some IP and it
9 > can simply call VGWhoIs with a query for some domain or some IP and it
10   will ask the right server for you! It can even query webforms which
11   are unfortunately the only query type supported by many bad registries.
12  
13 < vgwhois can also be used as a whois server. You can call it from the
13 > VGWhoIs can also be used as a whois server. You can call it from the
14   inetd and make it accessible via a normal standard whois client. This
15   allows for example using a windows client and still make use of the
16 < enhanced features of vgwhois.
16 > enhanced features of VGWhoIs.
17 >
18   .SH OPTIONS
19   Try find information about the query (might be multiple words).
20   If no query is given, use the first line from stdin
21  
22   Options:
23 +   \-C dir                  Setting an alternate configuration directory
24     \-h host                 Selecting a fixed whois server for this query
25 <   \-m method:host mirror   Defining a mirror for a given method and host.
25 >   \-m method:host mirror   Defining a mirror for a given method and host
26     \-L                      Use lynx \-source instead of LWP::Simple
27     \-e                      Do not protect e\-mail\-addresses
28 +   \-c                      Do not try to convert to UTF-8. Output server's stream
29     \-v                      Output version of pattern table(s)
30     \-?, \-\-help              Printing this text
31  
32 < .SH FILES
30 < .TP
31 < .IB /etc/vgwhois/pattern.d/*
32 < The pattern file(s) of vgwhois. Contains the list of domain and IP to
33 < server mappings. It is in a machine readable regexp format but should
34 < be easy to understand by humans, too. If you have additions and
35 < corrections please report them always to the authors!
36 < Attention: IPv4, IPv6, TLD and ASN pattern files will be replaced
37 < when the script
38 < .B vgwhois\-pattern\-update
39 < is executed.
40 < The domain pattern file will only be extended without overwriting or deleted anything.
41 < .TP
42 < .IB /etc/vgwhois/debconf.inc
43 < File created depending on debconf question sending mail. Please do
44 < not change manually but instead use dpkg\-reconfigure!
32 > .SH TOOLS
33   .TP
34 < .IB /usr/share/vgwhois/maintenance/pattern\-generator/vgwhois\-pattern\-update
35 < You can run this script to get the latest information according to IPv4, IPv6, ASN and TLD
34 > .IB vgwhois\-pattern\-update
35 > This shortcut leads to the script is located in
36 > .B maintenance/pattern\-generator/vgwhois\-pattern\-update
37 > and can be used to get the latest information according to IPv4, IPv6, ASN and TLD
38   resources from the RIRs. The
39 < .B pattern.d/(ipv4_*|ipv6_*|tld|asn)
40 < files will be overwritten.
39 > .B main/pattern/(ipv4_*|ipv6_*|tld|asn)
40 > files will be overwritten. You can run this script as cronjob to have up-to-date
41 > pattern files. New TLDs are automatically added to the pattern files.
42 > However, changed whois server names need manual changing of the pattern files.
43 >
44 > .TP
45 > .IB vgwhois\-qa\-check
46 > This shortcut leads to the script is located in
47 > .B maintenance/qa\-monitor/run
48 > and performs some basic checks to determine if pattern files need an update.
49 > For example, it will be checked if whois servers in the list are dead.
50 >
51 > .TP
52 > .IB vgwhois\-update
53 > If you have installed VGWhoIs via SVN, an SVN update will be performed
54 > to download the latest version of VGWhoIs and its pattern files.
55 >
56   .SH DIRECTORIES
57 +
58   .TP
59 < .IB /usr/share/vgwhois/maintenance/
60 < In this directory you will find programs which you can use to maintain the pattern files.
59 > .IB main/
60 > Contains the main executable and other libraries.
61 >
62 > .TP
63 > .IB main/pattern/
64 > This directory contains the pattern files of vgwhois which
65 > contain a list of domain and IP to
66 > server mappings. It is in a machine readable regexp format but should
67 > be easy to understand by humans, too.
68 >
69   .TP
70 < .IB /usr/share/vgwhois/subprogram/
70 > .IB main/subprograms/
71   In this directory you'll find "sub programs". They are called by vgwhois by definition in the
72   pattern file and can do complex parsing. You can also call the sub programs independently.
73 +
74   .TP
75 < .IB /var/cache/vgwhois/maintenance/pattern\-generator/
76 < In this directory,
77 < .B /usr/share/vgwhois/maintenance/pattern\-generator/vgwhois\-pattern\-update
63 < will save its downloaded RIR statistics files. If you run the script multiple times (e.g. via cronjob)
64 < and the RIR statistics file has not changed yet, this will save traffic because the file will not be
65 < downloaded twice.
75 > .IB maintenance/
76 > In this directory you will find programs which you can use to maintain the pattern files.
77 >
78   .SH AUTHORS
79   2010\-2019 Daniel Marschall <daniel\-marschall@viathinksoft.de>
80  
# Line 70 | Line 82 | downloaded twice.
82  
83   Some early parts by Lutz Donnerhacke <Lutz.Donnerhacke@Jena.Thur.de>
84   .SH VERSION
85 < 2019xxxx WIP
85 > 20190523
86 >

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines