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

  
 
  

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 de-
     fault 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  perfor-
     mance.

     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  sim-
     plicity  can  be  balanced with powerfulness. See the online manual for de-
     tails  on	 the   CONFIG-FILE   https://axkibe.github.io/lsyncd/manual/con-
     fig/file/ .

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

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  di-
     rectory) 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+15.1.quarterly>

home | help