1IDN(1) User Commands IDN(1)
2
3
4
6 idn - Internationalized Domain Names command line tool
7
9 idn [OPTION]... [STRINGS]...
10
12 Internationalized Domain Name (IDN) convert STRINGS, or standard input.
13
14 Command line interface to the internationalized domain name library.
15
16 All strings are expected to be encoded in the preferred charset used by
17 your locale. Use `--debug' to find out what this charset is. You can
18 override the charset used by setting environment variable CHARSET.
19
20 To process a string that starts with `-', for example `-foo', use `--'
21 to signal the end of parameters, as in `idn --quiet -a -- -foo'.
22
23 Mandatory arguments to long options are mandatory for short options
24 too.
25
26 -h, --help
27 Print help and exit
28
29 -V, --version
30 Print version and exit
31
32 -s, --stringprep
33 Prepare string according to nameprep profile
34
35 -d, --punycode-decode
36 Decode Punycode
37
38 -e, --punycode-encode
39 Encode Punycode
40
41 -a, --idna-to-ascii
42 Convert to ACE according to IDNA (default mode)
43
44 -u, --idna-to-unicode
45 Convert from ACE according to IDNA
46
47 --allow-unassigned
48 Toggle IDNA AllowUnassigned flag (default off)
49
50 --usestd3asciirules
51 Toggle IDNA UseSTD3ASCIIRules flag (default off)
52
53 --no-tld
54 Don't check string for TLD specific rules Only for
55 --idna-to-ascii and --idna-to-unicode
56
57 -n, --nfkc
58 Normalize string according to Unicode v3.2 NFKC
59
60 -p, --profile=STRING
61 Use specified stringprep profile instead Valid stringprep pro‐
62 files: `Nameprep', `iSCSI', `Nodeprep', `Resourceprep', `trace',
63 `SASLprep'
64
65 --debug
66 Print debugging information
67
68 --quiet
69 Silent operation
70
72 Written by Simon Josefsson.
73
75 Report bugs to: bug-libidn@gnu.org
76 GNU Libidn home page: <http://www.gnu.org/software/libidn/>
77 General help using GNU software: <https://www.gnu.org/gethelp/>
78
80 Copyright © 2018 Simon Josefsson. License GPLv3+: GNU GPL version 3 or
81 later <https://gnu.org/licenses/gpl.html>.
82 This is free software: you are free to change and redistribute it.
83 There is NO WARRANTY, to the extent permitted by law.
84
86 The full documentation for idn is maintained as a Texinfo manual. If
87 the info and idn programs are properly installed at your site, the com‐
88 mand
89
90 info idn
91
92 should give you access to the complete manual.
93
94
95
96idn 1.35 July 2018 IDN(1)