Go to main content

man pages section 5: File Formats

Exit Print View

Updated: Wednesday, February 10, 2021

idnlang.conf (5)


idnlang.conf - language alias file for idnkit




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

       idnlang.conf - language alias file for idnkit


       The idnlang.conf file defines aliases of language names.  It is located
       on /etc/idnlang.conf and always loaded automatically as  idn2.conf  and
       .idn2rc.  The aliases in this file can be used just as the real names.

       As  described  in  idn2.conf(5),  idnkit  has a configuration parameter
       named ``current language''.  Unless the current language  is  specified
       by  the ``language'' entry in the idnkit configuration file, the idnkit
       library guesses the current language from  locale  information  at  run
       time.   The  idnkit library assumes the language name is an ISO639 lan-
       guage code (e.g. ``en''), but  the  language  name  taken  from  locale
       information may not be (e.g. ``English'').  Using idnlang.conf, you can
       avoid the trouble.

       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.

       The following shows a sample idnlang.conf file.

           # idnlang.conf sample.
           Azeri          ar
           Lithuanian     lt
           Turkish        tr


       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_setlanguage(3),
       idn2.conf(5), idnalias.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                  idnlang.conf(5)