CH-TAR2DIR(1)

💖 CH-TAR2DIR(1) 💖

okay bestie, so this is a Charliecloud manual page, and I need you to sit with me for a sec because this one is giving legacy era. 🎀

---

✨ NAME ✨

ch-tar2dir — unpack an image tarball into a directory 🫶

---

✨ SYNOPSIS ✨

$ ch-tar2dir TARBALL DIR

---

✨ DESCRIPTION ✨

WARNING: bestie. This script is deprecated in favor of ch-convert. It will be removed in the next release. not me warning you about your fav function's imminent departure 😭

okay so what does it actually do tho? it extracts the tarball TARBALL into a subdirectory of DIR. 🌸

TARBALL must contain a Linux filesystem image — like, the kind of thing created by ch-builder2tar — and it has to be compressed with gzip or xz. and listen, if TARBALL has no extension, it will try appending .tar.gz and .tar.xz. slay, it guesses. ✨

Inside DIR, a subdirectory gets created whose name corresponds to the name of the tarball with .tar.gz or other suffix removed. so like, the vibes get a name. 🦋

now here's the part you gotta know: if such a directory already exists and appears to be a Charliecloud container image, it is removed and replaced. 💀 if the existing directory doesn't appear to be a container image, the script aborts with an error. so it's checking your vibes before it deletes anything, and if the vibes are off it simply leaves. periodt.

Additional arguments: 👑

• --help — print help and exit
• --version — print version and exit

WARNING: placing DIR on a shared file system can cause significant metadata load on the file system servers. 😭 this can result in poor performance for you and all your colleagues who use the same file system. please consult your site admin for a suitable location. like. pls don't do that to your coworkers, bestie. 🙈

---

✨ EXAMPLE ✨

look at this little demonstration, it's giving tutorial:

$ ls -lh /var/tmp
total 57M
-rw-r-----  1 reidpr reidpr  57M Feb 13 16:14 hello.tar.gz
$ ch-tar2dir /var/tmp/hello.tar.gz /var/tmp
creating new image /var/tmp/hello
/var/tmp/hello unpacked ok
$ ls -lh /var/tmp
total 57M
drwxr-x--- 22 reidpr reidpr 4.0K Feb 13 16:29 hello
-rw-r-----  1 reidpr reidpr  57M Feb 13 16:14 hello.tar.gz

ate. 🔥 unpacked ok, fr fr.

---

✨ REPORTING BUGS ✨

if Charliecloud was obtained from your Linux distribution, use your distribution's bug reporting procedures. 💅

otherwise, report bugs to: https://github.com/hpc/charliecloud/issues 🐛

---

✨ SEE ALSO ✨

• charliecloud(7)

full documentation at: <https://hpc.github.io/charliecloud> 🌈

---

✨ COPYRIGHT ✨

2014–2021, Triad National Security, LLC

---

okay that's the whole page, bestie, and honestly? you understood all of it. 👑💜

this was version 0.26, dated 2022-01-30 10:06 UTC, from the CH-TAR2DIR(1) page — thanks for reading with me, ily, go unpack something responsibly 🎀✨🦋