.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
.TH IDN2 "1" "March 2025" "Libidn2 2.3.8" "User Commands"
.SH NAME
idn2 \- Libidn2 Internationalized Domain Names conversion tool
.SH SYNOPSIS
.B idn2
[\fI\,OPTION\/\fR]... [\fI\,STRINGS\/\fR]...
.SH DESCRIPTION
The idn2 tool converts DNS domains from UTF-8 to ASCII compatible encoding
(ACE) form, as used in the DNS protocol. The encoding format is the
Internationalized Domain Name (IDNA2008/TR46) format.
.PP
Internationalized Domain Name (IDNA2008) convert STRINGS, or standard input.
.PP
Command line interface to the Libidn2 implementation of IDNA2008.
.PP
All strings are expected to be encoded in the locale charset.
.PP
To process a string that starts with `\-', for example `\-foo', use `\-\-'
to signal the end of parameters, as in `idn2 \fB\-\-quiet\fR \fB\-\-\fR \fB\-foo\fR'.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version and exit
.TP
\fB\-d\fR, \fB\-\-decode\fR
Decode (punycode) domain name
.TP
\fB\-l\fR, \fB\-\-lookup\fR
Lookup domain name (default)
.TP
\fB\-r\fR, \fB\-\-register\fR
Register label
.TP
\fB\-T\fR, \fB\-\-tr46t\fR
Enable TR46 transitional processing
.TP
\fB\-N\fR, \fB\-\-tr46nt\fR
Enable TR46 non\-transitional processing
.TP
\fB\-\-no\-tr46\fR
Disable TR46 processing
.TP
\fB\-\-usestd3asciirules\fR
Enable STD3 ASCII rules
.TP
\fB\-\-no\-alabelroundtrip\fR
Disable A\-label roundtrip for lookups
.TP
\fB\-\-debug\fR
Print debugging information
.TP
\fB\-\-quiet\fR
Silent operation
.SH AUTHOR
Written by Simon Josefsson, Tim Ruehsen.
.SH "REPORTING BUGS"
Report bugs to: help\-libidn@gnu.org
.br
Libidn2 home page: <https://www.gnu.org/software/libidn/#libidn2>
.br
General help using GNU software: <https://www.gnu.org/gethelp/>
.SH COPYRIGHT
Copyright \(co 2011\-2025 Simon Josefsson, Tim Ruehsen.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
idn(1)
.PP
The full documentation for
.B idn2
is maintained as a Texinfo manual.  If the
.B info
and
.B idn2
programs are properly installed at your site, the command
.IP
.B info idn2
.PP
should give you access to the complete manual.
