ccollect release 2.1

software/ccollect/documentation/ccollect.html

@@ -736,8 +736,8 @@ asciidoc.install();
 <h1>ccollect - Installing, Configuring and Using</h1>
 <span id="author">Nico Schottelius</span><br />
 <span id="email"><code>&lt;<a href="mailto:nico-ccollect__@__schottelius.org">nico-ccollect__@__schottelius.org</a>&gt;</code></span><br />
-<span id="revnumber">version 2.0,</span>
+<span id="revnumber">version 2.1,</span>
-<span id="revdate">for ccollect 2.0, Initial Version from 2006-01-13</span>
+<span id="revdate">for ccollect 2.1, Initial Version from 2006-01-13</span>
 </div>
 <div id="content">
 <div id="preamble">
@@ -2205,8 +2205,8 @@ rsync -av -H --delete /mnt/archiv/ "$DDIR/archiv/"</code></pre>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Version 2.0<br />
+Version 2.1<br />
-Last updated 2016-09-26 17:26:50 CEST
+Last updated 2017-03-22 10:44:41 CET
 </div>
 </div>
 </body>

software/ccollect/documentation/ccollect.text

@@ -1,7 +1,7 @@
 ccollect - Installing, Configuring and Using
 ============================================
 Nico Schottelius <nico-ccollect__@__schottelius.org>
-2.0, for ccollect 2.0, Initial Version from 2006-01-13
+2.1, for ccollect 2.1, Initial Version from 2006-01-13
 :Author Initials: NS
 
 

software/ccollect/documentation/man/ccollect.1

@@ -2,12 +2,12 @@
 .\"     Title: ccollect
 .\"    Author: Nico Schottelius <nico-ccollect--@--schottelius.org>
 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
-.\"      Date: 09/26/2016
+.\"      Date: 03/22/2017
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "CCOLLECT" "1" "09/26/2016" "\ \&" "\ \&"
+.TH "CCOLLECT" "1" "03/22/2017" "\ \&" "\ \&"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -44,6 +44,11 @@ For more information refer to the manual titled "ccollect \- Installing, Configu
 Backup all sources specified in /etc/ccollect/sources
 .RE
 .PP
+\-e, \-\-errors
+.RS 4
+Log only errors
+.RE
+.PP
 \-h, \-\-help
 .RS 4
 Show the help screen
@@ -54,19 +59,139 @@ Show the help screen
 Specifies the number of jobs to run simultaneously\&. If max is not specified then parallelise all jobs\&.
 .RE
 .PP
+\-l FILE, \-\-logfile FILE
+.RS 4
+Log to specified file
+.RE
+.PP
 \-p, \-\-parallel
 .RS 4
 Parallelise backup processes (deprecated from 2\&.0)
 .RE
 .PP
+\-s, \-\-syslog
+.RS 4
+Log to syslog with tag ccollect
+.RE
+.PP
+\-V, \-\-version
+.RS 4
+Show version and exit
+.RE
+.PP
 \-v, \-\-verbose
 .RS 4
 Be very verbose (uses set \-x)
 .RE
+.SH "LOGGING MECHANISM"
+.sp
+ccollect logging depends on running in non\-interactive/interactive mode and on specified optins\&. The mechanism behaves as the following:
 .PP
-\-V, \-\-version
+non\-interactive mode
 .RS 4
-Show version and exit
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+standard output goes to syslog
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+optional: specify logging into file
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+log all output by default
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+optional: log only errors
+.RE
+.RE
+.PP
+interactive mode
+.RS 4
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+standard output goes to stdout
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+log only errors
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+optional: log into syslog or file
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+log all output by default
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+optional: log only errors
+.RE
+.RE
 .RE
 .SH "SEE ALSO"
 .sp

software/ccollect/documentation/man/ccollect.htm

@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="article" title="ccollect(1)"><div class="titlepage"><div><div><h2 class="title"><a name="idp64573680"></a>ccollect(1)</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Nico</span> <span class="surname">Schottelius</span></h3><code class="email">&lt;<a class="email" href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</code></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#_name">NAME</a></span></dt><dt><span class="section"><a href="#_synopsis">SYNOPSIS</a></span></dt><dt><span class="section"><a href="#_description">DESCRIPTION</a></span></dt><dt><span class="section"><a href="#_options">OPTIONS</a></span></dt><dt><span class="section"><a href="#_see_also">SEE ALSO</a></span></dt><dt><span class="section"><a href="#_author">AUTHOR</a></span></dt><dt><span class="section"><a href="#_resources">RESOURCES</a></span></dt><dt><span class="section"><a href="#_copying">COPYING</a></span></dt></dl></div><div class="section" title="NAME"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_name"></a>NAME</h2></div></div></div><p>ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync</p></div><div class="section" title="SYNOPSIS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_synopsis"></a>SYNOPSIS</h2></div></div></div><p><span class="emphasis"><em>ccollect.sh</em></span> [args] &lt;interval name&gt; &lt;sources to backup&gt;</p></div><div class="section" title="DESCRIPTION"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_description"></a>DESCRIPTION</h2></div></div></div><p><code class="literal">ccollect</code> is a backup utility written in the sh-scripting language.
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="article" title="ccollect(1)"><div class="titlepage"><div><div><h2 class="title"><a name="idp62483048"></a>ccollect(1)</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Nico</span> <span class="surname">Schottelius</span></h3><code class="email">&lt;<a class="email" href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</code></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#_name">NAME</a></span></dt><dt><span class="section"><a href="#_synopsis">SYNOPSIS</a></span></dt><dt><span class="section"><a href="#_description">DESCRIPTION</a></span></dt><dt><span class="section"><a href="#_options">OPTIONS</a></span></dt><dt><span class="section"><a href="#_logging_mechanism">LOGGING MECHANISM</a></span></dt><dt><span class="section"><a href="#_see_also">SEE ALSO</a></span></dt><dt><span class="section"><a href="#_author">AUTHOR</a></span></dt><dt><span class="section"><a href="#_resources">RESOURCES</a></span></dt><dt><span class="section"><a href="#_copying">COPYING</a></span></dt></dl></div><div class="section" title="NAME"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_name"></a>NAME</h2></div></div></div><p>ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync</p></div><div class="section" title="SYNOPSIS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_synopsis"></a>SYNOPSIS</h2></div></div></div><p><span class="emphasis"><em>ccollect.sh</em></span> [args] &lt;interval name&gt; &lt;sources to backup&gt;</p></div><div class="section" title="DESCRIPTION"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_description"></a>DESCRIPTION</h2></div></div></div><p><code class="literal">ccollect</code> is a backup utility written in the sh-scripting language.
 It does not depend on a specific shell, only <code class="literal">/bin/sh</code> needs to be
 bourne shell compatibel (like <span class="emphasis"><em>dash</em></span>, <span class="emphasis"><em>ksh</em></span>, <span class="emphasis"><em>zsh</em></span>, <span class="emphasis"><em>bash</em></span>, &#8230;).</p><p>For more information refer to the manual titled
 "ccollect - Installing, Configuring and Using" (available as text (asciidoc),
@@ -7,6 +7,10 @@ texinfo or html).</p></div><div class="section" title="OPTIONS"><div class="titl
 </span></dt><dd>
    Backup all sources specified in /etc/ccollect/sources
 </dd><dt><span class="term">
+-e, --errors
+</span></dt><dd>
+   Log only errors
+</dd><dt><span class="term">
 -h, --help
 </span></dt><dd>
    Show the help screen
@@ -16,17 +20,48 @@ texinfo or html).</p></div><div class="section" title="OPTIONS"><div class="titl
    Specifies the number of jobs to run simultaneously.
    If max is not specified then parallelise all jobs.
 </dd><dt><span class="term">
+-l FILE, --logfile FILE
+</span></dt><dd>
+   Log to specified file
+</dd><dt><span class="term">
 -p, --parallel
 </span></dt><dd>
    Parallelise backup processes (deprecated from 2.0)
 </dd><dt><span class="term">
--v, --verbose
+-s, --syslog
 </span></dt><dd>
-   Be very verbose (uses set -x)
+   Log to syslog with tag ccollect
 </dd><dt><span class="term">
 -V, --version
 </span></dt><dd>
    Show version and exit
-</dd></dl></div></div><div class="section" title="SEE ALSO"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_see_also"></a>SEE ALSO</h2></div></div></div><p>ccollect_add_source(1), ccollect_analyse_logs(1), ccollect_logwrapper(1)
+</dd><dt><span class="term">
+-v, --verbose
+</span></dt><dd>
+   Be very verbose (uses set -x)
+</dd></dl></div></div><div class="section" title="LOGGING MECHANISM"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_logging_mechanism"></a>LOGGING MECHANISM</h2></div></div></div><p>ccollect logging depends on running in non-interactive/interactive mode
+and on specified optins. The mechanism behaves as the following:</p><div class="variablelist"><dl><dt><span class="term">
+non-interactive mode
+</span></dt><dd><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+standard output goes to syslog
+</li><li class="listitem">
+optional: specify logging into file
+</li><li class="listitem">
+log all output by default
+</li><li class="listitem">
+optional: log only errors
+</li></ul></div></dd><dt><span class="term">
+interactive mode
+</span></dt><dd><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
+standard output goes to stdout
+</li><li class="listitem">
+log only errors
+</li><li class="listitem"><p class="simpara">
+optional: log into syslog or file
+</p><div class="itemizedlist"><ul class="itemizedlist" type="circle"><li class="listitem">
+log all output by default
+</li><li class="listitem">
+optional: log only errors
+</li></ul></div></li></ul></div></dd></dl></div></div><div class="section" title="SEE ALSO"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_see_also"></a>SEE ALSO</h2></div></div></div><p>ccollect_add_source(1), ccollect_analyse_logs(1), ccollect_logwrapper(1)
 ccollect_delete_source(1), ccollect_list_intervals(1)</p></div><div class="section" title="AUTHOR"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_author"></a>AUTHOR</h2></div></div></div><p>Nico Schottelius &lt;<a class="ulink" href="mailto:nico-ccollect--@--schottelius.org" target="_top">nico-ccollect--@--schottelius.org</a>&gt;</p></div><div class="section" title="RESOURCES"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_resources"></a>RESOURCES</h2></div></div></div><p>Main web site: <a class="ulink" href="http://www.nico.schottelius.org/software/ccollect/" target="_top">http://www.nico.schottelius.org/software/ccollect/</a></p></div><div class="section" title="COPYING"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_copying"></a>COPYING</h2></div></div></div><p>Copyright (C) 2006-2008 Nico Schottelius. Free use of this software is
 granted under the terms of the GNU General Public License Version 3 (GPLv3).</p></div></div></body></html>

software/ccollect/documentation/man/ccollect.html

@@ -774,6 +774,14 @@ texinfo or html).</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
+-e, --errors
+</dt>
+<dd>
+<p>
+   Log only errors
+</p>
+</dd>
+<dt class="hdlist1">
 -h, --help
 </dt>
 <dd>
@@ -791,6 +799,14 @@ texinfo or html).</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
+-l FILE, --logfile FILE
+</dt>
+<dd>
+<p>
+   Log to specified file
+</p>
+</dd>
+<dt class="hdlist1">
 -p, --parallel
 </dt>
 <dd>
@@ -799,11 +815,11 @@ texinfo or html).</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
--v, --verbose
+-s, --syslog
 </dt>
 <dd>
 <p>
-   Be very verbose (uses set -x)
+   Log to syslog with tag ccollect
 </p>
 </dd>
 <dt class="hdlist1">
@@ -814,30 +830,108 @@ texinfo or html).</p></div>
    Show version and exit
 </p>
 </dd>
+<dt class="hdlist1">
+-v, --verbose
+</dt>
+<dd>
+<p>
+   Be very verbose (uses set -x)
+</p>
+</dd>
 </dl></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_see_also">5. SEE ALSO</h2>
+<h2 id="_logging_mechanism">5. LOGGING MECHANISM</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>ccollect logging depends on running in non-interactive/interactive mode
+and on specified optins. The mechanism behaves as the following:</p></div>
+<div class="dlist"><dl>
+<dt class="hdlist1">
+non-interactive mode
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+standard output goes to syslog
+</p>
+</li>
+<li>
+<p>
+optional: specify logging into file
+</p>
+</li>
+<li>
+<p>
+log all output by default
+</p>
+</li>
+<li>
+<p>
+optional: log only errors
+</p>
+</li>
+</ul></div>
+</dd>
+<dt class="hdlist1">
+interactive mode
+</dt>
+<dd>
+<div class="ulist"><ul>
+<li>
+<p>
+standard output goes to stdout
+</p>
+</li>
+<li>
+<p>
+log only errors
+</p>
+</li>
+<li>
+<p>
+optional: log into syslog or file
+</p>
+<div class="ulist"><ul>
+<li>
+<p>
+log all output by default
+</p>
+</li>
+<li>
+<p>
+optional: log only errors
+</p>
+</li>
+</ul></div>
+</li>
+</ul></div>
+</dd>
+</dl></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_see_also">6. SEE ALSO</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>ccollect_add_source(1), ccollect_analyse_logs(1), ccollect_logwrapper(1)
 ccollect_delete_source(1), ccollect_list_intervals(1)</p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_author">6. AUTHOR</h2>
+<h2 id="_author">7. AUTHOR</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_resources">7. RESOURCES</h2>
+<h2 id="_resources">8. RESOURCES</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Main web site: <a href="http://www.nico.schottelius.org/software/ccollect/">http://www.nico.schottelius.org/software/ccollect/</a></p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_copying">8. COPYING</h2>
+<h2 id="_copying">9. COPYING</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Copyright (C) 2006-2008 Nico Schottelius. Free use of this software is
 granted under the terms of the GNU General Public License Version 3 (GPLv3).</p></div>
@@ -847,7 +941,7 @@ granted under the terms of the GNU General Public License Version 3 (GPLv3).</p>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2016-09-26 17:06:50 CEST
+Last updated 2017-03-22 10:23:00 CET
 </div>
 </div>
 </body>

software/ccollect/documentation/man/ccollect.text

@@ -26,20 +26,54 @@ texinfo or html).
 
 OPTIONS
 -------
+-a, --all::
+   Backup all sources specified in /etc/ccollect/sources
+
+-e, --errors::
+   Log only errors
+
 -h, --help::
    Show the help screen
 
--p, --parallel::
+-j [max], --jobs [max]::
-   Parallelise backup processes
+   Specifies the number of jobs to run simultaneously.
+   If max is not specified then parallelise all jobs.
 
--a, --all::
+-l FILE, --logfile FILE::
-   Backup all sources specified in /etc/ccollect/sources
+   Log to specified file
+
+-p, --parallel::
+   Parallelise backup processes (deprecated from 2.0)
+
+-s, --syslog::
+   Log to syslog with tag ccollect
+
+-V, --version::
+   Show version and exit
 
 -v, --verbose::
    Be very verbose (uses set -x)
 
--V, --version::
+
-   Show version and exit
+LOGGING MECHANISM
+-----------------
+ccollect logging depends on running in non-interactive/interactive mode
+and on specified optins. The mechanism behaves as the following:
+
+non-interactive mode::
+
+    * standard output goes to syslog
+    * optional: specify logging into file
+    * log all output by default
+    * optional: log only errors
+
+interactive mode::
+
+    * standard output goes to stdout
+    * log only errors
+    * optional: log into syslog or file
+        - log all output by default
+        - optional: log only errors
 
 
 SEE ALSO

software/ccollect/download.mdwn

@@ -5,6 +5,7 @@ You can get the latest (development) version via git:
     git clone https://github.com/telmich/ccollect.git
 
 ## Releases
+ * <A HREF="ccollect-2.1.tar.bz2">ccollect-2.1.tar.bz2</A>
  * <A HREF="ccollect-2.0.tar.bz2">ccollect-2.0.tar.bz2</A>
  * [[ccollect-0.8.tar.bz2]] ([[RPM|ccollect-0.8-0.noarch.rpm]])
  * <A HREF="ccollect-0.7.1.tar.bz2">ccollect-0.7.1.tar.bz2</A>