garchive(1)

πŸ“¦ version 1.10.2, in nixos 26.05

πŸ’… garchive β€” like, the manual page, bestie ✨

okay so before we even start: this is garchive(1) from the gEDA crew, version 1.10.2.20201216, and it's genuinely one of those tiny tools that just does the thing. no drama, no bloat, just vibes and tarballs πŸŽ€


✨ NAME ✨

garchive β€” create and extract gEDA design archives πŸ—‚οΈ

🌸 SYNOPSIS 🌸

garchive [options] [-o output_file] file ...

πŸ’– DESCRIPTION πŸ’–

so garchive is your little archive bestie for gEDA designs β€” it either makes an archive or opens one. two modes, that's the whole personality:

  • archive mode β€” this is where it builds a project archive out of a whole bunch of your project files 🫢
  • extract mode β€” this is where it pulls the files back out of the archive and drops them straight into the local dir ✨

and like, the default? archive mode. that's the main character energy πŸŽ€

πŸ”₯ OPTIONS πŸ”₯

  • -f filename β€” optional, and it only works in archive mode. it reads the list of files to archive from filename instead of from garchiverc. slay, custom file list πŸ’…
  • -v β€” verbose mode. it will literally tell you what it's doing, no cap πŸ—£οΈ
  • -e β€” extract the archive that you specified on the command line. unpacking szn πŸ¦‹
  • -a β€” create an archive. this is the default, so like… you didn't even have to ask πŸ‘‘
  • -o outfile β€” optional, archive-mode only. names the output archive file. the output file extension should be .tar.gz. if you don't pass this flag, the output file name is just ProjectArchive.tar.gz. fyi πŸ“
  • -h, --help β€” prints usage info. the "help me help you" button πŸ™ˆ

🌈 EXAMPLES 🌈

making an archive called MyArchive.tar.gz (with the files to store listed in garchiverc, iykyk):

garchive -o MyArchive.tar.gz

verbosely creating an archive β€” this one archives the files listed on the cmd line as well as the ones in garchiverc, which is a whole serve:

garchive -v -o MyArchive.tar.gz README Schematic1.sch
Schematic2.sch Schematic3.sch

extracting an archive, the classic:

garchive -e ProjectArchive.tar.gz

🧚 AUTHOR 🧚

Stuart Brorson <sdb@cloud9.net> β€” ty for your service πŸ«‘πŸ’œ

⭐ SEE ALSO ⭐

gschem(1) β€” go check it out bestie, it's the other half of the vibe 🌸

Copyright Β© 1999-2020 gEDA Contributors. License GPLv2+: GNU GPL version 2 or later. please see the COPYING file included with this program for full details πŸ“œ

this is free software: you are free to change and redistribute it. and like, there is NO WARRANTY, to the extent permitted by law β€” say it louder for the people in the back, fr fr 😭


lowkey important reminder: -o output extension should be .tar.gz, and if you skip -o entirely you're getting ProjectArchive.tar.gz whether you planned for it or not πŸ’€βœ¨

and that's the whole page!! brought to you by the gEDA Project, dated December 16, 2020 β€” mwah, take care of your tarballs bestie πŸŽ€πŸ’–

πŸ“¦ where this page comes from