diff options
author | Barry Warsaw <barry@python.org> | 1998-12-05 22:19:06 (GMT) |
---|---|---|
committer | Barry Warsaw <barry@python.org> | 1998-12-05 22:19:06 (GMT) |
commit | 08833f2a6dce778a3b1cde627d853441dcce5844 (patch) | |
tree | 81d8f13bab37c451b028ad5cafe6bf90b77ee56a /Tools/world/README | |
parent | e1425d6a33beb4e4a4125552790c6087930ecb0b (diff) | |
download | cpython-08833f2a6dce778a3b1cde627d853441dcce5844.zip cpython-08833f2a6dce778a3b1cde627d853441dcce5844.tar.gz cpython-08833f2a6dce778a3b1cde627d853441dcce5844.tar.bz2 |
intermediate
Diffstat (limited to 'Tools/world/README')
-rw-r--r-- | Tools/world/README | 85 |
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: |