1idn2_lookup_u8(3)                   libidn2                  idn2_lookup_u8(3)
2
3
4

NAME

6       idn2_lookup_u8 - API function
7

SYNOPSIS

9       #include <idn2.h>
10
11       int  idn2_lookup_u8(const  uint8_t  *  src,  uint8_t ** lookupname, int
12       flags);
13

ARGUMENTS

15       const uint8_t * src
16                   input zero-terminated UTF-8 string in Unicode  NFC  normal‐
17                   ized form.
18
19       uint8_t ** lookupname
20                   newly allocated output variable with name to lookup in DNS.
21
22       int flags   optional idn2_flags to modify behaviour.
23

DESCRIPTION

25       Perform  IDNA2008  lookup  string  conversion  on  domain  name src, as
26       described in section 5 of RFC 5891.  Note that the input string must be
27       encoded in UTF-8 and be in Unicode NFC form.
28
29       Pass  IDN2_NFC_INPUT  in flags to convert input to NFC form before fur‐
30       ther processing.  Pass IDN2_ALABEL_ROUNDTRIP in flags  to  convert  any
31       input  A-labels  to  U-labels and perform additional testing.  Multiple
32       flags may be specified by binary  or:ing  them  together,  for  example
33       IDN2_NFC_INPUT | IDN2_ALABEL_ROUNDTRIP.
34

RETURNS

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

SEE ALSO

41       The  full  documentation for libidn2 is maintained as a Texinfo manual.
42       If the info and libidn2 programs are properly installed at  your  site,
43       the command
44
45              info libidn2
46
47       should give you access to the complete manual.
48
49
50
51libidn2                               0.7                    idn2_lookup_u8(3)