.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.1.
.TH IDN "1" "January 2024" "GNU Libidn 1.42" "User Commands"
.SH NAME
idn \- Internationalized Domain Names command line tool
.SH SYNOPSIS
.B idn
[\fI\,OPTION\/\fR]... [\fI\,STRINGS\/\fR]...
.SH DESCRIPTION
Internationalized Domain Name (IDN) convert STRINGS, or standard input.
.PP
Command line interface to the internationalized domain name library.
.PP
All strings are expected to be encoded in the preferred charset used
by your locale.  Use \fB\-\-debug\fR to find out what this charset is.  You
can override the charset used by setting environment variable CHARSET.
.PP
To process a string that starts with '\-', for example '\-foo', use '\-\-'
to signal the end of parameters, as in: idn \fB\-\-quiet\fR \fB\-a\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\-s\fR, \fB\-\-stringprep\fR
Prepare string according to nameprep profile
.TP
\fB\-d\fR, \fB\-\-punycode\-decode\fR
Decode Punycode
.TP
\fB\-e\fR, \fB\-\-punycode\-encode\fR
Encode Punycode
.TP
\fB\-a\fR, \fB\-\-idna\-to\-ascii\fR
Convert to ACE according to IDNA (default mode)
.TP
\fB\-u\fR, \fB\-\-idna\-to\-unicode\fR
Convert from ACE according to IDNA
.TP
\fB\-\-allow\-unassigned\fR
Toggle IDNA AllowUnassigned flag (default off)
.TP
\fB\-\-usestd3asciirules\fR
Toggle IDNA UseSTD3ASCIIRules flag (default off)
.TP
\fB\-\-no\-tld\fR
Don't check string for TLD specific rules
Only for \fB\-\-idna\-to\-ascii\fR and \fB\-\-idna\-to\-unicode\fR
.TP
\fB\-n\fR, \fB\-\-nfkc\fR
Normalize string according to Unicode v3.2 NFKC
.TP
\fB\-p\fR, \fB\-\-profile\fR=\fI\,STRING\/\fR
Use specified stringprep profile instead
Valid stringprep profiles: Nameprep
iSCSI Nodeprep Resourceprep trace SASLprep
.TP
\fB\-\-debug\fR
Print debugging information
.TP
\fB\-\-quiet\fR
Silent operation
.SH AUTHOR
Written by Simon Josefsson.
.SH "REPORTING BUGS"
Report bugs to: help\-libidn@gnu.org
.br
GNU Libidn home page: <https://www.gnu.org/software/libidn/>
.br
General help using GNU software: <https://www.gnu.org/gethelp/>
.SH COPYRIGHT
Copyright \(co 2024 Simon Josefsson.
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"
The full documentation for
.B idn
is maintained as a Texinfo manual.  If the
.B info
and
.B idn
programs are properly installed at your site, the command
.IP
.B info idn
.PP
should give you access to the complete manual.