Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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)

Check Out this Related 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)
Man Page