STUNAR(1)

🎀 STUNAR(1) — the suntar page 🎀

💖 NAME 💖

suntar — create tape archives and add or extract files. This is the STUNAR(1) manual page, bestie, and it's giving classic Unix with a Sun tar emulation twist. 💅

📜 SYNOPSIS 📜

suntar  command [ options ] file1 ... filen

✨ DESCRIPTION ✨

Okay so this manual page documents an emulation of the Sun version of tar. It has been implemented on top of the star program. 🦋

For a description of the Sun tar program, check the Sun tar manual page. iykyk.

🎀 OPTIONS 🎀

star supports the Sun tar options. Periodt. 💖

🔥 EXTENDED OPTIONS 🔥

The extended options are options taken from star, and they are lowkey iconic:

• --help — prints a summary of the most important options for suntar(1) and exits.
• --xhelp — prints a summary of the less important options for suntar(1) and exits.
• --version — prints the suntar version number string and exists. (yes, that's the exact word from the page 💀)
• --debug — print additional debug messages.
• xdebug=# — set extended debug level.
• xd=# — set extended debug level.
• artype=headertype — generate a tape archive in headertype format. For more information, see star(1).
• -/ — don't strip leading '/'s from file names.
• --.. — don't skip filenames that contain '..' in non-interactive extract.
• --7z — run the input or output through a p7zip pipe — see option -z below.

Note that the p7zip program currently does not operate on a pipe but on a /tmp file copy and thus limits the maximum archive size. important little caveat, bestie 🫶

• --secure-links — don't extract links that start with '/' or contain '..'.
• --no-secure-links — extract links that start with '/' or contain '..'.
• --acl — handle access control lists.
• --xfflags — handle extended file flags.
• bs=# — set (output) block size to #.
• fs=# — set fifo size to #.
• --no-fsync — do not call fsync() for each extracted file (may be dangerous). danger warning, no cap — this one can bite 💀
• --do-fsync — call fsync() for each extracted file.
• --time — print timing info.
• --no-statistics — do not print statistics.
• --do-statistics — rint statistics. (that's the exact spelling from the page, bestie 🙈)
• --fifostats — print fifo statistics.
• --no-fifo — don't use a fifo to optimize data flow from/to tape.
• --numeric — don't use user/group name from tape.
• --lzo — pipe input/output through lzop, does not work on tapes.
• --lzip — pipe input/output through lzip, does not work on tapes.
• -z — pipe input/output through gzip, does not work on tapes.
• --bz — pipe input/output through bzip2, does not work on tapes.
• --zstd — pipe input/output through zstd, does not work on tapes.

The options above are not defined by Sun tar. iconic crossover behavior ✨

For a complete documentation of the star based options, check star(1). 💜

🌸 EXAMPLES 🌸

crickets — this section is empty in the original. 🫥

🌈 ENVIRONMENT 🌈

crickets again — nothing listed in the original here. 🦋

🍓 FILES 🍓

Still nothing in the original. mysterious main character energy 🎀

👑 SEE ALSO 👑

spax(1), suntar(1), scpio(1), tar(1), cpio(1), pax(1), rcp(1), mt(1), rmt(1), match(1), dd(1), sdd(1), rsh(1), ssh(1), star(1), star(4), rcmd(3), fssnap(1m)

💀 DIAGNOSTICS 💀

No diagnostics listed in the original, bestie. we love a quiet queen 💅

📝 NOTES 📝

This suntar implementation is based on the star implementation and does not implement all features of the original Sun tar program. not me being a little emulation with limits 💖

Suntar -x is equivalent to star -xU -force-remove -remove-first -keep-nonempty-dirs.

🙈 BUGS 🙈

No bugs listed in the original page. allegedly flawless, iykyk 🌈

🫶 AUTHOR 🫶

Joerg Schilling Seestr. 110 D-13353 Berlin Germany

Mail bugs and suggestions to:

joerg.schilling@fokus.fraunhofer.de or joerg@schily.net

---

💖 cute little sign-off: Joerg Schilling, 2019/01/05, STUNAR(1) — bestie, that's the footer, and this page ate. periodt. 💖