idn2_lookup_ul(3) [debian man page]

idn2_lookup_ul(3)						      libidn2							 idn2_lookup_ul(3)

NAME

       idn2_lookup_ul - API function

SYNOPSIS

       #include <idn2.h>

       int idn2_lookup_ul(const char * src, char ** lookupname, int flags);

ARGUMENTS

       const char * src
		   input zero-terminated locale encoded string.

       char ** 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 is assumed to be
       encoded in the locale's default coding system, and will be transcoded to UTF-8 and NFC normalized by this function.

       Pass IDN2_ALABEL_ROUNDTRIP in flags to convert any input A-labels to U-labels and perform additional testing.

RETURNS

       On successful conversion IDN2_OK is returned, if conversion from locale to UTF-8 fails then IDN2_ICONV_FAIL  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_ul(3)

idna_to_unicode_8zlz(3) 					      libidn						   idna_to_unicode_8zlz(3)

NAME

       idna_to_unicode_8zlz - API function

SYNOPSIS

       #include <idna.h>

       int idna_to_unicode_8zlz(const char * input, char ** output, int flags);

ARGUMENTS

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

       char ** output
		   pointer to newly allocated output string encoded in the current locale's character set.

       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 string encoded in the current locale's character set.  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-2013 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.28						   idna_to_unicode_8zlz(3)