idncheck(1)

✨ NAME ✨

okay so bestie, meet idncheck — the idncheck(1) command from the General Commands Manual that checks an internationalized domain name. That's the whole name-vibe: idncheck — check an internationalized domain name. 💅

🌸 SYNOPSIS 🌸

idncheck [options..] name

🦋 DESCRIPTION 🦋

okay so idncheck checks an internationalized domain name. It tries to convert name to A-labels with various checks defined by IDNA2008-Protocol. No cap. ✨

If the given name is a valid internationalized domain name, idncheck outputs the message:

passed.

to standard error and returns with exit code 0. Also note: traditional ASCII domain names are considered valid too, bestie. 🫶

If the name is not valid, it outputs the reason (e.g. invalid encoding) to standard error and returns with exit code 2. If an internal error such as memory exhaustion is caused, idncheck outputs the reason to standard error and then returns with exit code 3. 😭

Unless -noconf (or -C) option is given, idncheck reads a configuration file (/nix/store/hcyf58m2phm5bg6ch5a4lkif5fpf1lck-idnkit-2.3/etc/idn2.conf, ~/.idn2rc or a file specified by an option) and performs conversions according to the parameters specified in the file. 🎀

💖 OPTIONS 💖

• -in in-code, -i in-code — specify the encoding name of the domain name specified as an argument. Any of the following encoding names can be recognized:
  • Any encoding names which iconv_open() accepts
  • Punycode
  • UTF-8
  • Any alias names for the above, defined by the encoding alias file.

The encoding defaults to the value of the environment variable IDN_LOCAL_CODESET or, if it is not set, an encoding determined from the locale information. 🌈

• -conf file, -c file — specify the path of idnkit configuration file. If not specified, the default path (/nix/store/hcyf58m2phm5bg6ch5a4lkif5fpf1lck-idnkit-2.3/etc/idn2.conf or ~/.idn2rc) unless -noconf (or -C) option is specified. 🎀
• -noconf, -C — suppress reading a configuration file. 🙈
• -registration, -g (default) — use domain name registration protocol. This is the default behavior. 👑
• -lookup, -l — use domain name lookup protocol. 🔍
• -nomap, -M — don't perform the map action. This is the same as -skip map. 💀
• -skip action,... — skip actions. The following action names are recognized:
  • map — mappings
  • asclower — convert ASCII uppercase letters to lowercase
  • rtconv — conversion from Punycode to Unicode for round trip check
  • prohcheck — prohibited code point check
  • unascheck — unassigned code point check
  • nfccheck — NFC conformance check
  • prefcheck — ACE prefix check
  • hyphcheck — hyphen check
  • combcheck — combining character check
  • ctxjcheck — CONTEXTJ code point check
  • ctxocheck — CONTEXTO code point check for domain name registration protocol.
  • ctxolitecheck — CONTEXTO code point check for domain name lookup protocol.
  • bidicheck — Bidi check.
  • idnconv — conversion to Punycode
  • lencheck — label length check
  • rtcheck — round trip check
• -localcheck file, -e file — also perform code point check using file. Using the local check feature, you can check whether a domain name consists of code points allowed by a particular registry. The format of file is explained in idn_setlocalcheckfile(3). 🧚
• -quiet, -q — suppress a result message; yield exit status only. 🤫
• -test, -t — print which language, input encoding and output encoding will be chosen if the same arguments are given to the command, and then quit immediately. ⭐
• -version, -v — print version information and quit. 💖
• -help, -h — print help and quit. 🎀

🌈 LOCAL ENCODING 🌈

idncheck guesses local encoding from locale and environment variables. See the LOCAL ENCODING section in idn2.conf(5) for more details. 💜

🔥 SEE ALSO 🔥

idncmp(1), idnconv2(1), iconv(3), idn2.conf(5), idnalias.conf(5), idnlang.conf(5)

💀 BUGS 💀

The automatic input-code selection depends on your system, and sometimes it cannot guess or guess wrong. It is better to explicitly specify it using the -in option. 🫠

---

okay that's the whole page, bestie — cute sign-off: Sep 21, 2012 · idncheck(1) · mwah 💋✨