ICEAUTH(1)

🌸 NAME 🌸

okay bestie, welcome to the iceauth manual page — section 1, X Version 11 edition 💅. This is the ICE authority file utility, and it's literally here to help you edit and display the authorization info used when connecting with ICE (the X11 Inter-Client Exchange protocol).

✨ SYNOPSIS ✨

iceauth [-f authfile] [-vqibuV] [command arg ...]

🌈 DESCRIPTION 🌈

So iceauth edits and displays the authorization information used in connecting with ICE (the X11 Inter-Client Exchange protocol). The classic use case? Extracting authorization records from one machine and merging them in on another — like when you're doing remote logins or granting access to other users. Commands (all described below) may be entered interactively, on the iceauth command line, or in scripts. Periodt 💖

🎀 OPTIONS 🎀

• -f authfile — Name of the authority file to use. It defaults to the file currently in use by the session ✨
• -v — Turns on extra messages (verbose mode) 💬
• -q — Turns off extra messages (quiet mode) 🤫
• -i — Ignore the locks on the authority file 🔓
• -b — Break the locks on the authority file 💥
• -u — Print basic usage instructions 📝
• --help — Print basic usage instructions 📝
• -V — Print version and exit 👋
• --version — Print version and exit 👋

🦋 USAGE 🦋

When iceauth is run it will allow the following set of commands to be entered interactively or in scripts.

bestie, real talk: remember that arguments given on the shell command line will be displayed in shell histories and may be visible to other users via tools such as ps(1), thus exposing the value of any cookies or other authentication secrets provided on the shell command line. 👀

• ? — List available commands.
• help — Print help information. You may supply a command name to help to get specific information about it.
• info — Print information about the entries in the authority file.
• list [protocol_name] [protocol_data] [netid] [authname] — List (print) entries in the authority file. You may specify optional modifiers to specify which entries are listed.
• add protocol_name protocol_data netid authname authdata — Add an entry to the authority file.
• remove [protocol_name] [protocol_data] [netid] [authname] — Remove entries from the authority file.
• extract filename [protocol_name] [protocol_data] [netid] [authname] — Extract entries from the authority file in to a destination file. You must supply the path to the destination file. Optional specifiers allow you to narrow which entries are extracted.
• merge filename1 [filename2 [filename3]]... — Merge entries from other files in to the authority file selected by the program. You may supply any number of file paths to this command.
• exit — Save changes and exit the program.
• quit — Abort changes and exit the program without saving.
• source filename — Read and execute commands from a file.

👑 AUTHOR 👑

Ralph Mor, X Consortium — absolute icon behavior 👑

---

okay that's the whole page, bestie — from the iceauth source, version 1.0.11, dated 2025-04-26, signing off 🫶💖✨