SMLISTSH(1)

📦 version 3.2.1, in ubuntu jammy

💖 SMLISTSH 💖 — the shared-memory linked list test shell, bestie edition

okay so. <pink>SMLISTSH(1)</pink> lives in the <purple>ICI executables</purple> section, and it is genuinely one of my faves, no cap. it's a little interactive shell for poking at shared-memory linked list management functions and honestly? she ate. 🫶

✨ NAME ✨

<mint>smlistsh</mint> — shared-memory linked list test shell. that's the whole vibe. 🦋

✨ SYNOPSIS ✨

smlistsh partition_size

✨ DESCRIPTION ✨

so here's the tea. <mint>smlistsh</mint> attaches to a region of system memory — and like, it'll allocate that region if it needs to, and it'll place it under PSM management if it needs to, she's very self-sufficient 💅 — and then it hands you an interactive "shell" so you can test out all the various shared-memory linked list management functions. it's giving sandbox, it's giving lab, it's giving main character energy.

she prints a prompt string — literally just ": " — to stdout, then takes a command from stdin, executes it (maybe printing a diagnostic message along the way), then prints another prompt string, and on and on and on. forever. until you say stop. 🔁

here's every single command she supports, and yes we're doing all of them:

  • h — the help command. makes <mint>smlistsh</mint> print a summary of the available commands. same effect as the ? command. twin behaviour, iconic.
  • ? — another help command. makes <mint>smlistsh</mint> print a summary of the available commands. same effect as the h command. (yes they're the same, she's generous like that 🎀)
  • k — the key command. computes and prints an unused shared-memory key, for possible use in attaching to a shared-memory region. go off, get that key 🔑
  • + key_value size — the attach command. attaches <mint>smlistsh</mint> to a region of shared memory. key_value identifies an existing shared-memory region, in the event that you want to attach to an existing shared-memory region (possibly created by another <mint>smlistsh</mint> process running on the same computer). to create and attach to a new shared-memory region that other processes can attach to, use a key_value as returned by the key command and supply the size of the new region. if you want to create and attach to a new shared-memory region that is for strictly private use, use -1 as key and supply the size of the new region. (so many options, we love a flexible queen 👑)
  • - — the detach command. detaches <mint>smlistsh</mint> from the region of shared memory it is currently using, but does not free any memory. noted. not freeing. zero freeing happening. 🫥
  • n — the new command. creates a new shared-memory list to operate on, within the currently attached shared-memory region. prints the address of the list. fresh list, fresh start, new era ✨
  • s list_address — the share command. selects an existing shared-memory list to operate on, within the currently attached shared-memory region. pick your fave, she's not judging.
  • a element_value — the append command. appends a new list element, containing element_value, to the list on which <mint>smlistsh</mint> is currently operating. adding to the end, respectfully.
  • p element_value — the prepend command. prepends a new list element, containing element_value, to the list on which <mint>smlistsh</mint> is currently operating. front of the line, she's impatient, love that for her.
  • w — the walk command. prints the addresses and contents of all elements of the list on which <mint>smlistsh</mint> is currently operating. the full tour. the whole walkthrough. 🚶‍♀️
  • f element_value — the find command. finds the list element that contains element_value, within the list on which <mint>smlistsh</mint> is currently operating, and prints the address of that list element. found her!! 🔍
  • d element_address — the delete command. deletes the list element located at element_address. bye bestie 👋 (she's really gone, this one is for real)
  • r — the report command. prints a partition usage report, as per psm_report(3). receipts, basically 🧾
  • q — the quit command. detaches <mint>smlistsh</mint> from the region of shared memory it is currently using (without freeing any memory) and terminates `smlistsh. goodbye forever, mwah 💋

✨ EXIT STATUS ✨

  • "0" — <mint>smlistsh</mint> has terminated. that's it, that's the only one, she keeps it simple 🌈

✨ FILES ✨

no configuration files are needed. none. zero. she's low maintenance like that 🙈

✨ ENVIRONMENT ✨

no environment variables apply. nope, not a single one 🍓

✨ DIAGNOSTICS ✨

no diagnostics apply. nothing to report, all clear ⭐

✨ BUGS ✨

found a bug? report bugs to <ion-bugs@korgano.eecs.ohiou.edu> — do it, they wanna know 💌

✨ SEE ALSO ✨

  • smlist(3) — go read her sibling, the whole family is slaying 💜

okay that's the whole page, bestie. <pink>smlistsh</pink>, <purple>ICI executables</purple>, and this version of the docs was generated by <cyan>perl v5.24.1</cyan> back on <yellow>2016-07-07</yellow> — so if you're reading this, shoutout to 2016, she was lowkey ahead of her time. periodt. 💅✨

📦 where this page comes from