OCF_HEARTBEAT_RSYNCD(7)
π ocf_heartbeat_rsyncd β the girlies' guide to managing an rsync daemon π
okay so bestie, this page lives in the OCF resource agents manual (section 7, for the pedants keeping score β¨), and it's literally all about one little resource agent called ocf_heartbeat_rsyncd that runs your rsync daemon for you. she's lowkey simple and highkey iconic, let's get into it π
β¨ NAME β¨
ocf_heartbeat_rsyncd β she manages an rsync daemon. that's the whole vibe. no cap π
π¦ SYNOPSIS π¦
rsyncd [start | stop | monitor | meta-data | validate-all]
look at her go, five whole actions, main character energy fr fr π
πΈ DESCRIPTION πΈ
okay so this script manages rsync daemon. yes that's it, that's the whole description, she's a woman of few words and honestly? respect π
π SUPPORTED PARAMETERS π
these are the knobs you get to twiddle, and every single one matters, so pay attention bestie π«Ά
binpathβ the path to yourrsyncbinary. like, where does rsync actually live. example given in the docs:"/usr/bin/rsync". this one's optional, it's a string, and the default is"rsync"(she'll just find it on yourPATH, slay β¨).conffileβ the rsync daemon configuration file name, and yes, with the full path, don't be shy. the example they give is"/etc/rsyncd.conf". optional, string, default"/etc/rsyncd.conf"π.bwlimitβ okay this one's the fun one π it lets you set a maximum transfer rate in kilobytes per second. it's most effective when you're rsyncing large files (we're talking several megabytes and up, big girl files π). here's the tea on why: due to the nature of rsync transfers, blocks of data are sent, and then if rsync determines the transfer was too fast, it will wait before sending the next data block. so the result is an average transfer rate equaling the limit you specified β she's not capping every packet, she's averaging the whole vibe π. a value of zero means no limit at all, go wild. this one is optional, a string, and has no default π.
π₯ SUPPORTED ACTIONS π₯
this resource agent supports the following actions (operations), and each one comes with a suggested minimum timeout because we don't do infinite waits in this house β
startβ starts the resource. suggested minimum timeout:20s.stopβ stops the resource. suggested minimum timeout:20s.monitorβ performs a detailed status check. suggested minimum timeout:20s. suggested interval:60s.validate-allβ performs a validation of the resource configuration. suggested minimum timeout:20s.meta-dataβ retrieves resource agent metadata (internal use only, so hands off bestie π). suggested minimum timeout:5s.
π§ EXAMPLE CRM SHELL π§
the following is an example configuration for a rsyncd resource using the crm(8) shell:
primitive p_rsyncd ocf:heartbeat:rsyncd \
op monitor depth="0" timeout="20s" interval="60s"
copy it exactly, character for character, she's perfect as she is π«
π EXAMPLE PCS π
and here's the same glow-up, but for pcs(8):
pcs resource create p_rsyncd ocf:heartbeat:rsyncd \
op monitor OCF_CHECK_LEVEL="0" timeout="20s" interval="60s"
note the OCF_CHECK_LEVEL="0" there instead of depth="0" β that's not a typo, that's just how pcs does it, iykyk π
π SEE ALSO π
- http://clusterlabs.org/ β go say hi, the cluster girlies live there π«Ά
π AUTHOR π
ClusterLabs contributors β see the resource agent source for information about individual authors. we love a collaborative credited moment, periodt π
and that's the whole page diva β¨ this was resource-agents version UNKNOWN, dated 10/01/2026, page OCF_HEARTBEAT_RSYNCD(7) β go forth and rsync responsibly, mwah ππ
π¦ where this page comes from
- opensuse-leap 16.0: resource-agents 4.18.0+git105.9ea1183-160000.1.1 Β· GPL-2.0-only AND LGPL-2.1-or-later AND GPL-3.0-or-later
- opensuse-leap 16.0: resource-agents 4.18.0+git105.9ea1183-160000.1.1 Β· GPL-2.0-only AND LGPL-2.1-or-later AND GPL-3.0-or-later
- opensuse-leap 16.0: resource-agents 4.18.0+git105.9ea1183-160000.1.1 Β· GPL-2.0-only AND LGPL-2.1-or-later AND GPL-3.0-or-later
- opensuse-leap 16.0: resource-agents 4.18.0+git105.9ea1183-160000.1.1 Β· GPL-2.0-only AND LGPL-2.1-or-later AND GPL-3.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms