Man Linux: Main Page and Category List


       lsyncd - A rsync-based tool to monitor a directory including
       subdirectories and update modifications.


       lsyncd [--binary FILE] [--conf FILE] [--debug] [--delay SECS]
              [--dryrun] [--exclude-file FILE] [--logfile FILE] [--no-daemon]
              [--pidfile FILE] [--scarce] [--stubborn] [source] [target...]

       lsyncd [{--help} | {--version}]


       lsyncd is a program that uses rsync to synchronize local directories
       with a or several remote machine(s) running rsyncd. Lsyncd watches
       multiple directory trees through inotify. On startup it will rsync all
       directories with the remote host(s), and then sync single directories
       by collecting the inotify events. This tool is a light-weight live
       mirror solution.


       The program takes options starting with two dashes (‘-’). A summary of
       options is included below.

       --binary FILE
          Call this binary to sync (DEFAULT: /usr/bin/rsync).

       --conf FILE
          config file to read config from. See lsyncd.conf.xml(5)

          Default: /etc/lsyncd.conf.xml if no source, target is given in the
          commandline. If they are given and [--conf] is not given no config
          file will be loaded.

          Log debug messages

       --deleay SECS
          If <delay/> is greater than zero, lsyncd waits this amount of
          seconds between an event and calling the binary. All events for a
          directory in this timeframe will be aggregated to one call. Default
          is 5 seconds.


          Do not call rsync, run dry only

       --exclude-file FILE
          Exclude file handlet to rsync (DEFAULT: None).

       --logfile FILE
          Put log here (DEFAULT: /var/log/lsyncd).

          Do not detach, log to stdout/stderr.

       --pidfile FILE
          Create a file with pid of application.

          Only log errors.

          Continue even if startup sync fails.

          Show summary of options.

          Show version of program.


          The default location of configuration file.

          The default location of log file. Make sure the running user has
          write access to this file, or specify a different log file name.


       lsyncd provides some return codes, that can be used in scripts:

       Code   Diagnostic
       0      Program exited successfully.
       1      Out of memory.
       2      File was not found, or failed to write.
       3      binary (most likely rsync) returned
              non-zero result on startup.
       4      Something wrong the command-line arguments
              in the lsyncd invocation.
       5      Too many exclude files were specified.
       6      Something wrong with the config file.
       7      Kernel cannot do inotify.
       255    Internal failure.


       lsyncd.conf.xml(5) rsync(1)

       The programs are documented fully in README file available in


       Junichi Uekawa <>
          Wrote this manpage for the Debian system.

       Axel Kittenberger <>
          Strives to keep this up to date.


       Copyright © 2008 Junichi Uekawa, Axel Kittenberger

       Permission is granted to copy, distribute and/or modify this document
       under the terms of the GNU General Public License, Version 2 or (at
       your option) any later version published by the Free Software