Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

tld_check_4 (3)

Name

tld_check_4 - API function

Synopsis

#include <tld.h>

int  tld_check_4(const  uint32_t  *  in, size_t inlen, size_t * errpos,
const Tld_table ** overrides);

Description

tld_check_4(3)                      libidn                      tld_check_4(3)



NAME
       tld_check_4 - API function

SYNOPSIS
       #include <tld.h>

       int  tld_check_4(const  uint32_t  *  in, size_t inlen, size_t * errpos,
       const Tld_table ** overrides);

ARGUMENTS
       const uint32_t * in
                   Array of unicode code points to process. Does not  need  to
                   be zero terminated.

       size_t inlen
                   Number of unicode code points.

       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 code points 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 .

       Return  value:  Returns the Tld_rc value TLD_SUCCESS if all code points
       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_4(3)