IPROP-LOG(8)

💖 IPROP-LOG 💖

okay bestie, gather round, because we're about to get intimately acquainted with the iprop log file 🦋 this little darling is the iprop-log command, living its best life in section 8 of the System Manager's Manual, and its whole job is to examine and maintain the iprop log file. yes. that's it. that's the gig. and it slays at it ✨

---

🌸 SYNOPSIS 🌸

the way you actually call this thing, verbatim, no edits:

iprop-log [--version] [-h | --help] command

iprop-log truncate [-c file | --config-file=file] [-r string |
          --realm=string] [-K integer | --keep-entries=integer] [-B
          integer | --max-bytes=integer] [-R | --reset] [-h | --help]
          [log-file]

iprop-log dump [-c file | --config-file=file] [-r string |
          --realm=string] [-n | --no-lock] [-R | --reverse]
          [-h | --help] [log-file]

iprop-log replay [--start-version=version-number]
          [--end-version=version-number] [-c file | --config-file=file]
          [-r string | --realm=string] [-h | --help] [log-file]

iprop-log last-version [-c file | --config-file=file] [-r string |
          --realm=string] [-n | --no-lock] [-h | --help] [log-files]

iprop-log signal [-c file | --config-file=file] [-r string |
          --realm=string] [-h | --help]

---

✨ DESCRIPTION ✨

so like, the options that are supported across the board, the universal ones, the main characters 💅

• --version — shows you the version. iconic of it, honestly.
• -h, --help — help. your emotional support flag 🫶

and then command can be one of the following, and each one comes with its own little entourage of flags. let's go 👑

---

🎀 truncate

the ✨spring cleaning✨ command. flags first:

• -c file, --config-file=file — configuration file
• -r string, --realm=string — realm
• -K integer, --keep-entries=integer
• -B integer, --max-bytes=integer
• -R, --reset

okay so here's the tea on how this works 🍓

if --reset is given, then the given, configured, or default log file will be truncated and will start at version 1. lowkey dramatic, highkey necessary, because this forces full propagations to all slave KDCs. everyone's getting the whole thing again. no cap. 💀

otherwise? the log gets truncated too, but some entries get preserved — as specified by the --keep-entries and/or --max-bytes options. the largest number of --keep-entries entries that are available and fit in the given --max-bytes option will be used. and now, the part you have to read exactly, bestie, because I am not about to paraphrase it:

The --keep-entries -option -defaults -to -100, -and -the --max-bytes option defaults to the log-max-size parameter in the configuration.

yes. that. exactly that. I typed it with my own two hands and every hyphen is intentional 🙈

---

🦋 dump

the "show me everything" command. flags:

• -c file, --config-file=file — configuration file
• -r string, --realm=string — realm
• -n string, --no-lock
• -R string, --reverse

what it does: prints out all entries in the given, configured, or default log file to standard output. that's it, that's the vibe.

if the -n option is used then don't lock the iprop log file 🔓

if the -R option is used, then print the entries in reverse order — which is genuinely so useful when the log is very large, because scrolling to the bottom of a giant file is not the energy we're bringing today 😭

---

🌈 replay

replay. the rewind-and-redo of it all. flags:

• --start-version=version-number — start replay with this version
• --end-version=version-number — end replay with this version
• -c file, --config-file=file — configuration file
• -r string, --realm=string — realm

what it does: replay the changes from specified entries (or all if none is specified) in the given, configured, or default transaction log file to the database. it's giving time travel but make it database 💜

---

⭐ last-version

flags, bestie:

• -c file, --config-file=file — configuration file
• -r string, --realm=string — realm
• -n string, --no-lock

and what it does: prints the version of the last record in each of the given log files, or the configured, or the default log file if none is given. note the plural — log-files — she can handle many files at once. multitasking queen 👑

---

🧚 signal

flags:

• -c file, --config-file=file — configuration file
• -r string, --realm=string — realm

what it does: signals the ipropd-master daemon to send updates to slaves 📡

and here's the cute little note: normally kadmin does this every time it writes to the database, so this should rarely be needed. it's the emergency-contact flag. you probably won't text it. but it's in your phone just in case 🫶

---

🔥 SEE ALSO 🔥

• iprop(8)

---

okay that's the whole page, you ate that, I'm obsessed 💅✨

and for the record — this gem came out of the Debian crew, dated February 18, 2007 🌸 so yeah, she's been iconic for a minute. periodt. 💖