Linux Certif

Toute la documentation sur la certification Linux LPI

lsyncd.conf.xml

NAME

lsyncd.conf.xml - xconfig file for lsyncd

DESCRIPTION

lsyncd.conf.xml is used to configure the lsyncd daemon.

Note that any command line options can overrule settings in the config file. A lsyncd configuration file has an XML grammar. That means tags have to be closed with a / and the such. Following explanations will be provided with an examples.

The config file must start with a <lsyncd> root node. A "version" parameter has to be present which specifies the lsyncd version of the config file format. Currently this is 1.

 <lsyncd version="1">
 

SETTINGS

Next is optionally a <settings> node. It controls lsyncd global settings. All settings are optional.

   <settings>
 

If a <debug/> node is present all debug messages will be logged. Default is a normal verbosity.

     <debug/>
 

If <delay/> specified by the "value" parameter 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. If delay is 0 changes will be handlet immediatly. Default is 5 seconds.

     <delay/>
 

If a <scarce> node is present only error messages will be logged. Default is a normal verbosity.

     <scarce/>
 

If a <stubborn> node is present lsyncd will continue even if the startup sync fails. Default is being not stubborn.

     <stubborn/>
 

If a <no-daemon> node is present lsyncd will not detach and log to stdout/stderr. Default is to detach as daemon.

     <no-daemon/>
 

If a <dry-run> node is present lsyncd will not call any actions (rsync) for test purposes. Default is not to run dry.

     <dry-run/>
 

With an <exclude-from> entry an exclusion file can be specified with a "filename" parameter. This will be passed to rsync and follows rsyncs grammar for exclude files. Default is not to pass an exlude file to rsync.

     <exclude-from filename="/etc/lsyncd.exclude"/>
 

With a <logfile> node to location of the logfile can be changed. Default is /var/log/lsyncd. Take care that the user which lsyncd is running with can write to this file.

     <logfile filename="/var/log/lsyncd"/>
 

A <binary> node specifies the binary lsyncd will call to sync stuff. Usually you want this to be rsync. Default is /usr/bin/rsync.

     <binary filename="/usr/bin/rsync"/>
 

If a <pidfile> node is present lsyncd will write its pid there. Default is not to write a pidfile.

     <pidfile filename="/var/run/lsyncd.pid"/>
 

With a <callopts> node you can control the arguments lsyncd will call the <binary> (rsync) with. Each child node will specify one argument. <option> specifies a literal argument. Only %r will be replaced with 'r' when rsycnd is supposed to work recursive (on startup of lsyncd) or 'd' on normal operations. <exclude-file> will be replaced with --exclude-from [FILE] if an <exclude-from> file is specified. <source> will be replaced the source directory to sync from. <destination> will be replace to the target to sync to. Default arguments are -lt%r --delete {--exclude-from [FILE]} [SOURCE] [DIRECTORY].

     <callopts>
         <option text="-lt%r"/>
         <option text="--delete"/>
         <exclude-file/>
         <source/>
         <destination/>
     </callopts>
 

End of (optional) settings section.

   </settings>
 

DIRECTORIES

With <directory> nodes arbitrarily many sources to be watched can be specified. Within a <directory> entry you can again specify a <binary>, <exclude-from> or a <callopt> node which will override global settings just for this source. See SETTINGS for details on this options.

The mandatory <source> node specifies with the parameter "path" the directory to watch and sync. (once in a while something is mandatory. Also at least one <target;> node has to specified where to sync to. This has to be a format accepted by rsync.

   <directory>
     <source path="/absolute/path/to/source"/>
     <target path="desthost::module/"/>
   </directory>
 

End of a lsyncd.conf.xml file.

 </lsyncd>
 

FILES

/etc/lsyncd.conf.xml

The default location of the configuration file.

SEE ALSO

lsyncd(1)

AUTHOR

Axel Kittenberger <axel.kittenberger@univie.ac.at>

Author.

COPYRIGHT

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 Foundation.