OS Manuals

/usr/bin/idn

Encode/Decode library for internationalized domain names

From libidn 1.44-r6 (os), captured 2026-11-05 by running idn --help (exit 0). permalink

Usage: /usr/bin/idn [OPTION]... [STRINGS]...
Internationalized Domain Name (IDN) convert STRINGS, or standard input.

Command line interface to the internationalized domain name library.

All strings are expected to be encoded in the preferred charset used
by your locale.  Use --debug to find out what this charset is.  You
can override the charset used by setting environment variable CHARSET.

To process a string that starts with '-', for example '-foo', use '--'
to signal the end of parameters, as in: idn --quiet -a -- -foo

Mandatory arguments to long options are mandatory for short options too.
  -h, --help               Print help and exit
  -V, --version            Print version and exit
  -s, --stringprep         Prepare string according to nameprep profile
  -d, --punycode-decode    Decode Punycode
  -e, --punycode-encode    Encode Punycode
  -a, --idna-to-ascii      Convert to ACE according to IDNA (default mode)
  -u, --idna-to-unicode    Convert from ACE according to IDNA
      --allow-unassigned   Toggle IDNA AllowUnassigned flag (default off)
      --usestd3asciirules  Toggle IDNA UseSTD3ASCIIRules flag (default off)
      --no-tld             Don't check string for TLD specific rules
                             Only for --idna-to-ascii and --idna-to-unicode
  -n, --nfkc               Normalize string according to Unicode v3.2 NFKC
  -p, --profile=STRING     Use specified stringprep profile instead
                             Valid stringprep profiles: Nameprep
                             iSCSI Nodeprep Resourceprep trace SASLprep
      --debug              Print debugging information
      --quiet              Silent operation

Report bugs to: help-libidn@gnu.org
GNU Libidn home page: <https://www.gnu.org/software/libidn/>
General help using GNU software: <https://www.gnu.org/gethelp/>
Options (14)
OptionDescriptionSource
-h, --helpPrint help and exithelp + man
-V, --versionPrint version and exithelp + man
-s, --stringprepPrepare string according to nameprep profilehelp + man
-d, --punycode-decodeDecode Punycodehelp + man
-e, --punycode-encodeEncode Punycodehelp + man
-a, --idna-to-asciiConvert to ACE according to IDNA (default mode)help + man
-u, --idna-to-unicodeConvert from ACE according to IDNAhelp + man
--allow-unassignedToggle IDNA AllowUnassigned flag (default off)help + man
--usestd3asciirulesToggle IDNA UseSTD3ASCIIRules flag (default off)help + man
--no-tldDon't check string for TLD specific rules Only for --idna-to-ascii and --idna-to-unicodehelp + man
-n, --nfkcNormalize string according to Unicode v3.2 NFKChelp + man
-p, --profile STRINGUse specified stringprep profile instead Valid stringprep profiles: Nameprep iSCSI Nodeprep Resourceprep trace SASLprephelp + man
--debugPrint debugging informationhelp + man
--quietSilent operationhelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.