summaryrefslogtreecommitdiffstats
path: root/Tools/world/README
diff options
context:
space:
mode:
authorBarry Warsaw <barry@python.org>1998-12-05 22:19:06 (GMT)
committerBarry Warsaw <barry@python.org>1998-12-05 22:19:06 (GMT)
commit08833f2a6dce778a3b1cde627d853441dcce5844 (patch)
tree81d8f13bab37c451b028ad5cafe6bf90b77ee56a /Tools/world/README
parente1425d6a33beb4e4a4125552790c6087930ecb0b (diff)
downloadcpython-08833f2a6dce778a3b1cde627d853441dcce5844.zip
cpython-08833f2a6dce778a3b1cde627d853441dcce5844.tar.gz
cpython-08833f2a6dce778a3b1cde627d853441dcce5844.tar.bz2
intermediate
Diffstat (limited to 'Tools/world/README')
-rw-r--r--Tools/world/README85
1 files changed, 85 insertions, 0 deletions
diff --git a/Tools/world/README b/Tools/world/README
new file mode 100644
index 0000000..659def5
--- /dev/null
+++ b/Tools/world/README
@@ -0,0 +1,85 @@
+world -- Print mappings between country names and DNS country codes.
+
+Author: Barry Warsaw
+Email: bwarsaw@python.org
+
+This script will take a list of Internet addresses and print out where in the
+world those addresses originate from, based on the top-level domain country
+code found in the address. Addresses can be in any of the following forms:
+
+ xx -- just the country code or top-level domain identifier
+ host.domain.xx -- any Internet host or network name
+ somebody@where.xx -- an Internet email address
+
+If no match is found, the address is interpreted as a regular expression [*]
+and a reverse lookup is attempted. This script will search the country names
+and print a list of matching entries. You can force reverse mappings with the
+`-r' flag (see below).
+
+For example:
+
+ %% world tz us
+ tz originated from Tanzania, United Republic of
+ us originated from United States
+
+ %% world united
+ united matches 6 countries:
+ ae: United Arab Emirates
+ uk: United Kingdom (common practice)
+ um: United States Minor Outlying Islands
+ us: United States
+ tz: Tanzania, United Republic of
+ gb: United Kingdom
+
+
+ [*] Note that regular expressions must conform to Python 1.5's re.py module
+ syntax. The comparison is done with the search() method.
+
+Country codes are maintained by the RIPE Network Coordination Centre,
+in coordination with the ISO 3166 Maintenance Agency at DIN Berlin. The
+authoritative source of counry code mappings is:
+
+ <url:ftp://info.ripe.net/iso3166-countrycodes>
+
+The latest known change to this information was:
+
+ Thu Aug 7 17:59:51 MET DST 1997
+
+This script also knows about non-geographic top-level domains.
+
+Usage: world [-d] [-p file] [-o] [-h] addr [addr ...]
+
+ --dump
+ -d
+ Print mapping of all top-level domains.
+
+ --parse file
+ -p file
+ Parse an iso3166-countrycodes file extracting the two letter country
+ code followed by the country name. Note that the three letter country
+ codes and numbers, which are also provided in the standard format
+ file, are ignored.
+
+ --outputdict
+ -o
+ When used in conjunction with the `-p' option, output is in the form
+ of a Python dictionary, and country names are normalized
+ w.r.t. capitalization. This makes it appropriate for cutting and
+ pasting back into this file.
+
+ --reverse
+ -r
+ Force reverse lookup. In this mode the address can be any Python
+ regular expression; this is matched against all country names and a
+ list of matching mappings is printed. In normal mode (e.g. without
+ this flag), reverse lookup is performed on addresses if no matching
+ country code is found.
+
+ -h
+ --help
+ Print this message.
+
+
+Local Variables:
+indent-tabs-mode: nil
+End: