
Country Codes
-------------

Author: 
         Diego Javier Grigna <diego@grigna.com>


Q: What does this program do?

A: It's an ISO 3166 country code finder. I use it when I enter IRC, when I
   receive email, when I surf the web, etc, to know, for example, from what
   country the email cames from. 
 
   Dumb example:
  
   Suppose that you got email from:
       somebody1@somesubdomain.somedomain.ar
       somebody2@somesubdomain.somedomain.it
       somebody3@somesubdomain.somedomain.lt
       somebody4@somesubdomain.somedomain.ee

   In this case the last two letters of the domain name are ISO 3166 country
   codes, (this not always happens, .com, .org, .net are NOT ISO 3166 codes!)
 
   I am lazy to hold all the ISO 3166 in my mind, or to grep it from a file,
   it's too much work :)
   Then I made this program, and when I got some of the above emails I type:

   $
   $ iso3166 ar it lt ee

   Country                                          2 letter  3 letter  Number
   ----------------------------------------------------------------------------
   Argentina                                            ar       arg      32
   Italy                                                it       ita     380
   Lithuania                                            lt       ltu     440
   Estonia                                              ee       est     233
   
   $

   The same applies when I see any domain name (in IRC, HTTP, FTP, etc).

   You could search the table using the 2 or 3 letter codes, using the country
   number or the country name. Also you could see all the entries in the table
   using the "-a" command line option.

   --------------------------------------------------------------------------
   New features is v1.0.2!
   --------------------------------------------------------------------------

   Now you could enter a domain name, and the program will try to explain it.
   Example:

   $
   $ iso3166 -d ftp.somename.org.ar ns2.somehost.edu.cn welcome.to

   Domain name  : ftp.somename.org.ar
   Top domain   : ar       (Argentina)
   Sub domain #1: org      (Organizations)
   Sub domain #2: somename         (Unknown)
   Sub domain #3: ftp      (File Transfer Protocol)


   Domain name  : ns2.somehost.edu.cn
   Top domain   : cn       (China)
   Sub domain #1: edu      (Educational institutions)
   Sub domain #2: somehost         (Unknown)
   Sub domain #3: ns2      (Name server)


   Domain name  : welcome.to
   Top domain   : to       (Tonga)
   Sub domain #1: welcome  (Unknown)


   $


Q: Where can I get this program?

A:
   See:
    https://sourceforge.net/projects/countrycodes/


Q: Its a naive soft, isn't it?

A: After a long long time (Feb 2003), I'm updating this software,
   I now that it's may be extremely naive, but I like it, and I
   feel a bit homesick about it. Also, lots of people use it and
   asks for updates. Then.. I'll do whatever I want, no matter
   what people say ;).


Q: Where could I get the official ISO 3166 list?

A: From:

    ISO 3166 Maintenance agency (ISO 3166/MA):
    http://www.iso.org/iso/en/prods-services/iso3166ma/index.html


--------------------------------------------------------------------------

If you have (problems|questions|bug|features to add) please do so 
at the countrycodes section on sourceforge.net in the tickets area:
https://sourceforge.net/p/countrycodes/tickets/
