README
1
2Country Codes
3-------------
4
5Author:
6 Diego Javier Grigna <diego@grigna.com>
7
8
9Q: What does this program do?
10
11A: It's an ISO 3166 country code finder. I use it when I enter IRC, when I
12 receive email, when I surf the web, etc, to know, for example, from what
13 country the email cames from.
14
15 Dumb example:
16
17 Suppose that you got email from:
18 somebody1@somesubdomain.somedomain.ar
19 somebody2@somesubdomain.somedomain.it
20 somebody3@somesubdomain.somedomain.lt
21 somebody4@somesubdomain.somedomain.ee
22
23 In this case the last two letters of the domain name are ISO 3166 country
24 codes, (this not always happens, .com, .org, .net are NOT ISO 3166 codes!)
25
26 I am lazy to hold all the ISO 3166 in my mind, or to grep it from a file,
27 it's too much work :)
28 Then I made this program, and when I got some of the above emails I type:
29
30 $
31 $ iso3166 ar it lt ee
32
33 Country 2 letter 3 letter Number
34 ----------------------------------------------------------------------------
35 Argentina ar arg 32
36 Italy it ita 380
37 Lithuania lt ltu 440
38 Estonia ee est 233
39
40 $
41
42 The same applies when I see any domain name (in IRC, HTTP, FTP, etc).
43
44 You could search the table using the 2 or 3 letter codes, using the country
45 number or the country name. Also you could see all the entries in the table
46 using the "-a" command line option.
47
48 --------------------------------------------------------------------------
49 New features is v1.0.2!
50 --------------------------------------------------------------------------
51
52 Now you could enter a domain name, and the program will try to explain it.
53 Example:
54
55 $
56 $ iso3166 -d ftp.somename.org.ar ns2.somehost.edu.cn welcome.to
57
58 Domain name : ftp.somename.org.ar
59 Top domain : ar (Argentina)
60 Sub domain #1: org (Organizations)
61 Sub domain #2: somename (Unknown)
62 Sub domain #3: ftp (File Transfer Protocol)
63
64
65 Domain name : ns2.somehost.edu.cn
66 Top domain : cn (China)
67 Sub domain #1: edu (Educational institutions)
68 Sub domain #2: somehost (Unknown)
69 Sub domain #3: ns2 (Name server)
70
71
72 Domain name : welcome.to
73 Top domain : to (Tonga)
74 Sub domain #1: welcome (Unknown)
75
76
77 $
78
79
80Q: Where can I get this program?
81
82A:
83 See:
84 https://sourceforge.net/projects/countrycodes/
85
86
87Q: Its a naive soft, isn't it?
88
89A: After a long long time (Feb 2003), I'm updating this software,
90 I now that it's may be extremely naive, but I like it, and I
91 feel a bit homesick about it. Also, lots of people use it and
92 asks for updates. Then.. I'll do whatever I want, no matter
93 what people say ;).
94
95
96Q: Where could I get the official ISO 3166 list?
97
98A: From:
99
100 ISO 3166 Maintenance agency (ISO 3166/MA):
101 http://www.iso.org/iso/en/prods-services/iso3166ma/index.html
102
103
104--------------------------------------------------------------------------
105
106If you have (problems|questions|bug|features to add) please do so
107at the countrycodes section on sourceforge.net in the tickets area:
108https://sourceforge.net/p/countrycodes/tickets/
109