smd-push(1)

πŸ“¦
version 1.3.0 Β· 2 versions
, in ubuntu jammy

πŸ’– smd-push β€” the smd-push(1) era πŸ’–

ok bestie, sit down, hydrate, and let me tell you about smd-push, a lil command from the Sync Mail Dir (smd) docs. it's giving "one-way street, and the street is the remote maildir." no cap.


✨ NAME ✨

smd-push β€” syncs the remote mail dir letting the local one untouched 🫢


🌸 SYNOPSIS 🌸

smd-push [-d|--dry-run] [-v|--verbose] [-s|--show-tags] [-t|--template-only]
         [-n|--no-delete] [endpoint]

look at her. all those flags. main character energy fr fr πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the vibe: smd-push performs in the remote maildir all the changes that were performed on the local one. the remote gets the glow-up. the local stays exactly as it is, unbothered, moisturized, in its lane. 😌

No changes are made on the local maildir. literally none. zero. if you wanted the local one to change too, that's a different command, bestie β€” use smd-pull(1) for that. πŸ”

and if you're like "okay but where do I even configure this," refer to smd-config(5) for the configuration file format. that's your blueprint, your mood board, your config file lore. πŸ““βœ¨


πŸ‘‘ OPTIONS πŸ‘‘

  • -v, --verbose β€” verbose output πŸ’¬ she talks a LOT. every little thing, narrated.
  • -s, --show-tags β€” machine readable output πŸ€– for when a script is reading over your shoulder and needs the receipts in a format it can actually parse.
  • -d, --dry-run β€” do not perform any action for real πŸ™ˆ a little rehearsal. a dress rehearsal. nothing actually happens, it's just the fantasy.
  • -n, --no-delete β€” do not propagate deletions πŸš«πŸ—‘οΈ deletions stay home. they do not travel. the remote keeps things you deleted locally, which is honestly very forgiving of it.
  • -t, --template-only β€” just create a template configuration file if none πŸŽ€ one job. creates the template config if there isn't one already, and that's it.
  • endpoint β€” is the suffix for the name of the configuration file to use. πŸ”— if it is omitted, the configuration file ~/.smd/config.default is used. so like, leave it out and she goes to the default. periodt.

πŸŽ€ FILES πŸŽ€

the sacred texts, the places where the magic lives:

  • ~/.smd/config.*
  • ~/.smd/hooks/pre-push.d/
  • ~/.smd/hooks/post-push.d/

hooks before AND after?? we love a command with a before-and-after routine. self-care. πŸŒΈπŸ§–


πŸ”₯ SEE ALSO πŸ”₯

go read these next, they're all in the same friend group:

mddiff(1), smd-server(1), smd-client(1), smd-pull(1), smd-loop(1), smd-config(5)

iykyk. one of them is literally the reverse of this one, go find her. πŸ‘€


πŸ’œ AUTHOR πŸ’œ

Enrico Tassi <gares@fettunta.org> β€” the icon, the legend, the one who wrote all this down for us. 🫢


⚠️ reminder bestie: this pushes TO the remote and leaves your local maildir completely untouched. if you were hoping for a two-way situation, that's not this. check the SEE ALSO section, there's a pull command with your name on it. πŸ’Œ

and that's the whole page, bestie!! ✨ this was the smd-push(1) page from the Sync Mail Dir (smd) docs, dated 21 April 2021 β€” go forth and sync responsibly, mwah πŸ’‹πŸ’…πŸ¦‹

πŸ“¦ where this page comes from