Manual Pages for UNIX Operating System command usage for man libidnkit

Interface Libraries                               libidnkit(3LIB)



NAME
     libidnkit - IDN conversion library

SYNOPSIS
     cc [ flag... ] file... -lidnkit [ library... ]
     #include 


DESCRIPTION
     Functions in this library provide  conversions  between  ACE
     string  and multibyte character string of the current locale
     or a specified codeset. They support  various  manipulations
     of   internationalized   domain  names,  including  encoding
     conversion and name preparation. They are designed according
     to  IDNA  framework where each application must do necessary
     preparations for the internationalized domain  names  before
     passing  them to the resolver. The library provides easy-to-
     use, high-level interfaces to  help  applications  with  the
     preparation.


     The libidnkit library internally uses iconv(3C)  to  provide
     encoding  conversion  from UTF-8 to the local encoding (such
     as ISO8859-1, usually determined by the current locale), and
     from the local encoding to UTF-8.

INTERFACES
     The shared object libidnkit.so.1 provides the public  inter-
     faces defined below. See Intro(3) for additional information
     on shared object interfaces.



     idn_decodename                idn_decodename2
     idn_enable                    idn_encodename
     idn_nameinit


FILES
     /usr/lib/libidnkit.so.1       shared object


     /usr/lib/64/libidnkit.so.1    64-bit shared object


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:







SunOS 5.11          Last change: 15 Aug 2003                    1






Interface Libraries                               libidnkit(3LIB)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | library/idnkit              |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|


SEE ALSO
     Intro(3),  iconv(3C),  idn_decodename(3EXT),  setlocale(3C),
     hosts(4), attributes(5), environ(5)

     RFC 3490           Internationalizing Domain Names in Appli-
                        cations (IDNA)


     RFC 3491           Nameprep: A Stringprep Profile for Inter-
                        nationalized Domain Names (IDN)


     RFC 3492           Punycode:  A   Bootstring   encoding   of
                        Unicode   for   Internationalized  Domain
                        Names in Applications (IDNA)


     RFC 3454           Preparation of Internationalized  Strings
                        ("stringprep")


     RFC 952            DoD Internet Host Table Specification


     RFC 921            Domain   Name    System    Implementation
                        Schedule - Revised


     STD 3, RFC 1122    Requirements for Internet Hosts  --  Com-
                        munication Layers


     STD 3, RFC 1123    Requirements for Internet Hosts -- Appli-
                        cations and Support



     Unicode Standard Annex  #15:  Unicode  Normalization  Forms,
     Version 3.2.0. http://www.unicode.org





SunOS 5.11          Last change: 15 Aug 2003                    2






Interface Libraries                               libidnkit(3LIB)



     International Language Environments Guide (for this  version
     of Solaris)

COPYRIGHT AND LICENSE
     Copyright (c) 2000-2002 Japan  Network  Information  Center.
     All rights reserved.


     By using this file, you agree to the  terms  and  conditions
     set forth bellow.


     LICENSE TERMS AND CONDITIONS


     The following License Terms and Conditions apply,  unless  a
     different license is obtained from Japan Network Information
     Center ("JPNIC"), a Japanese  association,  Kokusai-Kougyou-
     Kanda Bldg 6F, 2-3-4 Uchi-Kanda, Chiyoda-ku, Tokyo 101-0047,
     Japan.

         1.   Use,  Modification  and  Redistribution  (including
              distribution  of  any  modified or derived work) in
              source and/or binary forms is permitted under  this
              License Terms and Conditions.

         2.   Redistribution of source code must retain the copy-
              right  notices  as  they appear in each source code
              file, this License Terms and Conditions.

         3.   Redistribution in binary form  must  reproduce  the
              Copyright  Notice,  this  License  Terms and Condi-
              tions, in the documentation and/or other  materials
              provided with the distribution. For the purposes of
              binary distribution the "Copyright  Notice"  refers
              to the following language: "Copyright (c) 2000-2002
              Japan  Network  Information  Center.   All   rights
              reserved."

         4.   The name of JPNIC may not be  used  to  endorse  or
              promote products derived from this Software without
              specific prior written approval of JPNIC.

         5.   Disclaimer/Limitation of Liability:  THIS  SOFTWARE
              IS  PROVIDED  BY  JPNIC  "AS IS" AND ANY EXPRESS OR
              IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED  TO,
              THE  IMPLIED WARRANTIES OF MERCHANTABILITY AND FIT-
              NESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
              EVENT   SHALL  JPNIC  BE  LIABLE  FOR  ANY  DIRECT,
              INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSE-
              QUENTIAL  DAMAGES  (INCLUDING,  BUT NOT LIMITED TO,
              PROCUREMENT OF SUBSTITUTE GOODS OR  SERVICES;  LOSS



SunOS 5.11          Last change: 15 Aug 2003                    3






Interface Libraries                               libidnkit(3LIB)



              OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
              HOWEVER CAUSED AND  ON  ANY  THEORY  OF  LIABILITY,
              WHETHER  IN  CONTRACT,  STRICT  LIABILITY,  OR TORT
              (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN  ANY
              WAY  OUT  OF  THE  USE  OF  THIS  SOFTWARE, EVEN IF
              ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

















































SunOS 5.11          Last change: 15 Aug 2003                    4