libidn                                            tldchecklz(3)



NAME
     tldchecklz - verify that characters are permitted

SYNOPSIS
     #include 

     int tldchecklz(const char * in,  sizet  *  errpos,  const
     Tldtable ** overrides

ARGUMENTS
     const char * in
                 Zero-terminated string in  the  current  locales
                 encoding to process.

     sizet * errpos
                 Position  of  offending  character  is  returned
                 here.

     const Tldtable ** overrides
                 A Tldtable array of additional domain  restric-
                 tion  structures  that  complement and supersede
                 the built-in information.

DESCRIPTION
     Test each of the characters in in for whether  or  not  they
     are  allowed  by  the  information  in  overrides  or by the
     built-in TLD restriction data. When data for the same TLD is
     available  both internally and in overrides, the information
     in overrides takes precedence.  If  several  entries  for  a
     specific TLD are found, the first one is used.  If overrides
     is NUL, only the built-in information is used.   The  posi-
     tion of the first offending character is returned in errpos.
     Note that the error position refers to the decoded character
     offset rather than the byte position in the string.

RETURN VALUE
     Returns the Tldrc value TLDSUCES if all  characters  are
     valid or when tld is null, TLDINVALID if a character is not
     allowed, or additional error codes on general failure condi-
     tions.

REPORTING BUGS
     Report bugs to .

COPYRIGHT
     Copyright O 2002, 2003, 2004, 2005, 2006, 2007,  2008  Simon
     Josefsson.
     Permission is granted to make and distribute verbatim copies
     of  this  manual provided the copyright notice and this per-
     mission notice are preserved on all copies.





libidn                  Last change: 1.9                        1






libidn                                            tldchecklz(3)



SEE ALSO
     The full documentation for libidn is maintained as a Texinfo
     manual.   If  the  info  and  libidn  programs  are properly
     installed at your site, the command

          info libidn

     should give you access to the complete manual.

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

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWlibidn     
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for LibIDN is available on http:/opensolaris.org.
































libidn                  Last change: 1.9                        2