.

will be generated. You may view the manual page with: nroff -man .

| less'. A typical entry in a Makefile or Makefile.am is: DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/manpages/docbook.xsl XP = xsltproc -''-nonet -''-param man.charmap.use.subset "0" manpage.1: manpage.xml $(XP) $(DB2MAN) $< The xsltproc binary is found in the xsltproc package. The XSL files are in docbook-xsl. A description of the parameters you can use can be found in the docbook-xsl-doc-* packages. Please remember that if you create the nroff version in one of the debian/rules file targets (such as build), you will need to include xsltproc and docbook-xsl in your Build-Depends control field. Alternatively use the xmlto command/package. That will also automatically pull in xsltproc and docbook-xsl. Notes for using docbook2x: docbook2x-man does not automatically create the AUTHOR(S) and COPYRIGHT sections. In this case, please add them manually as ... . To disable the automatic creation of the AUTHOR(S) and COPYRIGHT sections read /usr/share/doc/docbook-xsl/doc/manpages/authors.html. This file can be found in the docbook-xsl-doc-html package. Validation can be done using: `xmllint -''-noout -''-valid manpage.xml` General documentation about man-pages and man-page-formatting: man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ --> ]> lsyncd Axel Kittenberger

axel.kittenberger@univie.ac.at

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. LSYNCD.CONF.XML 5 lsyncd.conf.xml xconfig file for lsyncd 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"> 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 <no-startup> node is present lsyncd will not initiate the recursive rsync call on startup. Not adviced, know what you are doing if using this. <no-startup/> 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 -lts%r --delete {--exclude-from [FILE]} [SOURCE] [DIRECTORY]. <callopts> With a <inotify> node you can control the inotify events lsyncd will register to. Each event is configured by a <event> child node and its attribute 'id'. The following events may be registered: ACCESS,ATTRIB,CLOSE_WRITE,CLOSE_NOWRITE,CREATE,DELETE,DELETE_SELF,MODIFY,MOVE_SELF,MOVED_FROM,MOVED_TO,OPEN. If the inotify node is omitted the following events are registered by default: IN_ATTRIB,IN_CLOSE_WRITE,IN_CREATE,IN_DELETE,IN_DELETE_SELF,IN_MOVED_FROM,IN_MOVED_TO,IN_DONT_FOLLOW,IN_ONLYDIR. <inotify> <event id="MOVED_TO"/> <event id="DELETE"/> </inotify> <option text="-lts%r"/> <option text="--delete"/> <exclude-file/> <source/> <destination/> </callopts> End of (optional) settings section. </settings> + With <directory> nodes arbitrarily many sources to be watched can be specified. Within a <directory> entry you can again specify a <binary>, <exclude-from>, <callopt> or a <inotify> node which will override global settings just for this source. See SETTINGS for details on this options. + The mandatory <source> node specifies with the paramater "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> /etc/lsyncd.conf.xml The default location of the configuration file. lsyncd 1