TTRMDIR(1)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💅 ttrmdir — the ToolTalk girlie's rmdir

okay so bestie, welcome to ttrmdir, a user cmd page, and honestly? she's giving cleanup crew with main character energy ✨

✨ NAME ✨

ttrmdir — remove empty directories and inform the ToolTalk service about it 🎀 (yes, both. she does the most. she's iconic like that.)

🌸 SYNOPSIS 🌸

ttrmdir [-L]  [directory]  [...]

ttrmdir [-h]  [-v]

🦋 DESCRIPTION 🦋

So what does ttrmdir actually do? She invokes rmdir(1) to remove empty directories, and then she informs ToolTalk about her actions — so that the ToolTalk objects associated with the deleted directories can also be deleted. it's giving "clean up your room AND tell your mom you did it" 🫶

the way she works: ttrmdir removes the ToolTalk objects before it removes the directories. and no cap — she does not check whether a directory is empty, and she does not check whether the directory-removing operation will succeed before she performs the object-removing operation. she just goes. periodt 💀

bestie please note: no pre-flight check. objects gone first, questions later. be so for real about that before you run her 🙈

💜 OPTIONS 💜

the following options are available:

  • -h — write a help message for invoking ttrmdir, then exit. your lil "what does she do again?" button 🎀
  • -L — remove the ToolTalk objects of the directories, but do not invoke rmdir(1) to remove the actual directories. objects only, dirs stay. lowkey selective 💅
  • -v — write the version number of ttrmdir, then exit. she'll tell you how old she is 🌸

and fyi: the -p option to cp(1) is not supported. not her thing. don't ask ✋

⭐ OPERANDS ⭐

the following operand is supported:

  • directory — a pathname of an empty directory to be removed 🗂️

🧚 STDIN 🧚

not used. she doesn't need your input, she's got this 💅

🌈 INPUT FILES 🌈

the input files specified as operands can be of any file type. no gatekeeping here 🫶

🍓 ENVIRONMENT VARIABLES 🍓

the following environment variables affect the execution of ttrmdir:

  • LANG — provide a default value for the internationalization variables that are unset or null. If LANG is unset or null, the corresponding value from the implementation-specific default locale will be used. If any of the internationalization variables contains an invalid setting, the utility behaves as if none of the variables had been defined. (she's flexible like that ✨)
  • LC_ALL — if set to a non-empty string value, override the values of all the other internationalization variables. she said my rules now 👑
  • LC_MESSAGES — determine the locale that is used to affect the format and contents of diagnostic messages written to standard error and informative messages written to standard output. basically: what language her lil messages come in 💬
  • NLSPATH — determine the location of message catalogues for the processing of LC_MESSAGES. where she finds the message shelf 🗄️

🔥 RESOURCES 🔥

none. she travels light 🎀

💀 ASYNCHRONOUS EVENTS 💀

the ttrmdir utility takes the standard action for all signals. no drama, standard behavior, she's unbothered 💅

💖 STDOUT 💖

  • when the -h option is used, ttrmdir writes to standard output a help message in an unspecified format. (format? a mystery. a vibe. iykyk 🤫)
  • when the -v option is used, ttrmdir writes to standard output a version number in an unspecified format. (again: unspecified. she keeps it mysterious ✨)

🎀 STDERR 🎀

used only for diagnostic messages. that's where the "bestie something went wrong" lives 😭

🦋 OUTPUT FILES 🦋

none. she leaves no crumbs 💅

🌸 EXTENDED DESCRIPTION 🌸

none. nothing extra, she said keep it cute and simple 🫶

⭐ EXIT STATUS ⭐

the following exit values are returned:

  • 0 — all directories and ToolTalk objects were removed successfully. slay!! 👑
  • >0 — an error occurred, or the invoked rmdir(1) command exited with a non-zero value. it's giving "not her day" 💀

🙈 CONSEQUENCES OF ERRORS 🙈

default. (no special lore here, bestie 🧚)

🗂️ FILES 🗂️

  • /mountpoint/TT_DB — the directory used as a database for the ToolTalk objects of files in the file system mounted at /mountpoint. that's her little filing cabinet, per mountpoint 📁

💜 APPLICATION USAGE 💜

the definition of an empty directory is one that contains, at most, directory entries for dot and dot-dot. so like… . and .. and literally nothing else. no secret stashes 🕵️‍♀️

🌈 EXAMPLES 🌈

none. (yes really, none. she's too cool for examples 😌)

✨ SEE ALSO ✨

rmdir(1), ttrm(1), ttsession(1). go read those too, bestie, they're the supporting cast 🫶

ngl the whole "removes ToolTalk objects before removing the directory and never checks anything first" thing is the one to remember. she's confident, not careful 💅

okay that's the whole page!! mwah 💖 this was ttrmdir(user cmd) — user cmd, source/version and date baked right into this sign-off just for you, and she ate. periodt 👑🎀

📦 where this page comes from