diff options
| author | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
| commit | 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 (patch) | |
| tree | f1190704f78f04a2b0b4c977d20fe96a828377f1 /devdocs/vagrant/cli%2Frsync-auto.html | |
new repository
Diffstat (limited to 'devdocs/vagrant/cli%2Frsync-auto.html')
| -rw-r--r-- | devdocs/vagrant/cli%2Frsync-auto.html | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/devdocs/vagrant/cli%2Frsync-auto.html b/devdocs/vagrant/cli%2Frsync-auto.html new file mode 100644 index 00000000..e47773d2 --- /dev/null +++ b/devdocs/vagrant/cli%2Frsync-auto.html @@ -0,0 +1,7 @@ +<h1 id="rsync-auto"> rsync-auto </h1> <p><strong>Command: <code>vagrant rsync-auto</code></strong></p> <p>This command watches all local directories of any <a href="../synced-folders/rsync">rsync synced folders</a> and automatically initiates an rsync transfer when changes are detected. This command does not exit until an interrupt is received.</p> <p>The change detection is optimized to use platform-specific APIs to listen for filesystem changes, and does not simply poll the directory.</p> <h2 id="options"> Options </h2> <ul> <li> +<a href="#no-poll"><code>--[no-]poll</code></a> - Force Vagrant to watch for changes using filesystem polling instead of filesystem events. This is required for some filesystems that do not support events. Warning: enabling this will make <code>rsync-auto</code> <em>much</em> slower. By default, polling is disabled. </li> </ul> <h2 id="machine-state-changes"> Machine State Changes </h2> <p>The <code>rsync-auto</code> command does not currently handle machine state changes gracefully. For example, if you start the <code>rsync-auto</code> command, then halt the guest machine, then make changes to some files, then boot it back up, <code>rsync-auto</code> will not attempt to resync.</p> <p>To ensure that the command works properly, you should start <code>rsync-auto</code> only when the machine is running, and shut it down before any machine state changes.</p> <p>You can always force a resync with the <a href="rsync">rsync</a> command.</p> <h2 id="vagrantfile-changes"> Vagrantfile Changes </h2> <p>If you change or move your Vagrantfile, the <code>rsync-auto</code> command will have to be restarted. For example, if you add synced folders to the Vagrantfile, or move the directory that contains the Vagrantfile, the <code>rsync-auto</code> command will either not pick up the changes or may begin experiencing strange behavior.</p> <p>Before making any such changes, it is recommended that you turn off <code>rsync-auto</code>, then restart it afterwards.</p><div class="_attribution"> + <p class="_attribution-p"> + © 2010–2018 Mitchell Hashimoto<br>Licensed under the MPL 2.0 License.<br> + <a href="https://www.vagrantup.com/docs/cli/rsync-auto.html" class="_attribution-link">https://www.vagrantup.com/docs/cli/rsync-auto.html</a> + </p> +</div> |