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.
idndecodename idndecodename2
idnenable idnencodename
idnnameinit
FILES
/usr/lib/libidnkit.so.1 shared object
/usr/lib/64/libidnkit.so.1 64-bit shared object
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 15 Aug 2003 1
Interface Libraries libidnkit(3LIB)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWidnl
Interface Stability Evolving
MT-Level Unsafe
SEE ALSO
Intro(3), iconv(3C), idndecodename(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 EXPRES OR
IMPLIED WARANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARANTIES OF MERCHANTABILITY AND FIT-
NES FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
EVENT SHAL JPNIC BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSE-
QUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GODS OR SERVICES; LOS
SunOS 5.11 Last change: 15 Aug 2003 3
Interface Libraries libidnkit(3LIB)
OF USE, DATA, OR PROFITS; OR BUSINES INTERUPTION)
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 POSIBILITY OF SUCH DAMAGES.
SunOS 5.11 Last change: 15 Aug 2003 4
|
