Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LSYNCD(1)			    Lsyncd			     LSYNCD(1)

NAME
       lsyncd -	a daemon to continuously synchronize directory trees

SYNOPSIS
       config file
	     lsyncd [OPTIONS] CONFIG-FILE

       default rsync behaviour
	     lsyncd [OPTIONS] -rsync SOURCEDIR TARGET ...

       default rync+ssh	behaviour (moves and deletes through ssh)
	     lsyncd [OPTIONS] -rsyncssh	SOURCEDIR TARGETHOST TARGETDIR ...

       default direct behaviour	(local file operations/rsync)
	     lsyncd [OPTIONS] -direct SOURCEDIR	TARGETDIR ...

DESCRIPTION
       Lsyncd(1) watches local directory trees through an event	monitor
       interface (inotify, fsevents). It aggregates and	combines events	for a
       few seconds and then spawns one or more processes to synchronize	the
       changes.	By default this	is rsync(1). Lsyncd is thus a light-weight
       asynchronous live mirror	solution that is comparatively easy to install
       not requiring new filesystems or	block devices and does not hamper
       local filesystem	performance.

       Rsync+ssh is an advanced	action configuration that uses a SSH(1)	to act
       file and	directory moves	directly on the	target instead of
       re-transmitting the move	destination over the wire.

       Fine-grained customization can be achieved through the CONFIG-FILE.
       Custom action configs can even be written from scratch in cascading
       layers ranging from shell scripts to code written in the	LUA(1)
       language. This way simplicity can be balanced with powerfulness.	See
       the online manual for details on	the CONFIG-FILE
       https://axkibe.github.io/lsyncd/manual/config/file/ .

       Note that under normal configuration Lsyncd will	delete pre-existing
       files in	the target directories that are	not present in the respective
       source directory.

OPTIONS
       -delay SECS
	   Overrides the default delay times.

       -help
	   Show	a help message.

       -insist
	   Continues start up even if rsync cannot connect.

       -log LEVEL
	   Controls which kind of events are logged. By	default	Lsyncd logs
	   Normal and Error Messages.  -log scarce will	make Lsyncd log	Error
	   messages only.  -log	all will log all debug messages.

       -log Category
	   Turns on a specific debug message. E.g.  -log Exec will log all
	   processes as	they are spawned.

       -nodaemon
	   Lsyncd will not detach from the invoker and log as well to
	   stdout/err.

       -pidfile	FILE
	   Lsyncd will write its process ID in FILE.

       -runner FILE
	   Makes the Lsyncd core load the part of Lsyncd written in Lua	from
	   FILE.

       -version
	   Writes version information and exits.

EXIT STATUS
       (128+SIGNUM)
	   Terminated by Signal	(143 by	TERM)

       -1
	   Failure (syntax, unrecoverable error	condition, internal failure)

SEE ALSO
       Online Manual: https://axkibe.github.io/lsyncd/

VERSION
       This man	page is	for lsyncd(1) version 2.2.0

AUTHOR
       Axel Kittenberger, <axkibe@gmail.com> 2010-2017

COPYING
       Copyright (C) 2010-2017 Axel Kittenberger. Free use of this software is
       granted under the terms of the GNU General Public License (GPL) version
       2, or any later version.	Free redistrubition of this Documentation
       (/doc directory)	is granted under the terms of the Creative Commons 3.0
       Attribution License (CC-3.0-BY).

Lsyncd 2.2.1			 January 2017			     LSYNCD(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lsyncd&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help