SHAR(1)

📦 version 1.053, in alpine 3.24

🎀 SHAR(1) 🎀

okay bestie, this is the manual page for shar, one of the Perl user-contributed docs. yes it's giving "why is this in a Perl manpage" but we don't ask questions, we just vibe 💅

✨ NAME ✨

shar — literally create a shell archive of files 🦋

✨ SYNOPSIS ✨

shar file...

✨ DESCRIPTION ✨

so here's the tea 🔥 shar reads your input files and writes a shell archive out to standard output. that's the main character move right there.

and a shell archive? it's just a shell script, no cap. you run it, and boom — it recreates the files for you. it's giving "self-extracting zip but make it 1985" 💖

🫶 important vibe check on permissions: file permissions are not preserved for archived files. like, at all. extracted files get created with the default file permissions and owner. don't come for me, that's just how it is 😭

directories will get recreated, but here's the catch: directory arguments must be provided before the files they contain. order matters, bestie. dir first, then the stuff inside it, otherwise the whole thing falls apart 🙈

✨ SEE ALSO ✨

  • unshar — the reverse slay 👑 the thing that unpacks what shar packed

✨ AUTHOR ✨

Rich Salz — and yes, the whole contact card: salzr@certo.com | rsalz@osf.org | rsalz@bbn.com 💜

this code is released to the public domain. free as a butterfly, fr fr 🦋 no license drama, no fine print, we love to see it ✨

🎀 and that's the page! logging off with the very official sign-off details: this is perl v5.42.2, dated 2026-02-15. bye bestie, go archive something iconic 💖🌸

📦 where this page comes from