idncmp(1)

🦋 idncmp(1) 🦋

okay bestie, welcome to the <pink>idncmp</pink> page — it lives in the General Commands Manual and it's genuinely one of the most useful little gremlins in the idnkit toolbox 💅

---

✨ NAME ✨

idncmp — compare internationalized domain names 🫶

---

🌸 SYNOPSIS 🌸

idncmp [options..] name1 name2

---

💖 DESCRIPTION 💖

so here's the vibe: idncmp takes name1 and name2 (both internationalized domain names), tries to convert each one to its A-label form, and then compares them. that's it. that's the whole job. iconic behavior honestly 👑

if they're equivalent, idncmp prints this message:

matched.

to standard error and exits with code 0 ✨

if they're different, it prints:

unmatched.

to standard error and exits with code 1 😭

if name1, name2, or both of them are not valid internationalized domain names, it prints the reason (like invalid encoding) to standard error and exits with code 2 💀

and if an internal error happens — memory exhaustion, for example — it prints the reason to standard error and exits with code 3 🙈

heads up: every result goes to standard error, not stdout. plan your scripts accordingly, bestie 🍓

---

unless you pass the -noconf (or -C) option, idncmp reads a configuration file and does its conversions according to the parameters specified in that file. the default config path is /nix/store/hcyf58m2phm5bg6ch5a4lkif5fpf1lck-idnkit-2.3/etc/idn2.conf or ~/.idn2rc, or you can point it at your own file with an option 🌸

---

🎀 OPTIONS 🎀

• -in in-code, -i in-code — set the encoding name for the domain names you're passing as arguments. the following encoding names are 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 that isn't set, to an encoding determined from the locale information 🌈

• -conf file, -c file — give the path of the idnkit configuration file. if you don't specify one, the default path (/nix/store/hcyf58m2phm5bg6ch5a4lkif5fpf1lck-idnkit-2.3/etc/idn2.conf or ~/.idn2rc) is used — unless -noconf (or -C) is specified 🎀
• -noconf, -C — suppress reading a configuration file. no config, no problem ✨
• -registration, -g — use the domain name registration protocol.
• -lookup, -l (default) — use the domain name lookup protocol. this is the default behavior, so you get it for free 💜
• -nomap, -M — don't perform the map action. literally 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 a local code point check using file. with 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 the result message; yield the exit status only. silent but deadly, love that for you 🤫
• -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. (the original page says gievn here — we're keeping the typo, it's part of the lore 🫶)
• -version, -v — print version information and quit.
• -help, -h — print help and quit.

---

🧚 LOCAL ENCODING 🧚

idncmp guesses the local encoding from the locale and environment variables. for the deets, see the LOCAL ENCODING section in idn.conf(5) 💖

---

🌈 SEE ALSO 🌈

idncheck(1), idnconv2(1), iconv(3), idn.conf(5), idnalias.conf(5), idnlang.conf(5)

---

💀 BUGS 💀

the automatic input-code decision depends on your system, and sometimes it can't guess or guesses wrong. so yeah — it's way better to explicitly specify it using the -in option. no cap, just set it yourself 🙏

---

Sep 21, 2012 • idnkit 2.3 • General Commands Manual — and that's the whole page, bestie. go compare some domain names, you're gonna slay 💅✨🎀