Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

tld_check_8z (3)

Name

tld_check_8z - API function

Synopsis

#include <tld.h>

int  tld_check_8z(const  char * in, size_t * errpos, const Tld_table **
overrides);

Description

tld_check_8z(3)                     libidn                     tld_check_8z(3)



NAME
       tld_check_8z - API function

SYNOPSIS
       #include <tld.h>

       int  tld_check_8z(const  char * in, size_t * errpos, const Tld_table **
       overrides);

ARGUMENTS
       const char * in
                   Zero-terminated UTF8 string to process.

       size_t * errpos
                   Position of offending character is returned here.

       const Tld_table ** overrides
                   A Tld_table array of additional domain  restriction  struc-
                   tures  that  complement and supersede the built-in informa-
                   tion.

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  over-
       rides  is NULL, only the built-in information is used.  The position 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 Tld_rc value TLD_SUCCESS  if  all  characters
       are  valid  or  when   tld  is  null, TLD_INVALID if a character is not
       allowed, or additional error codes on general failure conditions.

REPORTING BUGS
       Report bugs to <bug-libidn@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GNU Libidn home page: http://www.gnu.org/software/libidn/


COPYRIGHT
       Copyright (C) 2002-2016 Simon Josefsson.
       Copying and distribution of this file, with  or  without  modification,
       are  permitted  in  any  medium  without royalty provided the copyright
       notice and this notice are preserved.


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


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/libidn   |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

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.  As an  alternative  you
       may obtain the manual from:

              http://www.gnu.org/software/libidn/manual/

NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source                was                downloaded                from
       https://ftp.gnu.org/gnu/libidn/libidn-1.34.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/libidn.



libidn                               1.34                      tld_check_8z(3)