CDIST-TYPE__RSYNC(7)

📦
version 7.0.0 · 8 versions
, in fedora 43, fedora 44

💅 CDIST-TYPE__RSYNC(7) — cdist's lil rsync mirror type ✨

okay bestie, welcome to cdist-type__rsync, a page straight out of the cdist manual. this one's short and sweet, so let's go 🫶

🌸 NAME 🌸

cdist-type__rsync — mirror directories using rsync

✨ DESCRIPTION ✨

so the whole point of this type? it's bringing the raw power of rsync into cdist. that's it. that's the vibe. iconic behavior fr 💅

🎀 REQUIRED PARAMETERS 🎀

  • source — the source directory, on your local machine. heads up tho: if source is a directory, a slash (/) gets added to the source and to the destination paths. just how it is, no cap 🦋

👑 OPTIONAL PARAMETERS 👑

  • destination — where it's going. defaults to $__object_id. yes queen, it already knows ✨
  • owner — this gets passed straight to rsync as --chown=OWNER. go read rsync(1) if you want the whole lore, bestie 📖
  • group — passed to rsync as --chown=:GROUP. again, rsync(1) has the details 💜
  • mode — passed to rsync as --chmod=MODE. yep, rsync(1). you know the drill 🎀
  • options — defaults to --recursive --links --perms --times. BUT — and this is the important part — because of a bug in Python's argparse (you can peep it at https://bugs.python.org/issue9334), the value must be prefixed with \. do not skip the backslash, i'm literally begging 😭
  • remote-user — defaults to root. main character default energy tbh 👑

🌈 OPTIONAL MULTIPLE PARAMETERS 🌈

  • option — stack extra options onto rsync. rsync(1) lists every possible one if you wanna scroll. and same situation as options above: due to that Python argparse bug (https://bugs.python.org/issue9334), the value must be prefixed with \. multiple of these? yes. gorgeous 🦋

💖 EXAMPLES 💖

look at her go:

__rsync /var/www/example.com \
    --owner root \
    --group www-data \
    --mode 'D750,F640' \
    --source "$__files/example.com/www"

ate. no crumbs. 🔥

⭐ AUTHORS ⭐

Ander Punnar <ander-at-kvlt-dot-ee>

🌸 COPYING 🌸

Copyright (C) 2021 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

ungleich GmbH 2021

and that's the whole page, bestie 🥹 this was cdist-type__rsync(7) from cdist version 7.0.0, dated Jul 31, 2022. go mirror something cute, ily, bye 💖✨🎀

📦 where this page comes from