psiclean(1)

✨ NAME ✨

psiclean — the little cleanup bestie that deletes your files out of the PSI temporary directories 🧹💖

---

💅 DESCRIPTION 💅

okay so here's the tea: the psiclean command finds a job name by scanning the input file for a keyword assignment that looks exactly like this:

DEFAULT:FILES:DEFAULT:NAME = string

then it goes through all of the machine's temporary directories and deletes every file of the form string.*. bye bye 👋✨

in previous versions of psiclean, the temporary directories were just assumed to look like this:

/tmp[0-9]/$user

but in this version of psiclean, we get the names of the temporary directories straight from the user input file, by looking for volume paths shaped like:

DEFAULT:FILES:DEFAULT:VOLUMEi = string

It is essential that users see to the removal of their scratch files as soon as their job completes, because temporary directories are usually a shared resource and there is not necessarily an automatic way for files to be deleted from these areas. so like, the last command you run after a job has finished should be the psiclean command. periodt. 👑

the user must take care to follow certain conventions when choosing filenames:

• any files which are to be kept after a job completes should not be kept in the default temporary directories.
• the FILES input must be used to specify other locations for the specific files which are to be kept.
• psiclean will ignore files which are specifically listed by number (e.g., PSIF_CHKPT) in the FILES section.
• files which are not needed after the run should use the default path given in the input file. otherwise, these files will remain on the system and will impede other jobs 😭

no cap, if you don't do this your leftovers just sit there being a whole problem for everybody else's jobs. main character energy is cleaning up after yourself. 🫶

---

🌈 EXAMPLE 🌈

let's say the PSI temporary directories contained these subdirectories and files:

/tmp1/cpuhog:
-rw-r--r--  1 cpuhog      14492 Jun 11 16:48 dicubane.30
-rw-r--r--  1 cpuhog     187320 Jun  8 17:20 diketene.34
-rw-r--r--  1 cpuhog      16384 Jun  7 19:17 o4big.30
-rw-r--r--  1 cpuhog      16384 Jun  7 19:17 o4.30
-rw-r--r--  1 cpuhog     974848 Jun  7 18:41 o4.34

/tmp2/cpuhog:
-rw-r--r--  1 cpuhog      14492 Jun 11 16:48 dicubane.30
-rw-r--r--  1 cpuhog     187320 Jun  8 17:20 diketene.34
-rw-r--r--  1 cpuhog      10904 Jun  7 18:50 o4big.30
-rw-r--r--  1 cpuhog      10904 Jun  7 18:50 o4.30
-rw-r--r--  1 cpuhog     973752 Jun  7 18:41 o4.34

/tmp3/cpuhog:
-rw-r--r--  1 cpuhog      14492 Jun 11 16:48 dicubane.30
-rw-r--r--  1 cpuhog     187320 Jun  8 17:20 diketene.34
-rw-r--r--  1 cpuhog       8192 Jun  7 19:17 o4big.30
-rw-r--r--  1 cpuhog       8192 Jun  7 19:17 o4.30
-rw-r--r--  1 cpuhog     966656 Jun  7 18:41 o4.34

and let's also say that the user cpuhog is in a directory which contains an input file that has this line in it:

DEFAULT:FILES:DEFAULT:NAME = "o4"

if the user cpuhog now executes the psiclean command, then the o4 files in the temporary directories would be deleted 🗑️✨ leaving the following files:

/tmp1/cpuhog:
-rw-r--r--  1 cpuhog      14492 Jun 11 16:48 dicubane.30
-rw-r--r--  1 cpuhog     187320 Jun  8 17:20 diketene.34
-rw-r--r--  1 cpuhog      16384 Jun  7 19:17 o4big.30

/tmp2/cpuhog:
-rw-r--r--  1 cpuhog      14492 Jun 11 16:48 dicubane.30
-rw-r--r--  1 cpuhog     187320 Jun  8 17:20 diketene.34
-rw-r--r--  1 cpuhog      10904 Jun  7 18:50 o4big.30

/tmp3/cpuhog:
-rw-r--r--  1 cpuhog      14492 Jun 11 16:48 dicubane.30
-rw-r--r--  1 cpuhog     187320 Jun  8 17:20 diketene.34
-rw-r--r--  1 cpuhog       8192 Jun  7 19:17 o4big.30

see how the o4.30 and o4.34 files got ate but o4big.30 survived? that's the whole vibe. 💅 the DEFAULT:FILES:DEFAULT:NAME = "o4" said the job name is o4, so everything matching o4.* got yeeted, and o4big.30 is a completely different string so it stays. iykyk 🦋

---

👑 AUTHOR 👑

C. David Sherrill <sherrill@alum.mit.edu>

---

and that's the whole page bestie!! this one's from Psi Version 3.0, dated 29 July, 1999 — so like, vintage, but make it iconic 🌸✨ go clean up your scratch files fr fr 🎀