SUP-IMPORT-DUMP(1)

πŸ’– SUP-IMPORT-DUMP(1) πŸ’–

okay bestie, so this is the manual page for sup-import-dump, a lil tool from the Sup mail indexer crew. it's giving "restore my vibes" energy. let's get into it 🫢


✨ NAME ✨

sup-import-dump β€” import message state dump to Sup index 🌸


✨ SYNOPSIS ✨

sup-import-dump [options] dumpfile

✨ DESCRIPTION ✨

so basically, this little icon takes message state that was previously exported by sup-dump and imports it right back into the index. no cap πŸ’…

important tea: sup-import-dump operates on the index ONLY. that means the messages must have already been added using sup-sync. like, it will not do that part for you, bestie.

if you need to recreate the index from scratch, you don't want this one β€” go see sup-sync --restore instead. different tool, different vibe ✨

and here's the chill part: messages that are not mentioned in the dump file will not be modified. untouched. left alone. main character behavior, honestly πŸ’œ


✨ OPTIONS ✨

  • -v, --verbose β€” prints message ids as they're processed. so you can watch the whole thing happen in real time, like a livestream but for your index πŸŽ€
  • -i, --ignore-missing β€” silently skips over messages that are not in the index. no drama, no commentary, just moving on πŸ™ˆ
  • -w, --warn-missing β€” warns you about messages that are not in the index, but keeps going anyway. it's giving "noted, moving on" πŸ¦‹
  • -a, --abort-missing β€” aborts on encountering messages that are not in the index. this one is the default, so if you don't pick anything, this is what you get. strict queen energy πŸ‘‘
  • -t, --atomic β€” uses a transaction to apply all changes atomically. all or nothing, no half-finished situationships πŸ”₯
  • -n, --dry-run β€” doesn't actually modify the index. probably only useful with --verbose. it's a rehearsal, not the performance πŸ’…
  • --version β€” shows version information ⭐
  • -h, --help β€” shows the help message 🌈

✨ SEE ALSO ✨

sup(1), sup-sync(1), sup-dump(1) β€” the whole friend group, go say hi πŸ’–


✨ REPORTING BUGS ✨

you are welcome to submit bug reports to the Sup issue tracker, located at:

<https://github.com/sup-heliotrope/sup/issues>

fr fr, if something's broken, tell them, they wanna know 😭


✨ CONTACT INFORMATION ✨


Copyright Β© 2006-2009 William Morgan <mworgan-sup@masanjin.net> πŸ’–

Copyright @ 2013-2014 Sup developers πŸ’–

Permission is granted to copy and distribute this manual under the terms of the GNU General Public License; either version 2 or (at your option) any later version. πŸ“œ


✨ AUTHORS ✨

Sup was originally written by William Morgan <wmorgan-sup@masanjin.net> and is now developed and maintained by the Sup developers. πŸ‘‘ iconic lineage honestly


and that's the whole page bestie!! πŸŽ€ this was the Sup User Manual, dated April 9, 2012, living under the name SUP-IMPORT-DUMP(1) β€” go forth and import those dumps, you've totally got this πŸ’–βœ¨πŸ¦‹