Go to main content

man pages section 5: File Formats

Exit Print View

Updated: Wednesday, February 10, 2021

idnalias.conf (5)


idnalias.conf - encoding alias file for idnkit




idnalias.conf(5)              File Formats Manual             idnalias.conf(5)

       idnalias.conf - encoding alias file for idnkit


       The  idnalias.conf  file  defines  aliases  of  encoding  names.  It is
       located  on  /etc/idnalias.conf  and  always  loaded  automatically  as
       idn2.conf and .idn2rc.

       When  the idnkit library encodes or decodes an internationalized domain
       name, it converts the  domain  name  between  a  local  encoding  (e.g.
       ISO8859-1)  and Unicode using iconv().  At run time, the idnkit library
       guesses the local encoding from locale information to  do  the  conver-
       sions,  but  iconv()  may  not know the encoding name taken from locale
       information.  Using idnalias.conf, you can avoid the trouble.

       The aliases in this file can be used just as the real names.  The alias
       file  is  a  simple  text file, consisting of lines (other than comment
       lines, which begin with ``#'', and empty lines) of the form:

           alias-name real-name

       where alias-name is an alias name to be defined, and real-name  is  its
       real name or another alias name.  ``*'' in alias-name has special mean-
       ing. It matches any string, including an empty string.

       The following shows a sample idnalias.conf file.

           # idnalias.conf sample.
           *.ISO_8859-1    ISO-8859-1
           *.ISO_8859-2    ISO-8859-2
           *.SJIS          Shift_JIS
           *.Shift_JIS     Shift_JIS
           ja_JP.EUC       EUC-JP
           ko_KR.EUC       EUC-KR
           *.big5          Big5
           *.Big5          Big5
           *.KOI8-R        KOI8-R
           *.GB2312        GB2312
           ja              EUC-JP
           japanese        EUC-JP


       See attributes(7) for descriptions of the following attributes:

       |Availability   | library/idnkit   |
       |Stability      | Committed        |
       To avoid potential security issues, the library functions will check if
       the  configuration  files are in a proper access mode (0444) and owner-
       ship (root:sys). If they are not in the proper access  mode  or  owner-
       ship,  the function will not read and use the configurations defined in
       the files, but use the default values. In this case, a warning  message
       will be issued, for example:

         idn_nameinit: warning: config file (/etc/idn2.conf) not in proper
                                access mode or ownership - the file ignored.

       In  the  same  security  concern,  while  they are mentioned in the man
       pages, all user configuration files  (i.e.,  $(HOME)/.idn2rc)  will  be
       ignored as if the files do not exist.

       idncheck(1), idncmp(1), idnconv2(1), iconv(3), idn_setlocalencoding(3),
       idn2.conf(5), idnlang.conf(5)

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was downloaded from  https://jprs.co.jp/idn/idnkit-2.3.tar.bz2

       Further information about this software can be found on the open source
       community website at https://jprs.co.jp/idn.

                                 Sep 21, 2012                 idnalias.conf(5)