|
| 1 | +world -- Print mappings between country names and DNS country codes. |
| 2 | + |
| 3 | +Author: Barry Warsaw |
| 4 | + |
| 5 | + |
| 6 | +This script will take a list of Internet addresses and print out where in the |
| 7 | +world those addresses originate from, based on the top-level domain country |
| 8 | +code found in the address. Addresses can be in any of the following forms: |
| 9 | + |
| 10 | + xx -- just the country code or top-level domain identifier |
| 11 | + host.domain.xx -- any Internet host or network name |
| 12 | + [email protected] -- an Internet email address |
| 13 | + |
| 14 | +If no match is found, the address is interpreted as a regular expression [*] |
| 15 | +and a reverse lookup is attempted. This script will search the country names |
| 16 | +and print a list of matching entries. You can force reverse mappings with the |
| 17 | +`-r' flag (see below). |
| 18 | + |
| 19 | +For example: |
| 20 | + |
| 21 | + %% world tz us |
| 22 | + tz originated from Tanzania, United Republic of |
| 23 | + us originated from United States |
| 24 | + |
| 25 | + %% world united |
| 26 | + united matches 6 countries: |
| 27 | + ae: United Arab Emirates |
| 28 | + uk: United Kingdom (common practice) |
| 29 | + um: United States Minor Outlying Islands |
| 30 | + us: United States |
| 31 | + tz: Tanzania, United Republic of |
| 32 | + gb: United Kingdom |
| 33 | + |
| 34 | + |
| 35 | + [*] Note that regular expressions must conform to Python 1.5's re.py module |
| 36 | + syntax. The comparison is done with the search() method. |
| 37 | + |
| 38 | +Country codes are maintained by the RIPE Network Coordination Centre, |
| 39 | +in coordination with the ISO 3166 Maintenance Agency at DIN Berlin. The |
| 40 | +authoritative source of counry code mappings is: |
| 41 | + |
| 42 | + <url:ftp://info.ripe.net/iso3166-countrycodes> |
| 43 | + |
| 44 | +The latest known change to this information was: |
| 45 | + |
| 46 | + Thu Aug 7 17:59:51 MET DST 1997 |
| 47 | + |
| 48 | +This script also knows about non-geographic top-level domains. |
| 49 | + |
| 50 | +Usage: world [-d] [-p file] [-o] [-h] addr [addr ...] |
| 51 | + |
| 52 | + --dump |
| 53 | + -d |
| 54 | + Print mapping of all top-level domains. |
| 55 | + |
| 56 | + --parse file |
| 57 | + -p file |
| 58 | + Parse an iso3166-countrycodes file extracting the two letter country |
| 59 | + code followed by the country name. Note that the three letter country |
| 60 | + codes and numbers, which are also provided in the standard format |
| 61 | + file, are ignored. |
| 62 | + |
| 63 | + --outputdict |
| 64 | + -o |
| 65 | + When used in conjunction with the `-p' option, output is in the form |
| 66 | + of a Python dictionary, and country names are normalized |
| 67 | + w.r.t. capitalization. This makes it appropriate for cutting and |
| 68 | + pasting back into this file. |
| 69 | + |
| 70 | + --reverse |
| 71 | + -r |
| 72 | + Force reverse lookup. In this mode the address can be any Python |
| 73 | + regular expression; this is matched against all country names and a |
| 74 | + list of matching mappings is printed. In normal mode (e.g. without |
| 75 | + this flag), reverse lookup is performed on addresses if no matching |
| 76 | + country code is found. |
| 77 | + |
| 78 | + -h |
| 79 | + --help |
| 80 | + Print this message. |
| 81 | + |
| 82 | + |
| 83 | +Local Variables: |
| 84 | +indent-tabs-mode: nil |
| 85 | +End: |
0 commit comments