NSPARK(1)

💖 NSPARK 💖

okay bestie, welcome to nspark — the manual page for unpacking Archimedes archives, living in the General Commands Manual section. it's giving "niche but iconic", fr fr. let's get into it ✨

✨ NAME ✨

nspark — unpack Archimedes archives 🦋

🌸 SYNOPSIS 🌸

nspark [ options ] archive [ file ... ]

🎀 DESCRIPTION 🎀

so basically, nspark can unpack the specified Archimedes-format archive, list its contents, or test its integrity. that's the whole vibe check right there 💅

Nspark's main features are, and I'm obsessed:

• it supports all archive methods used by !Spark 1 and 2. the old version didn't support "Squashing" and used to handle "Compressed" archives by using the UNIX uncompress program. the new version supports both of these and has them built-in, which makes porting to other OS's way easier. no cap.
• it supports ArcFS format archives 🔥
• it supports Cyclic Redundancy Checking (CRC). the integrity of an archive can now be checked without having to unarchive it. the way that just works 😌
• it supports the verbose option to allow archive file details to be displayed (time/date or exec/load address, size, type). all the deets, all the tea ☕
• it supports selective file unarchiving, so the whole archive needn't be unarchived if not all the files are wanted. we love a choose-your-own-adventure ✨
• it supports user-prompting before overwriting a file, allowing the user to either (1) overwrite the file, (2) overwrite all the files, (3) unarchive the file to a different name, or (4) not to unarchive the file at all. four whole options, she ate 🍽️
• it supports file-stamping so the date and time of the file, when unarchived, matches the date and time it was archived (not 4.2BSD or SysV.2 as these systems lack vital library functions). periodt.

ok so real talk — the author says: "I have not included support for creating !Spark archives, and I am not really sure if I need to as: (1) !Spark for RISC OS is cheap (#5.99 from David Pilling), (2) !SparkPlug can unpack archives created with zip (which is available in source form for UNIX, VMS and MSDOS), and (3) it's a lot of work. Let me know what you think."

honestly? valid reasoning. iconic honesty 💀

Options:

• -x — Extract the given file, or all files if none are specified.
• -u — Equivalent to -x.
• -t — Test archive integrity by simulating extraction and checking the CRCs (Cyclic Redundancy Checks).
• -l — List archive contents.
• -q — Quiet. Displays less information when listing, testing or extracting.
• -f — Force file overwrite if a file already exists with the same name as the one being extracted. If not using -f then you are prompted whether you want to overwrite the original, skip this file, give it a different name, or overwrite this and all others that already exist.
• -s — No filestamp. Does not set the timestamp when extracting files.
• -v — Verbose. Gives full details when listing or extracting archives.
• -p<pass> — Password. Specifies the password used to garble the archive.
• -R — Retry if archive is corrupt. If a bad header is found then nspark will search the archive until another header if found, rather than giving up. 💪
• -L<name> — Set name of log file to name.
• -T — Append file type to name, in the same way as Tar or NFS. For example Text files (filetype &FFF) have ,fff appended when extracted.
• -C — Create lowercase filenames. Useful on machines where the case of filenames is significant (eg. UNIX), this option forces all extracted filenames to be lowercase.
• -V — Display version number.

💀 BUGS 💀

the DOS version does not time/date stamp directories. that's it, that's the bug, we don't make the rules 🙈

🦋 NOTES 🦋

Nspark is in the public domain. it is currently being maintained by James Woodcock (james_woodcock@yahoo.co.uk). 🫶

🌈 SEE ALSO 🌈

arcfs(5), spark(5).

👑 AUTHOR 👑

Andy Duplain, BT Customer Systems, Brighton, UK. (duplain@btcs.bt.co.uk)

🧚 CONTRIBUTORS 🧚

• Improvements from version 1.5, including ArcFS support, by Andrew Brooks (arb@compl.ancs.ac.uk).
• Manual pages originally supplied by Duncan (m91dps@ecs.oxford.ac.uk).
• Suggestions for improvement by Tom Tromey (tromey@busco.lanl.gov).
• Windows NT support by Alun Jones (auj@aber.ac.uk).
• Previously maintained by arb (arb@comp.lancs.ac.uk).

and that's the whole page, bestie 💖 this came from the USER COMMANDS source, version dated 2021-03-05 — so if you're reading this, hi from that exact moment in time, hope ur terminal's cute and ur archives are intact. slay, stay unzipped, mwah 🎀✨