git: 9front

ref: a5c95b4b01752b3ab38b44ab7a99a020739e3a80
dir: /sys/man/2/idn/

View raw version
.TH IDN 2
.SH NAME
utf2idn, idn2utf \- convert internationalized domain names to and from unicode
.SH SYNOPSIS
.B #include <u.h>
.br
.B #include <libc.h>
.PP
.B
int	utf2idn(char *name, char *buf, int nbuf);
.PP
.B
int	idn2utf(char *name, char *buf, int nbuf);
.SH DESCRIPTION
These routines handle encoding and decoding of domain
names as specified by RFC5890.
.PP
.I Utf2idn
encodes the
.SM UTF
string
.I name
to
.SM ASCII
internatlionalized domain name in
.IR buf .
.I Idn2utf
does the reverse, decoding the
.SM ASCII
string
.I name
back to
.SM UTF
in
.IR buf .
The maximum size of
.I buf
is gived by
.IR nbuf .
.SH SOURCE
.B /sys/src/libc/9sys/idn.c
.SH "SEE ALSO"
.B /lib/rfc/rfc5890
.br
.IR utf (6)
.SH DIAGNOSTICS
The return value is the number of bytes (excluding the terminating NULL) in
.I buf
or
.B -1
on failure.