idn2_lookup_u8(3) [debian man page]

idn2_lookup_u8(3)						      libidn2							 idn2_lookup_u8(3)

NAME

       idn2_lookup_u8 - API function

SYNOPSIS

       #include <idn2.h>

       int idn2_lookup_u8(const uint8_t * src, uint8_t ** lookupname, int flags);

ARGUMENTS

       const uint8_t * src
		   input zero-terminated UTF-8 string in Unicode NFC normalized form.

       uint8_t ** lookupname
		   newly allocated output variable with name to lookup in DNS.

       int flags   optional idn2_flags to modify behaviour.

DESCRIPTION

       Perform	IDNA2008  lookup  string conversion on domain name src, as described in section 5 of RFC 5891.	Note that the input string must be
       encoded in UTF-8 and be in Unicode NFC form.

       Pass IDN2_NFC_INPUT in flags to convert input to NFC form before further processing.  Pass IDN2_ALABEL_ROUNDTRIP in flags  to  convert  any
       input  A-labels	to  U-labels  and perform additional testing.  Multiple flags may be specified by binary or:ing them together, for example
       IDN2_NFC_INPUT | IDN2_ALABEL_ROUNDTRIP.

RETURNS

       On successful conversion IDN2_OK is returned, if the  output  domain  or  any  label  would  have  been	too  long  IDN2_TOO_BIG_DOMAIN	or
       IDN2_TOO_BIG_LABEL is returned, or another error code is returned.

SEE ALSO

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

	      info libidn2

       should give you access to the complete manual.

libidn2 								0.8							 idn2_lookup_u8(3)

idna_to_unicode_8z4z(3) 					      libidn						   idna_to_unicode_8z4z(3)

NAME

       idna_to_unicode_8z4z - convert domain name to Unicode

SYNOPSIS

       #include <idna.h>

       int idna_to_unicode_8z4z(const char * input, uint32_t ** output, int flags);

ARGUMENTS

       const char * input
		   zero-terminated UTF-8 string.

       uint32_t ** output
		   pointer to newly allocated output Unicode string.

       int flags   an Idna_flags value, e.g., IDNA_ALLOW_UNASSIGNED or IDNA_USE_STD3_ASCII_RULES.

DESCRIPTION

       Convert	possibly  ACE  encoded	domain name in UTF-8 format into a UCS-4 string.  The domain name may contain several labels, separated by
       dots.  The output buffer must be deallocated by the caller.

RETURN VALUE

       Returns IDNA_SUCCESS on success, or error code.

REPORTING BUGS

       Report bugs to  <bug-libidn@gnu.org>.   GNU  Libidn  home  page:  http://www.gnu.org/software/libidn/  General  help  using  GNU  software:
       http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 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.

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.

libidn								       1.15						   idna_to_unicode_8z4z(3)