FILE2SM(1)

💖 FILE2SM(1) 💖

okay bestie, welcome to the ICI executables corner of the manual, where we talk about file2sm. she's a whole vibe. let's get into it 🫶

---

✨ NAME ✨

file2sm — the shared-memory linked list data ingestion test program. yes, she's a stress tester, she's doing the most, and honestly? iconic. 👑

---

🎀 SYNOPSIS 🎀

file2sm fileName

---

🦋 DESCRIPTION 🦋

so what is file2sm actually doing? bestie. she stress-tests shared-memory linked list data ingestion by repeatedly writing all the text lines of the file named fileName to a shared-memory linked list. that linked list is the root object of a PSM partition named "file2sm". lowkey a whole lot of responsibility for one little program but she ate 💅

and after writing each line to the linked list, file2sm gives a semaphore to indicate that the list is now non-empty. this is mainly for the benefit of the complementary test program sm2file(1) — like, she's leaving the light on for her bestie fr fr 🌸

the operation of file2sm is cyclical. after copying all the text lines of the source file to the linked list, she appends an EOF line to the linked list, containing the text "*** End of the file ***", and then prints a brief performance report:

Processing I<lineCount> lines per second.

and then? she reopens the source file and starts appending the file's text lines to the linked list again. over and over. no cap. that's the cycle, that's her whole thing ✨

---

⭐ EXIT STATUS ⭐

• "0" — file2sm has terminated.

---

🍓 FILES 🍓

no configuration files are needed. none. zero. she's low maintenance 💖

---

🌈 ENVIRONMENT 🌈

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

---

💀 DIAGNOSTICS 💀

here's where she tells you what went wrong. read carefully bestie, these are real:

• Can't attach to shared memory operating system error. check errtext, correct problem, and rerun.
• Can't manage shared memory. PSM error. check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.
• Can't create shared memory list. smlist error. check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.
• Can't create semaphore. ION system error. check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.
• Can't open input file operating system error. check errtext, correct problem, and rerun.
• Can't reopen input file operating system error. check errtext, correct problem, and rerun.
• Can't read from input file operating system error. check errtext, correct problem, and rerun.
• Ran out of memory. nominal behavior. sm2file is not extracting data from the linked list quickly enough to prevent it from growing to consume all memory allocated to the test partition.

not me reading "Ran out of memory" and finding out it's nominal behavior 😭 the list just kept growing because sm2file wasn't keeping up. it's giving "this is fine" 🔥

---

🙈 BUGS 🙈

found a bug? report bugs to <ion-bugs@korgano.eecs.ohiou.edu> 💜

---

👑 SEE ALSO 👑

sm2file(1), smlist(3), psm(3)

---

and that's the whole page bestie, you're so welcome 🎀 this was written by perl v5.24.1 on 2016-07-07, for FILE2SM(1) — mwah, go forth and stress-test responsibly 💖✨