idn2(1)

idn21

Libidn2 internationalized domain names conversion tool

Usage

idn2 [OPTION] ... [STRINGS] ...

Overview

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.

Internationalized Domain Name (IDNA2008) convert STRINGS, or standard input.

Command line interface to the Libidn2 implementation of IDNA2008.

All strings are expected to be encoded in the locale charset.

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

Mandatory arguments to long options are mandatory for short options too.

-h, --help

Print help and exit

-V, --version

Print version and exit

-d, --decode

Decode (punycode) domain name

-l, --lookup

Lookup domain name (default)

-r, --register

Register label

-T, --tr46t

Enable TR46 transitional processing

-N, --tr46nt

Enable TR46 non-transitional processing

--no-tr46

Disable TR46 processing

--usestd3asciirules

Enable STD3 ASCII rules

--no-alabelroundtrip

Disable A-label roundtrip for lookups

--debug

Print debugging information

--quiet

Silent operation

Releases

8 releases since Debian 7 (Wheezy); the text changed 7 times.

  1. 7
  2. 8
  3. 9
  4. 10
  5. 11
  6. 12
  7. 13
  8. Arch

--decode since Debian 10 (Buster); --no-alabelroundtrip since Debian 12 (Bookworm); --no-tr46 since Debian 10 (Buster); --tr46nt since Debian 9 (Stretch); --tr46t since Debian 9 (Stretch); --usestd3asciirules since Debian 10 (Buster); -N since Debian 9 (Stretch); -T since Debian 9 (Stretch); -d since Debian 10 (Buster).

Author

Written by Simon Josefsson, Tim Ruehsen.

Reporting bugs

Report bugs to: [email protected]
Libidn2 home page: <https://www.gnu.org/software/libidn/#libidn2>
General help using GNU software: <https://www.gnu.org/gethelp/>

From libidn2 2.3.8-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.