nico
/
www.nico.schottelius.org
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

update ccollect documentation 

Signed-off-by: Nico Schottelius <nico@ikn.schottelius.org>
This commit is contained in:
Nico Schottelius 2009-07-01 22:44:36 +02:00
parent 00e0aa5614
commit 264a87d887
29 changed files with 1367 additions and 767 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

72
software/ccollect/doc/ccollect-DE.htm
View File

@ -1,94 +1,94 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect- Installieren, Konfigurieren und Anwenden</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2503736"></a>ccollect- Installieren, Konfigurieren und Anwenden</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Julian</span> <span class="surname">Meier</span></h3><div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:julian.meier__@__julian.mkr-tech.ch">julian.meier__@__julian.mkr-tech.ch</a>&gt;</code></p></div></div></div></div><div><div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="3"><b>Revision History</b></th></tr><tr><td align="left">Revision 0.1</td><td align="left">Initiale Version vom 2006-03-04</td><td align="left">JM</td></tr></table></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#_einleitung">Einleitung</a></span></dt><dt><span class="section"><a href="#_installation">Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#_anforderungen">Anforderungen</a></span></dt><dt><span class="section"><a href="#_installieren">Installieren</a></span></dt></dl></dd><dt><span class="section"><a href="#_konfiguration">Konfiguration</a></span></dt><dd><dl><dt><span class="section"><a href="#_konfigurationsverzeichnisse">Konfigurationsverzeichnisse</a></span></dt><dt><span class="section"><a href="#_intervalle">Intervalle</a></span></dt><dt><span class="section"><a href="#_sources">Sources</a></span></dt><dt><span class="section"><a href="#_quelle">Quelle</a></span></dt><dt><span class="section"><a href="#_ziel">Ziel</a></span></dt><dt><span class="section"><a href="#_spezielles">Spezielles</a></span></dt></dl></dd></dl></div><p><span class="strong"><strong>DIESE ANLEITUNG IST NICHT AKTUELL UND MUSS
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect- Installieren, Konfigurieren und Anwenden</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="article" title="ccollect- Installieren, Konfigurieren und Anwenden"><div class="titlepage"><div><div><h2 class="title"><a name="id395496"></a>ccollect- Installieren, Konfigurieren und Anwenden</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Julian</span> <span class="surname">Meier</span></h3><code class="email">&lt;<a class="email" href="mailto:julian.meier__@__julian.mkr-tech.ch">julian.meier__@__julian.mkr-tech.ch</a>&gt;</code></div></div><div><div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="3"><b>Revision History</b></th></tr><tr><td align="left">Revision 0.1</td><td align="left">Initiale Version vom 2006-03-04</td><td align="left">JM</td></tr></table></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#_einleitung">Einleitung</a></span></dt><dt><span class="section"><a href="#_installation">Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#_anforderungen">Anforderungen</a></span></dt><dt><span class="section"><a href="#_installieren">Installieren</a></span></dt></dl></dd><dt><span class="section"><a href="#_konfiguration">Konfiguration</a></span></dt><dd><dl><dt><span class="section"><a href="#_konfigurationsverzeichnisse">Konfigurationsverzeichnisse</a></span></dt><dt><span class="section"><a href="#_intervalle">Intervalle</a></span></dt><dt><span class="section"><a href="#_sources">Sources</a></span></dt><dt><span class="section"><a href="#_quelle">Quelle</a></span></dt><dt><span class="section"><a href="#_ziel">Ziel</a></span></dt><dt><span class="section"><a href="#_spezielles">Spezielles</a></span></dt></dl></dd></dl></div><p><span class="strong"><strong>DIESE ANLEITUNG IST NICHT AKTUELL UND MUSS
AKTUALISIERT WERDEN (siehe Englische Version)</strong></span>
inkrementelle Datensicherung
mit <span class="emphasis"><em>hardlinks</em></span> und <span class="emphasis"><em>rsync</em></span></p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_einleitung"></a>Einleitung</h2></div></div></div><p><span class="strong"><strong>DIESE ANLEITUNG IST NICHT AKTUELL UND MUSS
mit <span class="emphasis"><em>hardlinks</em></span> und <span class="emphasis"><em>rsync</em></span></p><div class="section" title="Einleitung"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_einleitung"></a>Einleitung</h2></div></div></div><p><span class="strong"><strong>DIESE ANLEITUNG IST NICHT AKTUELL UND MUSS
AKTUALISIERT WERDEN (siehe Englische Version)</strong></span></p><p><span class="emphasis"><em>ccollect</em></span> ist ein Backuptool geschrieben in der sh-skript Programmiersprache.
Es braucht nichts besonderes nur die <span class="emphasis"><em>/bin/sh</em></span>-Konsole (oder eine kompatible).</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_installation"></a>Installation</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="_anforderungen"></a>Anforderungen</h3></div></div></div><div class="itemizedlist"><p class="title"><b>Die aufgelisteten Werkzeuge müssen für das Benutzen von ccollect installiert sein:</b></p><ul type="disc"><li>
Es braucht nichts besonderes nur die <span class="emphasis"><em>/bin/sh</em></span>-Konsole (oder eine kompatible).</p></div><div class="section" title="Installation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_installation"></a>Installation</h2></div></div></div><div class="section" title="Anforderungen"><div class="titlepage"><div><div><h3 class="title"><a name="_anforderungen"></a>Anforderungen</h3></div></div></div><div class="itemizedlist" title="Die aufgelisteten Werkzeuge müssen für das Benutzen von ccollect installiert sein:"><p class="title"><b>Die aufgelisteten Werkzeuge müssen für das Benutzen von ccollect installiert sein:</b></p><ul class="itemizedlist" type="disc"><li class="listitem">
bc
</li><li>
</li><li class="listitem">
cp
</li><li>
</li><li class="listitem">
rsync
</li><li>
</li><li class="listitem">
date
</li><li>
</li><li class="listitem">
ssh (optional, wenn man ssh-Verbindungen nutzen moechte)
</li></ul></div><p>Am besten überprüfen Sie das mit dem Befehl <span class="emphasis"><em>apt-get install bc rsync ssh</em></span>.
Beim Fehlen eines Werkzeuges wird dieses nachinstalliert.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="_installieren"></a>Installieren</h3></div></div></div><div class="orderedlist"><ol type="1"><li>
Beim Fehlen eines Werkzeuges wird dieses nachinstalliert.</p></div><div class="section" title="Installieren"><div class="titlepage"><div><div><h3 class="title"><a name="_installieren"></a>Installieren</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
Laden Sie sich die neuste Version von ccollect herunter.
Diese finden Sie unter: <span class="emphasis"><em>http://linux.schottelius.org/ccollect</em></span>
</li><li>
</li><li class="listitem">
Wechseln Sie in der Konsole mit "cd <span class="emphasis"><em>Pfad" in das Verzeichniss,
indem sich das ccollect Archiv befindet.
Entpacken Sie das Archiv mit "tar xvfj ccollect-$version.tar.bz2".
Am Besten ist es, wenn Sie jetzt in das Verzeichniss mit den
entpackten Daten wechseln: "cd 'pfad/'ccollect-'version</em></span>.
</li><li>
</li><li class="listitem">
Danach kopieren Sie die Datei <span class="emphasis"><em>ccollect.sh</em></span> aus dem entpackten Archiv nach
/usr/local/bin. Das geht mit dem Befehl "cp ccollect.sh /usr/local/bin".
</li><li>
</li><li class="listitem">
Nun ändern Sie die Rechte für die Datei damit jeder Benutzer das
Programm verwenden kann: "chmod 0755 /usr/local/bin/ccollect.sh"
</li><li>
</li><li class="listitem">
Erstellen Sie nun das Konfigurationsverzeichnis für ccollect:
"mkdir /etc/ccollect/"
</li><li>
</li><li class="listitem">
Starten sie nun zum Testen das Programm ccollect mit dem Befehl
<code class="literal">ccollect.sh</code> in der Konsole.
</li></ol></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_konfiguration"></a>Konfiguration</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="_konfigurationsverzeichnisse"></a>Konfigurationsverzeichnisse</h3></div></div></div><p>Die Konfigurationsdaten befinden sich bei ccollect im oben erstellten Verzeichnis
</li></ol></div></div></div><div class="section" title="Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_konfiguration"></a>Konfiguration</h2></div></div></div><div class="section" title="Konfigurationsverzeichnisse"><div class="titlepage"><div><div><h3 class="title"><a name="_konfigurationsverzeichnisse"></a>Konfigurationsverzeichnisse</h3></div></div></div><p>Die Konfigurationsdaten befinden sich bei ccollect im oben erstellten Verzeichnis
"/etc/ccollect". Um ccollect richtig konfigurieren zu können benötigen Sie
noch ein paar weitere Verzeichnisse:</p><div class="itemizedlist"><ul type="disc"><li>
noch ein paar weitere Verzeichnisse:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
"/etc/ccollect/defaults" mit:
<span class="emphasis"><em>mkdir /etc/ccollect/defaults</em></span>
</li><li>
</li><li class="listitem">
"/etc/ccollect/defaults/intervals" mit:
<span class="emphasis"><em>mkdir /etc/ccollect/defaults/intervals</em></span>
</li><li>
</li><li class="listitem">
"/etc/ccollect/sources" mit:
<span class="emphasis"><em>mkdir /etc/ccollect/sources</em></span>
</li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="_intervalle"></a>Intervalle</h3></div></div></div><p>Der Intervall-Wert definiert, wie viele Backup-Versionen ccollect von
</li></ul></div></div><div class="section" title="Intervalle"><div class="titlepage"><div><div><h3 class="title"><a name="_intervalle"></a>Intervalle</h3></div></div></div><p>Der Intervall-Wert definiert, wie viele Backup-Versionen ccollect von
den gesicherten Daten behalten soll.
Der Name der Datei, in der der Wert steht, ist zugleich auch der
Name des Intervalls.</p><pre class="screen">julian@flumy:/etc/ccollect/defaults/intervals$ ls
daily
julian@flumy:/etc/ccollect/defaults/intervals$ cat daily
7
julian@flumy:/etc/ccollect/defaults/intervals$</pre><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="_intervall_erstellen"></a>Intervall erstellen</h4></div></div></div><p>Sie erstellen einen Intervall wie folgt:</p><div class="orderedlist"><ol type="1"><li>
julian@flumy:/etc/ccollect/defaults/intervals$</pre><div class="section" title="Intervall erstellen"><div class="titlepage"><div><div><h4 class="title"><a name="_intervall_erstellen"></a>Intervall erstellen</h4></div></div></div><p>Sie erstellen einen Intervall wie folgt:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
Wechseln Sie in das Intervall-Verzeichnis: <span class="emphasis"><em>cd /etc/ccollect/defaults/intervals</em></span>.
</li><li>
</li><li class="listitem">
Erstellen Sie einen neuen Intervall mit dem Befehl
"echo <span class="emphasis"><em>wert</em></span> &gt; <span class="emphasis"><em>Intervall-Name</em></span>"
</li></ol></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="_sources"></a>Sources</h3></div></div></div><p>Mit Sourcen meint man bei <span class="emphasis"><em>ccollect</em></span> die Quelldaten. Der Wert einer <span class="emphasis"><em>source</em></span>-Datei
verweist auf einen Pfad in dem sich die zu sichernden Daten befinden.</p><div class="itemizedlist"><p class="title"><b>Im Ordner <span class="emphasis"><em>/etc/ccollect/sources/*</em></span> wird festgelegt:</b></p><ul type="disc"><li>
</li></ol></div></div></div><div class="section" title="Sources"><div class="titlepage"><div><div><h3 class="title"><a name="_sources"></a>Sources</h3></div></div></div><p>Mit Sourcen meint man bei <span class="emphasis"><em>ccollect</em></span> die Quelldaten. Der Wert einer <span class="emphasis"><em>source</em></span>-Datei
verweist auf einen Pfad in dem sich die zu sichernden Daten befinden.</p><div class="itemizedlist" title="Im Ordner /etc/ccollect/sources/* wird festgelegt:"><p class="title"><b>Im Ordner <span class="emphasis"><em>/etc/ccollect/sources/*</em></span> wird festgelegt:</b></p><ul class="itemizedlist" type="disc"><li class="listitem">
Der Sicherungs-Titel
</li><li>
</li><li class="listitem">
Quell- und Ziel-Verzeichnis
</li><li>
</li><li class="listitem">
Spezielle Einstellungen
</li></ul></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="_sicherungs_titel"></a>Sicherungs-Titel</h4></div></div></div><p>Der Sicherungstitel ist der Name eines Ordners in /etc/ccollect/sources.</p><p>Man erstellt also ein neue neue Sicherung mit dem Befehl
</li></ul></div><div class="section" title="Sicherungs-Titel"><div class="titlepage"><div><div><h4 class="title"><a name="_sicherungs_titel"></a>Sicherungs-Titel</h4></div></div></div><p>Der Sicherungstitel ist der Name eines Ordners in /etc/ccollect/sources.</p><p>Man erstellt also ein neue neue Sicherung mit dem Befehl
"mkdir <span class="emphasis"><em>/etc/ccollect/sources/'Sicherungs-Titel</em></span>".
In diesem Verzeichnis folgen dann die spezifischen Konfigurationsdaten
(nur!) für diese Sicherung.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="_quelle"></a>Quelle</h3></div></div></div><p>Mit Quelle ist gemeint welche Daten gesichert werden.
(nur!) für diese Sicherung.</p></div></div><div class="section" title="Quelle"><div class="titlepage"><div><div><h3 class="title"><a name="_quelle"></a>Quelle</h3></div></div></div><p>Mit Quelle ist gemeint welche Daten gesichert werden.
Dies wird in der Konfigurationsdatei <span class="emphasis"><em>source</em></span> festgelegt.</p><p>Diese liegt im Verzeichnis "/etc/ccollect/sources/<span class="emphasis"><em>Sicherungs-Titel</em></span>".
Wechseln Sie in das Verzeichnis mit dem Sicherungs-Titel und erstellen Sie die
Datei mit "echo <span class="emphasis"><em>Quellpfad</em></span> &gt; source".</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="_exclude"></a>Exclude</h4></div></div></div><p>Es kann vorkommen das man in einem Verzeichniss alles sichern will
Datei mit "echo <span class="emphasis"><em>Quellpfad</em></span> &gt; source".</p><div class="section" title="Exclude"><div class="titlepage"><div><div><h4 class="title"><a name="_exclude"></a>Exclude</h4></div></div></div><p>Es kann vorkommen das man in einem Verzeichniss alles sichern will
bis auf ein paar Unterordner.
Für dieses Vorhaben gibt es die Datei <span class="emphasis"><em>exclude</em></span>, die sich wiederum
im Verzeichnis <span class="emphasis"><em>Sicherungs-Titel</em></span> befindet.</p><p>Die Datei wird mit folgenden Schritten angelegt:</p><div class="orderedlist"><ol type="1"><li>
im Verzeichnis <span class="emphasis"><em>Sicherungs-Titel</em></span> befindet.</p><p>Die Datei wird mit folgenden Schritten angelegt:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
"echo 'Quellpfad/verzeichnis1 &gt; exclude"
Ein Pfad wird weggelassen.
</li><li>
</li><li class="listitem">
"echo <span class="emphasis"><em>Quellpfad/verzeichnis2 &gt;&gt; exclude"
Ein weiterer Pfad der weggelassen wird. Das zweite </em></span>&gt;<span class="emphasis"><em> bewirkt,
das an die 'exclude</em></span>-Datei angefügt wird (das einfache <span class="emphasis"><em>&gt;</em></span>
Ein weiterer Pfad der weggelassen wird. Das zweite '&gt;</em></span> bewirkt,
das an die <span class="emphasis"><em>exclude</em></span>-Datei angefügt wird (das einfache <span class="emphasis"><em>&gt;</em></span>
ueberschreibt eine vorhandene Datei).
</li></ol></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="_ziel"></a>Ziel</h3></div></div></div><p>Mit dem Ziel ist gemeint wohin die Sicherung gespeichert wird.
Dies geschieht mit einer Verknüpfung (Link), die <span class="emphasis"><em>destination</em></span> heisst.</p><div class="itemizedlist"><p class="title"><b>Erstellen Sie diese mit den Befehlen</b></p><ul type="disc"><li>
</li></ol></div></div></div><div class="section" title="Ziel"><div class="titlepage"><div><div><h3 class="title"><a name="_ziel"></a>Ziel</h3></div></div></div><p>Mit dem Ziel ist gemeint wohin die Sicherung gespeichert wird.
Dies geschieht mit einer Verknüpfung (Link), die <span class="emphasis"><em>destination</em></span> heisst.</p><div class="itemizedlist" title="Erstellen Sie diese mit den Befehlen"><p class="title"><b>Erstellen Sie diese mit den Befehlen</b></p><ul class="itemizedlist" type="disc"><li class="listitem">
"ln -s <span class="emphasis"><em>/Pfad/zum/Speicherort/</em></span> destination"
</li><li>
</li><li class="listitem">
Mit dem Befehl "ls -l destination" kann man die Richtigkeit der
Verknüpfung überprüfen.
</li></ul></div><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>Es
</li></ul></div><div class="important" title="Important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>Es
darf
immer
nur
@ -99,7 +99,7 @@ und
<span class="emphasis"><em>exclude</em></span>
Datei
vorhanden
sein.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="_spezielles"></a>Spezielles</h3></div></div></div><p>Im Ordner "/etc/ccollect/sources/<span class="emphasis"><em>Sicherung</em></span>" kann man weitere Daten einfügen
sein.</p></div></div><div class="section" title="Spezielles"><div class="titlepage"><div><div><h3 class="title"><a name="_spezielles"></a>Spezielles</h3></div></div></div><p>Im Ordner "/etc/ccollect/sources/<span class="emphasis"><em>Sicherung</em></span>" kann man weitere Daten einfügen
und damit Optionen ein- oder auszuschalten.</p><div class="variablelist"><dl><dt><span class="term">
<span class="emphasis"><em>verbose</em></span>
</span></dt><dd>

195
software/ccollect/doc/ccollect-DE.html
View File

@ -3,7 +3,8 @@
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.2.5" />
<meta name="generator" content="AsciiDoc 8.4.4" />
<title>ccollect- Installieren, Konfigurieren und Anwenden</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@ -26,10 +27,12 @@ a:visited {
em {
font-style: italic;
color: navy;
}
strong {
font-weight: bold;
color: #083194;
}
tt {
@ -71,6 +74,10 @@ p {
margin-bottom: 0.5em;
}
ul, ol, li > p {
margin-top: 0;
}
pre {
padding: 0;
margin: 0;
@ -104,11 +111,13 @@ div#footer-badges {
padding-bottom: 0.5em;
}
div#preamble,
div#preamble {
margin-top: 1.5em;
margin-bottom: 1.5em;
}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@ -123,6 +132,7 @@ div.content { /* Block element content. */
/* Block element titles. */
div.title, caption.title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
text-align: left;
@ -149,22 +159,33 @@ div.sidebarblock > div.content {
padding: 0.5em;
}
div.listingblock {
margin-right: 0%;
}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
padding: 0.5em;
}
div.quoteblock > div.content {
div.quoteblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.attribution {
div.quoteblock > div.attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.verseblock > div.content {
white-space: pre;
}
div.verseblock > div.attribution {
padding-top: 0.75em;
text-align: left;
}
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
@ -187,10 +208,6 @@ div.exampleblock > div.content {
padding: 0.5em;
}
div.verseblock div.content {
white-space: pre;
}
div.imageblock div.content { padding-left: 0; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }
@ -202,18 +219,38 @@ dl {
dt {
margin-top: 0.5em;
margin-bottom: 0;
font-style: italic;
font-style: normal;
color: navy;
}
dd > *:first-child {
margin-top: 0;
margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
div.olist2 ol {
ol.arabic {
list-style-type: decimal;
}
ol.loweralpha {
list-style-type: lower-alpha;
}
ol.upperalpha {
list-style-type: upper-alpha;
}
ol.lowerroman {
list-style-type: lower-roman;
}
ol.upperroman {
list-style-type: upper-roman;
}
div.compact ul, div.compact ol,
div.compact p, div.compact p,
div.compact div, div.compact div {
margin-top: 0.1em;
margin-bottom: 0.1em;
}
div.tableblock > table {
border: 3px solid #527bbd;
@ -225,22 +262,53 @@ thead {
tfoot {
font-weight: bold;
}
td > div.verse {
white-space: pre;
}
p.table {
margin-top: 0;
}
/* Because the table frame attribute is overriden by CSS in most browsers. */
div.tableblock > table[frame="void"] {
border-style: none;
}
div.tableblock > table[frame="hsides"] {
border-left-style: none;
border-right-style: none;
}
div.tableblock > table[frame="vsides"] {
border-top-style: none;
border-bottom-style: none;
}
div.hlist {
div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
div.hlist td {
padding-bottom: 5px;
div.hdlist tr {
padding-bottom: 15px;
}
td.hlist1 {
dt.hdlist1.strong, td.hdlist1.strong {
font-weight: bold;
}
td.hdlist1 {
vertical-align: top;
font-style: italic;
font-style: normal;
padding-right: 0.8em;
color: navy;
}
td.hlist2 {
td.hdlist2 {
vertical-align: top;
}
div.hdlist.compact tr {
margin: 0;
padding-bottom: 0;
}
.comment {
background: yellow;
}
@media print {
div#footer-badges { display: none; }
@ -279,6 +347,7 @@ div.sidebar-content {
padding: 0.5em;
}
div.sidebar-title, div.image-title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
margin-top: 0.0em;
@ -291,8 +360,17 @@ div.listingblock div.content {
padding: 0.5em;
}
div.quoteblock-content {
padding-left: 2.0em;
div.quoteblock-attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock-content {
white-space: pre;
}
div.verseblock-attribution {
padding-top: 0.75em;
text-align: left;
}
div.exampleblock-content {
@ -303,7 +381,6 @@ div.exampleblock-content {
/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
<title>ccollect- Installieren, Konfigurieren und Anwenden</title>
</head>
<body>
<div id="header">
@ -315,7 +392,7 @@ Initiale Version vom 2006-03-04
</div>
<div id="preamble">
<div class="sectionbody">
<div class="para"><p><strong>DIESE ANLEITUNG IST NICHT AKTUELL UND MUSS
<div class="paragraph"><p><strong>DIESE ANLEITUNG IST NICHT AKTUELL UND MUSS
AKTUALISIERT WERDEN (siehe Englische Version)</strong>
inkrementelle Datensicherung
mit <em>hardlinks</em> und <em>rsync</em></p></div>
@ -323,15 +400,15 @@ mit <em>hardlinks</em> und <em>rsync</em></p></div>
</div>
<h2 id="_einleitung">1. Einleitung</h2>
<div class="sectionbody">
<div class="para"><p><strong>DIESE ANLEITUNG IST NICHT AKTUELL UND MUSS
<div class="paragraph"><p><strong>DIESE ANLEITUNG IST NICHT AKTUELL UND MUSS
AKTUALISIERT WERDEN (siehe Englische Version)</strong></p></div>
<div class="para"><p><em>ccollect</em> ist ein Backuptool geschrieben in der sh-skript Programmiersprache.
<div class="paragraph"><p><em>ccollect</em> ist ein Backuptool geschrieben in der sh-skript Programmiersprache.
Es braucht nichts besonderes nur die <em>/bin/sh</em>-Konsole (oder eine kompatible).</p></div>
</div>
<h2 id="_installation">2. Installation</h2>
<div class="sectionbody">
<h3 id="_anforderungen">2.1. Anforderungen</h3><div style="clear:left"></div>
<div class="ilist"><div class="title">Die aufgelisteten Werkzeuge müssen für das Benutzen von ccollect installiert sein:</div><ul>
<div class="ulist"><div class="title">Die aufgelisteten Werkzeuge müssen für das Benutzen von ccollect installiert sein:</div><ul>
<li>
<p>
bc
@ -358,10 +435,10 @@ ssh (optional, wenn man ssh-Verbindungen nutzen moechte)
</p>
</li>
</ul></div>
<div class="para"><p>Am besten überprüfen Sie das mit dem Befehl <em>apt-get install bc rsync ssh</em>.
<div class="paragraph"><p>Am besten überprüfen Sie das mit dem Befehl <em>apt-get install bc rsync ssh</em>.
Beim Fehlen eines Werkzeuges wird dieses nachinstalliert.</p></div>
<h3 id="_installieren">2.2. Installieren</h3><div style="clear:left"></div>
<div class="olist"><ol>
<div class="olist arabic"><ol class="arabic">
<li>
<p>
Laden Sie sich die neuste Version von ccollect herunter.
@ -406,10 +483,10 @@ Starten sie nun zum Testen das Programm ccollect mit dem Befehl
<h2 id="_konfiguration">3. Konfiguration</h2>
<div class="sectionbody">
<h3 id="_konfigurationsverzeichnisse">3.1. Konfigurationsverzeichnisse</h3><div style="clear:left"></div>
<div class="para"><p>Die Konfigurationsdaten befinden sich bei ccollect im oben erstellten Verzeichnis
<div class="paragraph"><p>Die Konfigurationsdaten befinden sich bei ccollect im oben erstellten Verzeichnis
"/etc/ccollect". Um ccollect richtig konfigurieren zu können benötigen Sie
noch ein paar weitere Verzeichnisse:</p></div>
<div class="ilist"><ul>
<div class="ulist"><ul>
<li>
<p>
"/etc/ccollect/defaults" mit:
@ -430,7 +507,7 @@ noch ein paar weitere Verzeichnisse:</p></div>
</li>
</ul></div>
<h3 id="_intervalle">3.2. Intervalle</h3><div style="clear:left"></div>
<div class="para"><p>Der Intervall-Wert definiert, wie viele Backup-Versionen ccollect von
<div class="paragraph"><p>Der Intervall-Wert definiert, wie viele Backup-Versionen ccollect von
den gesicherten Daten behalten soll.
Der Name der Datei, in der der Wert steht, ist zugleich auch der
Name des Intervalls.</p></div>
@ -443,8 +520,8 @@ julian@flumy:/etc/ccollect/defaults/intervals$ cat daily
julian@flumy:/etc/ccollect/defaults/intervals$</tt></pre>
</div></div>
<h4 id="_intervall_erstellen">3.2.1. Intervall erstellen</h4>
<div class="para"><p>Sie erstellen einen Intervall wie folgt:</p></div>
<div class="olist"><ol>
<div class="paragraph"><p>Sie erstellen einen Intervall wie folgt:</p></div>
<div class="olist arabic"><ol class="arabic">
<li>
<p>
Wechseln Sie in das Intervall-Verzeichnis: <em>cd /etc/ccollect/defaults/intervals</em>.
@ -458,9 +535,9 @@ Erstellen Sie einen neuen Intervall mit dem Befehl
</li>
</ol></div>
<h3 id="_sources">3.3. Sources</h3><div style="clear:left"></div>
<div class="para"><p>Mit Sourcen meint man bei <em>ccollect</em> die Quelldaten. Der Wert einer <em>source</em>-Datei
<div class="paragraph"><p>Mit Sourcen meint man bei <em>ccollect</em> die Quelldaten. Der Wert einer <em>source</em>-Datei
verweist auf einen Pfad in dem sich die zu sichernden Daten befinden.</p></div>
<div class="ilist"><div class="title">Im Ordner <em>/etc/ccollect/sources/*</em> wird festgelegt:</div><ul>
<div class="ulist"><div class="title">Im Ordner <em>/etc/ccollect/sources/*</em> wird festgelegt:</div><ul>
<li>
<p>
Der Sicherungs-Titel
@ -478,24 +555,24 @@ Spezielle Einstellungen
</li>
</ul></div>
<h4 id="_sicherungs_titel">3.3.1. Sicherungs-Titel</h4>
<div class="para"><p>Der Sicherungstitel ist der Name eines Ordners in /etc/ccollect/sources.</p></div>
<div class="para"><p>Man erstellt also ein neue neue Sicherung mit dem Befehl
<div class="paragraph"><p>Der Sicherungstitel ist der Name eines Ordners in /etc/ccollect/sources.</p></div>
<div class="paragraph"><p>Man erstellt also ein neue neue Sicherung mit dem Befehl
"mkdir <em>/etc/ccollect/sources/'Sicherungs-Titel</em>".
In diesem Verzeichnis folgen dann die spezifischen Konfigurationsdaten
(nur!) für diese Sicherung.</p></div>
<h3 id="_quelle">3.4. Quelle</h3><div style="clear:left"></div>
<div class="para"><p>Mit Quelle ist gemeint welche Daten gesichert werden.
<div class="paragraph"><p>Mit Quelle ist gemeint welche Daten gesichert werden.
Dies wird in der Konfigurationsdatei <em>source</em> festgelegt.</p></div>
<div class="para"><p>Diese liegt im Verzeichnis "/etc/ccollect/sources/<em>Sicherungs-Titel</em>".
<div class="paragraph"><p>Diese liegt im Verzeichnis "/etc/ccollect/sources/<em>Sicherungs-Titel</em>".
Wechseln Sie in das Verzeichnis mit dem Sicherungs-Titel und erstellen Sie die
Datei mit "echo <em>Quellpfad</em> &gt; source".</p></div>
<h4 id="_exclude">3.4.1. Exclude</h4>
<div class="para"><p>Es kann vorkommen das man in einem Verzeichniss alles sichern will
<div class="paragraph"><p>Es kann vorkommen das man in einem Verzeichniss alles sichern will
bis auf ein paar Unterordner.
Für dieses Vorhaben gibt es die Datei <em>exclude</em>, die sich wiederum
im Verzeichnis <em>Sicherungs-Titel</em> befindet.</p></div>
<div class="para"><p>Die Datei wird mit folgenden Schritten angelegt:</p></div>
<div class="olist"><ol>
<div class="paragraph"><p>Die Datei wird mit folgenden Schritten angelegt:</p></div>
<div class="olist arabic"><ol class="arabic">
<li>
<p>
"echo 'Quellpfad/verzeichnis1 &gt; exclude"
@ -505,16 +582,16 @@ im Verzeichnis <em>Sicherungs-Titel</em> befindet.</p></div>
<li>
<p>
"echo <em>Quellpfad/verzeichnis2 &gt;&gt; exclude"
Ein weiterer Pfad der weggelassen wird. Das zweite </em>&gt;<em> bewirkt,
das an die 'exclude</em>-Datei angefügt wird (das einfache <em>&gt;</em>
Ein weiterer Pfad der weggelassen wird. Das zweite '&gt;</em> bewirkt,
das an die <em>exclude</em>-Datei angefügt wird (das einfache <em>&gt;</em>
ueberschreibt eine vorhandene Datei).
</p>
</li>
</ol></div>
<h3 id="_ziel">3.5. Ziel</h3><div style="clear:left"></div>
<div class="para"><p>Mit dem Ziel ist gemeint wohin die Sicherung gespeichert wird.
<div class="paragraph"><p>Mit dem Ziel ist gemeint wohin die Sicherung gespeichert wird.
Dies geschieht mit einer Verknüpfung (Link), die <em>destination</em> heisst.</p></div>
<div class="ilist"><div class="title">Erstellen Sie diese mit den Befehlen</div><ul>
<div class="ulist"><div class="title">Erstellen Sie diese mit den Befehlen</div><ul>
<li>
<p>
"ln -s <em>/Pfad/zum/Speicherort/</em> destination"
@ -533,7 +610,7 @@ Mit dem Befehl "ls -l destination" kann man die Richtigkeit der
<div class="title">Important</div>
</td>
<td class="content">
<div class="para"><p>Es
<div class="paragraph"><p>Es
darf
immer
nur
@ -549,10 +626,10 @@ sein.</p></div>
</tr></table>
</div>
<h3 id="_spezielles">3.6. Spezielles</h3><div style="clear:left"></div>
<div class="para"><p>Im Ordner "/etc/ccollect/sources/<em>Sicherung</em>" kann man weitere Daten einfügen
<div class="paragraph"><p>Im Ordner "/etc/ccollect/sources/<em>Sicherung</em>" kann man weitere Daten einfügen
und damit Optionen ein- oder auszuschalten.</p></div>
<div class="vlist"><dl>
<dt>
<div class="dlist"><dl>
<dt class="hdlist1">
<em>verbose</em>
</dt>
<dd>
@ -560,7 +637,7 @@ und damit Optionen ein- oder auszuschalten.</p></div>
Beim Sicherungsvorgang ausführlich berichten (<em>-v</em> für <em>rsync</em>).
</p>
</dd>
<dt>
<dt class="hdlist1">
<em>very_verbose</em>
</dt>
<dd>
@ -569,7 +646,7 @@ und damit Optionen ein- oder auszuschalten.</p></div>
(<em>-v</em> für <em>rsync</em>, <em>mkdir</em>, <em>cp</em> und <em>rm</em>).
</p>
</dd>
<dt>
<dt class="hdlist1">
<em>summary</em>
</dt>
<dd>
@ -578,7 +655,7 @@ und damit Optionen ein- oder auszuschalten.</p></div>
Zusammenfassung des Geschehenen.
</p>
</dd>
<dt>
<dt class="hdlist1">
<em>rsync_option</em>
</dt>
<dd>
@ -586,7 +663,7 @@ und damit Optionen ein- oder auszuschalten.</p></div>
Alle Befehle in dieser Datei zu <em>rsync</em> werden ausgeführt beim Sicherungsvorgang.
</p>
</dd>
<dt>
<dt class="hdlist1">
<em>pre_exec</em>
</dt>
<dd>
@ -594,7 +671,7 @@ und damit Optionen ein- oder auszuschalten.</p></div>
Die Befehle im Inhalt dieser Datei werden vor dem Backup ausgeführt.
</p>
</dd>
<dt>
<dt class="hdlist1">
<em>post_exec</em>
</dt>
<dd>
@ -607,7 +684,7 @@ und damit Optionen ein- oder auszuschalten.</p></div>
<div id="footer">
<div id="footer-text">
Version 0.1<br />
Last updated 2008-03-17 18:26:11 CEST
Last updated 2009-07-01 09:53:57 CEST
</div>
</div>
</body>

208
software/ccollect/doc/ccollect.htm
View File

File diff suppressed because one or more lines are too long

366
software/ccollect/doc/ccollect.html
View File

@ -3,7 +3,8 @@
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.2.7" />
<meta name="generator" content="AsciiDoc 8.4.4" />
<title>ccollect - Installing, Configuring and Using</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@ -110,11 +111,13 @@ div#footer-badges {
padding-bottom: 0.5em;
}
div#preamble,
div#preamble {
margin-top: 1.5em;
margin-bottom: 1.5em;
}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@ -156,9 +159,6 @@ div.sidebarblock > div.content {
padding: 0.5em;
}
div.listingblock {
margin-right: 0%;
}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
@ -167,6 +167,7 @@ div.listingblock > div.content {
div.quoteblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.quoteblock > div.attribution {
padding-top: 0.5em;
@ -175,6 +176,7 @@ div.quoteblock > div.attribution {
div.verseblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.verseblock > div.content {
white-space: pre;
@ -218,6 +220,7 @@ dt {
margin-top: 0.5em;
margin-bottom: 0;
font-style: normal;
color: navy;
}
dd > *:first-child {
margin-top: 0.1em;
@ -226,12 +229,28 @@ dd > *:first-child {
ul, ol {
list-style-position: outside;
}
div.olist > ol {
ol.arabic {
list-style-type: decimal;
}
div.olist2 > ol {
ol.loweralpha {
list-style-type: lower-alpha;
}
ol.upperalpha {
list-style-type: upper-alpha;
}
ol.lowerroman {
list-style-type: lower-roman;
}
ol.upperroman {
list-style-type: upper-roman;
}
div.compact ul, div.compact ol,
div.compact p, div.compact p,
div.compact div, div.compact div {
margin-top: 0.1em;
margin-bottom: 0.1em;
}
div.tableblock > table {
border: 3px solid #527bbd;
@ -243,22 +262,53 @@ thead {
tfoot {
font-weight: bold;
}
td > div.verse {
white-space: pre;
}
p.table {
margin-top: 0;
}
/* Because the table frame attribute is overriden by CSS in most browsers. */
div.tableblock > table[frame="void"] {
border-style: none;
}
div.tableblock > table[frame="hsides"] {
border-left-style: none;
border-right-style: none;
}
div.tableblock > table[frame="vsides"] {
border-top-style: none;
border-bottom-style: none;
}
div.hlist {
div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
div.hlist td {
div.hdlist tr {
padding-bottom: 15px;
}
td.hlist1 {
dt.hdlist1.strong, td.hdlist1.strong {
font-weight: bold;
}
td.hdlist1 {
vertical-align: top;
font-style: normal;
padding-right: 0.8em;
color: navy;
}
td.hlist2 {
td.hdlist2 {
vertical-align: top;
}
div.hdlist.compact tr {
margin: 0;
padding-bottom: 0;
}
.comment {
background: yellow;
}
@media print {
div#footer-badges { display: none; }
@ -330,16 +380,7 @@ div.exampleblock-content {
/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
/* Because IE6 child selector is broken. */
div.olist2 ol {
list-style-type: lower-alpha;
}
div.olist2 div.olist ol {
list-style-type: decimal;
}
</style>
<title>ccollect - Installing, Configuring and Using</title>
</head>
<body>
<div id="header">
@ -351,19 +392,19 @@ for ccollect 0.7.1, Initial Version from 2006-01-13
</div>
<div id="preamble">
<div class="sectionbody">
<div class="para"><p>(pseudo) incremental backup
<div class="paragraph"><p>(pseudo) incremental backup
with different exclude lists
using hardlinks and <tt>rsync</tt></p></div>
</div>
</div>
<h2 id="_introduction">1. Introduction</h2>
<div class="sectionbody">
<div class="para"><p><tt>ccollect</tt> is a backup utility written in the sh-scripting language.
<div class="paragraph"><p><tt>ccollect</tt> is a backup utility written in the sh-scripting language.
It does not depend on a specific shell, only <tt>/bin/sh</tt> needs to be
bourne shell compatible (like <em>dash</em>, <em>ksh</em>, <em>zsh</em>, <em>bash</em>, &#8230;).</p></div>
<h3 id="_supported_and_tested_operating_systems_and_architectures">1.1. Supported and tested operating systems and architectures</h3><div style="clear:left"></div>
<div class="para"><p><tt>ccollect</tt> was successfully tested on the following platforms:</p></div>
<div class="ilist"><ul>
<div class="paragraph"><p><tt>ccollect</tt> was successfully tested on the following platforms:</p></div>
<div class="ulist"><ul>
<li>
<p>
GNU/Linux on amd64/hppa/i386/ppc
@ -376,6 +417,11 @@ FreeBSD on amd64/i386
</li>
<li>
<p>
Mac OS X 10.5
</p>
</li>
<li>
<p>
NetBSD on alpha/amd64/i386/sparc/sparc64
</p>
</li>
@ -385,26 +431,26 @@ OpenBSD on amd64
</p>
</li>
</ul></div>
<div class="para"><p>It <strong>should</strong> run on any Unix that supports <tt>rsync</tt> and has a POSIX-compatible
<div class="paragraph"><p>It <strong>should</strong> run on any Unix that supports <tt>rsync</tt> and has a POSIX-compatible
bourne shell. If your platform is not listed above and you have it successfully
running, please drop me a mail.</p></div>
<h3 id="_why_you_could_only_backup_from_remote_hosts_not_to_them">1.2. Why you COULD only backup from remote hosts, not to them</h3><div style="clear:left"></div>
<div class="para"><p>While considering the design of ccollect, I thought about enabling
<div class="paragraph"><p>While considering the design of ccollect, I thought about enabling
backup to <strong>remote</strong> hosts. Though this sounds like a nice feature
(<em>Backup my notebook to the server now.</em>), in my opinion it is a
bad idea to backup to a remote host.</p></div>
<div class="para"><p>But as more and more people requested this feature, it was implemented,
<div class="paragraph"><p>But as more and more people requested this feature, it was implemented,
so you have the choice whether you want to use it or not.</p></div>
<h4 id="_reason">1.2.1. Reason</h4>
<div class="para"><p>If you want to backup <strong>TO</strong> a remote host, you have to loosen security on it.</p></div>
<div class="para"><p>Imagine the following situation: You backup your farm of webservers <strong>TO</strong>
<div class="paragraph"><p>If you want to backup <strong>TO</strong> a remote host, you have to loosen security on it.</p></div>
<div class="paragraph"><p>Imagine the following situation: You backup your farm of webservers <strong>TO</strong>
a backup host somewhere else.
Now one of your webservers which has access to your backup host gets
compromised.</p></div>
<div class="para"><p>Your backup server will be compromised, too.</p></div>
<div class="para"><p>And the attacker will have access to all data on the other webservers.</p></div>
<div class="paragraph"><p>Your backup server will be compromised, too.</p></div>
<div class="paragraph"><p>And the attacker will have access to all data on the other webservers.</p></div>
<h4 id="_doing_it_securely">1.2.2. Doing it securely</h4>
<div class="para"><p>Think of it the other way round: The backup server (now behind a
<div class="paragraph"><p>Think of it the other way round: The backup server (now behind a
firewall, not accessable from outside) connects to the
webservers and pulls the data <strong>from</strong> them. If someone gets access to one
of the webservers, this person will perhaps not even see your machine. If
@ -413,7 +459,7 @@ machine, she will not be able to log in on the backup machine.
All other backups are still secure.</p></div>
<h3 id="_incompatibilities">1.3. Incompatibilities</h3><div style="clear:left"></div>
<h4 id="_versions_0_6_and_0_7">1.3.1. Versions 0.6 and 0.7</h4>
<div class="ilist"><div class="title">The format of <tt>destination</tt> changed:</div><ul>
<div class="ulist"><div class="title">The format of <tt>destination</tt> changed:</div><ul>
<li>
<p>
Before 0.7 it was a (link to a) directory
@ -425,8 +471,8 @@ As of 0.7 it is a textfile containing the destination
</p>
</li>
</ul></div>
<div class="para"><p>You can update your configuration using <tt>tools/config-pre-0.7-to-0.7.sh</tt>.</p></div>
<div class="ilist"><div class="title">Added <em>remote_host</em></div><ul>
<div class="paragraph"><p>You can update your configuration using <tt>tools/config-pre-0.7-to-0.7.sh</tt>.</p></div>
<div class="ulist"><div class="title">Added <em>remote_host</em></div><ul>
<li>
<p>
As of 0.7 it is possible to backup <strong>to</strong> hosts (see section remote_host below).
@ -434,7 +480,7 @@ As of 0.7 it is possible to backup <strong>to</strong> hosts (see section remote
</li>
</ul></div>
<h4 id="_versions_0_5_and_0_6">1.3.2. Versions 0.5 and 0.6</h4>
<div class="ilist"><div class="title">The format of <tt>rsync_options</tt> changed:</div><ul>
<div class="ulist"><div class="title">The format of <tt>rsync_options</tt> changed:</div><ul>
<li>
<p>
Before 0.6 it was whitespace delimeted
@ -446,8 +492,8 @@ As of 0.6 it is newline seperated (so you can pass whitespaces to <tt>rsync</tt>
</p>
</li>
</ul></div>
<div class="para"><p>You can update your configuration using <tt>tools/config-pre-0.6-to-0.6.sh</tt>.</p></div>
<div class="ilist"><div class="title">The name of the backup directories changed:</div><ul>
<div class="paragraph"><p>You can update your configuration using <tt>tools/config-pre-0.6-to-0.6.sh</tt>.</p></div>
<div class="ulist"><div class="title">The name of the backup directories changed:</div><ul>
<li>
<p>
Before 0.6: "date +%Y-%m-%d-%H%M"
@ -459,11 +505,11 @@ As of 0.6: "date +%Y%m%d-%H%M" (better readable, date is closer together)
</p>
</li>
</ul></div>
<div class="para"><p>For the second change there is no updated needed, as XXXX- is always before
<div class="paragraph"><p>For the second change there is no updated needed, as XXXX- is always before
XXXXX (- comes before digit).</p></div>
<h4 id="_versions_0_4_and_0_5">1.3.3. Versions 0.4 and 0.5</h4>
<div class="para"><p>Not a real incompatibilty, but seems to fit in this section:</p></div>
<div class="ilist"><div class="title">0.5 does <strong>NOT</strong> require</div><ul>
<div class="paragraph"><p>Not a real incompatibilty, but seems to fit in this section:</p></div>
<div class="ulist"><div class="title">0.5 does <strong>NOT</strong> require</div><ul>
<li>
<p>
PaX
@ -475,11 +521,11 @@ bc
</p>
</li>
</ul></div>
<div class="para"><p>anymore!</p></div>
<div class="paragraph"><p>anymore!</p></div>
<h4 id="_versions_lt_0_4_and_0_4">1.3.4. Versions &lt; 0.4 and 0.4</h4>
<div class="para"><p>Since <tt>ccollect</tt> 0.4 there are several incompatibilities with earlier
<div class="paragraph"><p>Since <tt>ccollect</tt> 0.4 there are several incompatibilities with earlier
versions:</p></div>
<div class="ilist"><div class="title">List of incompatibilities</div><ul>
<div class="ulist"><div class="title">List of incompatibilities</div><ul>
<li>
<p>
<tt>pax</tt> (Posix) is now required, <tt>cp -al</tt> (GNU specific) is removed
@ -506,7 +552,7 @@ ccollect now reports when postexec returns non-zero
</p>
</li>
</ul></div>
<div class="para"><p>You can convert your old configuration directory using
<div class="paragraph"><p>You can convert your old configuration directory using
<tt>config-pre-0.4-to-0.4.sh</tt>, which can be found in the <strong>tools/</strong>
subdirectory:</p></div>
<div class="listingblock">
@ -516,10 +562,10 @@ subdirectory:</p></div>
</div>
<h2 id="_quick_start">2. Quick start</h2>
<div class="sectionbody">
<div class="para"><p>For those who do not want to read the whole long document:</p></div>
<div class="paragraph"><p>For those who do not want to read the whole long document:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt># get latest ccollect tarball from http://unix.schottelius.org/ccollect/
<pre><tt># get latest ccollect tarball from http://www.nico.schottelius.org/software/ccollect/
# replace value for CCV with the current version
export CCV=0.7.1
@ -527,7 +573,7 @@ export CCV=0.7.1
# replace 'wget' with 'fetch' on bsd
#
holen=wget
"$holen" http://unix.schottelius.org/ccollect/ccollect-${CCV}.tar.bz2
"$holen" http://www.nico.schottelius.org/software/ccollect/ccollect-${CCV}.tar.bz2
# extract the tarball, change to the newly created directory
tar -xvjf ccollect-${CCV}.tar.bz2
@ -578,18 +624,18 @@ du -s ~/DASI /bin
# report success
echo "Please report success using ./tools/report_success.sh"</tt></pre>
</div></div>
<div class="para"><p>Cutting and pasting the complete section above to your shell will result in
<div class="paragraph"><p>Cutting and pasting the complete section above to your shell will result in
the download of ccollect, the creation of a sample configuration and the
execution of some backups.</p></div>
</div>
<h2 id="_requirements">3. Requirements</h2>
<div class="sectionbody">
<h3 id="_installing_ccollect">3.1. Installing ccollect</h3><div style="clear:left"></div>
<div class="para"><p>For the installation you need at least</p></div>
<div class="ilist"><ul>
<div class="paragraph"><p>For the installation you need at least</p></div>
<div class="ulist"><ul>
<li>
<p>
the latest ccollect package (<a href="http://unix.schottelius.org/ccollect/">http://unix.schottelius.org/ccollect/</a>)
the latest ccollect package (<a href="http://www.nico.schottelius.org/software/ccollect/">http://www.nico.schottelius.org/software/ccollect/</a>)
</p>
</li>
<li>
@ -609,7 +655,7 @@ for rebuilding the generated documentation: additionally <tt>asciidoc</tt>
</li>
</ul></div>
<h3 id="_using_ccollect">3.2. Using ccollect</h3><div style="clear:left"></div>
<div class="ilist"><div class="title">Running ccollect requires the following tools to be installed:</div><ul>
<div class="ulist"><div class="title">Running ccollect requires the following tools to be installed:</div><ul>
<li>
<p>
<tt>date</tt>
@ -629,11 +675,11 @@ for rebuilding the generated documentation: additionally <tt>asciidoc</tt>
</div>
<h2 id="_installing">4. Installing</h2>
<div class="sectionbody">
<div class="para"><p>Either type <em>make install</em> or simply copy it to a directory in your
<div class="paragraph"><p>Either type <em>make install</em> or simply copy it to a directory in your
$PATH and execute <em>chmod <strong>0755</strong> /path/to/ccollect.sh</em>. If you would
like to use the new management scripts (available since 0.6), copy
the following scripts to a directory in $PATH:</p></div>
<div class="ilist"><ul>
<div class="ulist"><ul>
<li>
<p>
<tt>tools/ccollect_add_source.sh</tt>
@ -660,16 +706,16 @@ the following scripts to a directory in $PATH:</p></div>
</p>
</li>
</ul></div>
<div class="para"><p>After having installed and used ccollect, report success using
<div class="paragraph"><p>After having installed and used ccollect, report success using
<em>./tools/report_success.sh</em>.</p></div>
</div>
<h2 id="_configuring">5. Configuring</h2>
<div class="sectionbody">
<div class="para"><p>For configuration aid have a look at the above mentioned tools, which can assist
<div class="paragraph"><p>For configuration aid have a look at the above mentioned tools, which can assist
you quite well. When you are successfully using <tt>ccollect</tt>, report success using
<tt>tools/report_success.sh</tt>.</p></div>
<h3 id="_runtime_options">5.1. Runtime options</h3><div style="clear:left"></div>
<div class="para"><p><tt>ccollect</tt> looks for its configuration in <em>/etc/ccollect</em> or, if set, in
<div class="paragraph"><p><tt>ccollect</tt> looks for its configuration in <em>/etc/ccollect</em> or, if set, in
the directory specified by the variable <em>$CCOLLECT_CONF</em>:</p></div>
<div class="listingblock">
<div class="content">
@ -679,26 +725,26 @@ $ CCOLLECT_CONF=/your/config/dir ccollect.sh ...
# csh
$ ( setenv CCOLLECT_CONF /your/config/dir ; ccollect.sh ... )</tt></pre>
</div></div>
<div class="para"><p>When you start <tt>ccollect</tt>, you have to specify in which interval
<div class="paragraph"><p>When you start <tt>ccollect</tt>, you have to specify in which interval
to backup (daily, weekly, yearly; you can specify the names yourself, see below)
and which sources to backup (or -a to backup all sources).</p></div>
<div class="para"><p>The interval specifies how many backups are kept.</p></div>
<div class="para"><p>There are also some self-explanatory parameters you can pass to ccollect,
simply use <tt>ccollect.sh &#8212;help</tt> for info.</p></div>
<div class="paragraph"><p>The interval specifies how many backups are kept.</p></div>
<div class="paragraph"><p>There are also some self-explanatory parameters you can pass to ccollect,
simply use <tt>ccollect.sh --help</tt> for info.</p></div>
<h3 id="_general_configuration">5.2. General configuration</h3><div style="clear:left"></div>
<div class="para"><p>The general configuration can be found in $CCOLLECT_CONF/defaults or
<div class="paragraph"><p>The general configuration can be found in $CCOLLECT_CONF/defaults or
/etc/ccollect/defaults. All options specified there are generally valid for
all source definitions, although the values can be overwritten in the source
configuration.</p></div>
<div class="para"><p>All configuration entries are plain-text files (use UTF-8 for non-ascii characters).</p></div>
<div class="paragraph"><p>All configuration entries are plain-text files (use UTF-8 for non-ascii characters).</p></div>
<h4 id="_interval_definition">5.2.1. Interval definition</h4>
<div class="para"><p>The interval definition can be found in
<div class="paragraph"><p>The interval definition can be found in
<em>$CCOLLECT_CONF/defaults/intervals/</em> or <em>/etc/ccollect/defaults/intervals</em>.
Each file in this directory specifies an interval. The name of the file is
the same as the name of the interval: <tt>intervals/<em>&lt;interval name&gt;</em></tt>.</p></div>
<div class="para"><p>The content of this file should be a single line containing a number.
the same as the name of the interval: <tt>intervals/'&lt;interval name&gt;'</tt>.</p></div>
<div class="paragraph"><p>The content of this file should be a single line containing a number.
This number defines how many versions of this interval are kept.</p></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> [10:23] zaphodbeeblebrox:ccollect-0.2% ls -l conf/defaults/intervals/
@ -711,13 +757,13 @@ This number defines how many versions of this interval are kept.</p></div>
12
4</tt></pre>
</div></div>
<div class="para"><p>This means to keep 28 daily backups, 12 monthly backups and 4 weekly.</p></div>
<div class="paragraph"><p>This means to keep 28 daily backups, 12 monthly backups and 4 weekly.</p></div>
<h4 id="_general_pre_and_post_execution">5.2.2. General pre- and post-execution</h4>
<div class="para"><p>If you add <em>$CCOLLECT_CONF/defaults/<tt>pre_exec</tt></em> or
<div class="paragraph"><p>If you add <em>$CCOLLECT_CONF/defaults/<tt>pre_exec</tt></em> or
<em>/etc/ccollect/defaults/<tt>pre_exec</tt></em> (same with <tt>post_exec</tt>), <tt>ccollect</tt>
will start <tt>pre_exec</tt> before the whole backup process and
<tt>post_exec</tt> after backup of all sources is done.</p></div>
<div class="para"><p>The following example describes how to report free disk space in
<div class="paragraph"><p>The following example describes how to report free disk space in
human readable format before and after the whole backup process:</p></div>
<div class="listingblock">
<div class="content">
@ -729,15 +775,15 @@ human readable format before and after the whole backup process:</p></div>
[13:01] hydrogenium:~# ln -s /etc/ccollect/defaults/pre_exec /etc/ccollect/defaults/post_exec</tt></pre>
</div></div>
<h4 id="_general_delete_incomplete">5.2.3. General delete_incomplete</h4>
<div class="para"><p>If you add <em>$CCOLLECT_CONF/defaults/<tt>delete_incomplete</tt></em>, this
<div class="paragraph"><p>If you add <em>$CCOLLECT_CONF/defaults/<tt>delete_incomplete</tt></em>, this
option applies for all sources. See below for a longer
explanation.</p></div>
<h3 id="_source_configuration">5.3. Source configuration</h3><div style="clear:left"></div>
<div class="para"><p>Each source configuration exists in <em>$CCOLLECT_CONF/sources/$name</em> or
<div class="paragraph"><p>Each source configuration exists in <em>$CCOLLECT_CONF/sources/$name</em> or
<em>/etc/ccollect/sources/$name</em>.</p></div>
<div class="para"><p>The name you choose for the subdirectory describes the source.</p></div>
<div class="para"><p>Each source contains at least the following files:</p></div>
<div class="ilist"><ul>
<div class="paragraph"><p>The name you choose for the subdirectory describes the source.</p></div>
<div class="paragraph"><p>Each source contains at least the following files:</p></div>
<div class="ulist"><ul>
<li>
<p>
<tt>source</tt> (a text file containing the <tt>rsync</tt> compatible path to backup)
@ -749,8 +795,8 @@ explanation.</p></div>
</p>
</li>
</ul></div>
<div class="para"><p>Additionally a source may have the following files:</p></div>
<div class="ilist"><ul>
<div class="paragraph"><p>Additionally a source may have the following files:</p></div>
<div class="ulist"><ul>
<li>
<p>
<tt>verbose</tt> whether to be verbose (passes -v to <tt>rsync</tt>)
@ -797,7 +843,7 @@ explanation.</p></div>
</p>
</li>
</ul></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> [10:47] zaphodbeeblebrox:ccollect-0.2% ls -l conf/sources/testsource2
@ -819,56 +865,56 @@ explanation.</p></div>
/home/nico/vpn</tt></pre>
</div></div>
<h4 id="_detailed_description_of_source">5.3.1. Detailed description of "source"</h4>
<div class="para"><p><tt>source</tt> describes a <tt>rsync</tt> compatible source (one line only).</p></div>
<div class="para"><p>For instance <em>backup_user@foreign_host:/home/server/video</em>.
<div class="paragraph"><p><tt>source</tt> describes a <tt>rsync</tt> compatible source (one line only).</p></div>
<div class="paragraph"><p>For instance <em>backup_user@foreign_host:/home/server/video</em>.
To use the <tt>rsync</tt> protocol without the <tt>ssh</tt>-tunnel, use
<em>rsync::USER@HOST/SRC</em>. For more information have a look at the manpage
of <tt>rsync</tt>(1).</p></div>
<h4 id="_detailed_description_of_destination">5.3.2. Detailed description of "destination"</h4>
<div class="para"><p><tt>destination</tt> must be a text file containing the destination directory.
<div class="paragraph"><p><tt>destination</tt> must be a text file containing the destination directory.
<tt>destination</tt> <strong>USED</strong> to be a link to the destination directory in
earlier versions, so do not be confused if you see such examples.</p></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> [11:36] zaphodbeeblebrox:ccollect-0.2% cat conf/sources/testsource2/destination
/home/nico/backupdir</tt></pre>
</div></div>
<h4 id="_detailed_description_of_remote_host">5.3.3. Detailed description of "remote_host"</h4>
<div class="para"><p><tt>remote_host</tt> must be a text file containing the destination host.
<div class="paragraph"><p><tt>remote_host</tt> must be a text file containing the destination host.
If this file is existing, you are backing up your data <strong>TO</strong> this host
and <strong>not</strong> to you local host.</p></div>
<div class="para"><p><strong>Warning</strong>: You need to have <tt>ssh</tt> access to the remote host. <tt>rsync</tt> and
<div class="paragraph"><p><strong>Warning</strong>: You need to have <tt>ssh</tt> access to the remote host. <tt>rsync</tt> and
<tt>ccollect</tt> will connect to that host via <tt>ssh</tt>. <tt>ccollect</tt> needs the shell
access, because it needs to find out how many backups exist on the remote
host and to be able to delete them.</p></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> [10:17] denkbrett:ccollect-0.7.0% cat conf/sources/remote1/remote_host
home.schottelius.org</tt></pre>
</div></div>
<div class="para"><p>It may contain all the ssh-specific values like <em>myuser@yourhost.ch</em>.</p></div>
<div class="paragraph"><p>It may contain all the ssh-specific values like <em>myuser@yourhost.ch</em>.</p></div>
<h4 id="_detailed_description_of_verbose">5.3.4. Detailed description of "verbose"</h4>
<div class="para"><p><tt>verbose</tt> tells <tt>ccollect</tt> that the log should contain verbose messages.</p></div>
<div class="para"><p>If this file exists in the source specification <strong>-v</strong> will be passed to <tt>rsync</tt>.</p></div>
<div class="para"><p>`
<div class="paragraph"><p><tt>verbose</tt> tells <tt>ccollect</tt> that the log should contain verbose messages.</p></div>
<div class="paragraph"><p>If this file exists in the source specification <strong>-v</strong> will be passed to <tt>rsync</tt>.</p></div>
<div class="paragraph"><p>`
Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> [11:35] zaphodbeeblebrox:ccollect-0.2% touch conf/sources/testsource1/verbose</tt></pre>
</div></div>
<h4 id="_detailed_description_of_very_verbose">5.3.5. Detailed description of "very_verbose"</h4>
<div class="para"><p><tt>very_verbose</tt> tells <tt>ccollect</tt> that it should log very verbosely.</p></div>
<div class="para"><p>If this file exists in the source specification <strong>-v</strong> will be passed to
<div class="paragraph"><p><tt>very_verbose</tt> tells <tt>ccollect</tt> that it should log very verbosely.</p></div>
<div class="paragraph"><p>If this file exists in the source specification <strong>-v</strong> will be passed to
<tt>rsync</tt>, <tt>rm</tt> and <tt>mkdir</tt>.</p></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> [23:67] nohost:~% touch conf/sources/testsource1/very_verbose</tt></pre>
</div></div>
<h4 id="_detailed_description_of_summary">5.3.6. Detailed description of "summary"</h4>
<div class="para"><p>If you create the file <tt>summary</tt> in the source definition,
<div class="paragraph"><p>If you create the file <tt>summary</tt> in the source definition,
<tt>ccollect</tt> will present you a nice summary at the end.</p></div>
<div class="listingblock">
<div class="content">
@ -898,12 +944,12 @@ backup:~# ccollect.sh werktags root
[root] Successfully finished backup.
==&gt; Finished ccollect.sh &lt;==</tt></pre>
</div></div>
<div class="para"><p>You could also combine it with <tt>verbose</tt> or <tt>very_verbose</tt>, but these
<div class="paragraph"><p>You could also combine it with <tt>verbose</tt> or <tt>very_verbose</tt>, but these
already print some statistics (though not all / the same as presented by
<tt>summary</tt>).</p></div>
<h4 id="_detailed_description_of_exclude">5.3.7. Detailed description of "exclude"</h4>
<div class="para"><p><tt>exclude</tt> specifies a list of paths to exclude. The entries are seperated by a newline (\n).</p></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p><tt>exclude</tt> specifies a list of paths to exclude. The entries are seperated by a newline (\n).</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> [11:35] zaphodbeeblebrox:ccollect-0.2% cat conf/sources/testsource2/exclude
@ -913,10 +959,10 @@ already print some statistics (though not all / the same as presented by
something with spaces is not a problem</tt></pre>
</div></div>
<h4 id="_detailed_description_of_intervals">5.3.8. Detailed description of "intervals/"</h4>
<div class="para"><p>When you create the subdirectory <tt>intervals/</tt> in your source configuration
<div class="paragraph"><p>When you create the subdirectory <tt>intervals/</tt> in your source configuration
directory, you can specify individiual intervals for this specific source.
Each file in this directory describes an interval.</p></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> [11:37] zaphodbeeblebrox:ccollect-0.2% ls -l conf/sources/testsource2/intervals/
@ -928,24 +974,24 @@ Each file in this directory describes an interval.</p></div>
20</tt></pre>
</div></div>
<h4 id="_detailled_description_of_rsync_options">5.3.9. Detailled description of "rsync_options"</h4>
<div class="para"><p>When you create the file <tt>rsync_options</tt> in your source configuration,
<div class="paragraph"><p>When you create the file <tt>rsync_options</tt> in your source configuration,
all the parameters in this file will be passed to rsync. This
way you can pass additional options to rsync. For instance you can tell rsync
to show progress ("&#8212;progress"), or which -password-file ("&#8212;password-file")
to show progress ("--progress"), or which -password-file ("--password-file")
to use for automatic backup over the rsync-protocol.</p></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> [23:42] hydrogenium:ccollect-0.2% cat conf/sources/test_rsync/rsync_options
--password-file=/home/user/backup/protected_password_file</tt></pre>
</div></div>
<h4 id="_detailled_description_of_pre_exec_and_post_exec">5.3.10. Detailled description of "pre_exec" and "post_exec"</h4>
<div class="para"><p>When you create <tt>pre_exec</tt> and / or <tt>post_exec</tt> in your source
<div class="paragraph"><p>When you create <tt>pre_exec</tt> and / or <tt>post_exec</tt> in your source
configuration, <tt>ccollect</tt> will execute this command before and
respectively after doing the backup for <strong>this specific</strong> source.
If you want to have pre-/post-exec before and after <strong>all</strong>
backups, see above for general configuration.</p></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>[13:09] hydrogenium:ccollect-0.3% cat conf/sources/with_exec/pre_exec
@ -960,7 +1006,7 @@ df -h
df -h</tt></pre>
</div></div>
<h4 id="_detailed_description_of_delete_incomplete">5.3.11. Detailed description of "delete_incomplete"</h4>
<div class="para"><p>If you create the file <tt>delete_incomplete</tt> in a source specification directory,
<div class="paragraph"><p>If you create the file <tt>delete_incomplete</tt> in a source specification directory,
<tt>ccollect</tt> will look for incomplete backups (when the whole <tt>ccollect</tt> process
was interrupted) and remove them. Without this file <tt>ccollect</tt> will only warn
the user.</p></div>
@ -968,7 +1014,7 @@ the user.</p></div>
<h2 id="_hints">6. Hints</h2>
<div class="sectionbody">
<h3 id="_smart_logging">6.1. Smart logging</h3><div style="clear:left"></div>
<div class="para"><p>Since ccollect-0.6.1 you can use the ccollect-logwrapper.sh(1) for logging.
<div class="paragraph"><p>Since ccollect-0.6.1 you can use the ccollect-logwrapper.sh(1) for logging.
You call it the same way you call ccollect.sh and it will create a
logfile containing the output of ccollect.sh. For more information look
at the manpage <em>ccollect-logwrapper</em>. The following is an example running
@ -980,13 +1026,13 @@ ccollect-logwrapper.sh (11722): Starting with arguments: daily u0160.nshq.ch.net
ccollect-logwrapper.sh (11722): Finished.</tt></pre>
</div></div>
<h3 id="_using_a_different_ssh_port">6.2. Using a different ssh port</h3><div style="clear:left"></div>
<div class="para"><p>Mostly easy is to use your ~/.ssh/config file:</p></div>
<div class="paragraph"><p>Mostly easy is to use your ~/.ssh/config file:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>host mx2.schottelius.org
Port 2342</tt></pre>
</div></div>
<div class="para"><p>If you only use that port for backup only and normally want to use another port,
<div class="paragraph"><p>If you only use that port for backup only and normally want to use another port,
you can add <em>HostName</em> and "HostKeyAlias" (if you also have different
keys on the different ports):</p></div>
<div class="listingblock">
@ -1002,8 +1048,8 @@ Host bruehe
HostKeyAlias bruehe.schottelius.org</tt></pre>
</div></div>
<h3 id="_using_source_names_or_interval_in_pre_post_exec_scripts">6.3. Using source names or interval in pre_/post_exec scripts</h3><div style="clear:left"></div>
<div class="para"><p>The pre-/post_exec scripts can access some internal variables from <tt>ccollect</tt>:</p></div>
<div class="ilist"><ul>
<div class="paragraph"><p>The pre-/post_exec scripts can access some internal variables from <tt>ccollect</tt>:</p></div>
<div class="ulist"><ul>
<li>
<p>
INTERVAL: The interval specified on the command line
@ -1027,11 +1073,11 @@ name: the name of the currently being backuped source (not available for
</li>
</ul></div>
<h3 id="_using_rsync_protocol_without_ssh">6.4. Using rsync protocol without ssh</h3><div style="clear:left"></div>
<div class="para"><p>When you have a computer with little computing power, it may be useful to use
<div class="paragraph"><p>When you have a computer with little computing power, it may be useful to use
rsync without ssh, directly using the rsync protocol
(specify <em>user@host::share</em> in <tt>source</tt>). You may wish to use
<tt>rsync_options</tt> to specify a password file to use for automatic backup.</p></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>backup:~# cat /etc/ccollect/sources/sample.backup.host.org/source
@ -1043,10 +1089,10 @@ backup:~# cat /etc/ccollect/sources/sample.backup.host.org/rsync_options
backup:~# cat /etc/ccollect/sources/sample.backup.host.org/rsync_password
this_is_the_rsync_password</tt></pre>
</div></div>
<div class="para"><p>This hint was reported by Daniel Aubry.</p></div>
<div class="paragraph"><p>This hint was reported by Daniel Aubry.</p></div>
<h3 id="_not_excluding_top_level_directories">6.5. Not excluding top-level directories</h3><div style="clear:left"></div>
<div class="para"><p>When you exclude "/proc" or "/mnt" from your backup, you may run into
trouble when you restore your backup. When you use "/proc/*" or "/mnt/*"
<div class="paragraph"><p>When you exclude "/proc" or "/mnt" from your backup, you may run into
trouble when you restore your backup. When you use "/proc/*" or "/mnt/\*"
instead, <tt>ccollect</tt> will backup empty directories.</p></div>
<div class="admonitionblock">
<table><tr>
@ -1054,19 +1100,19 @@ instead, <tt>ccollect</tt> will backup empty directories.</p></div>
<div class="title">Note</div>
</td>
<td class="content">
<div class="para"><p>When those directories contain hidden files
<div class="paragraph"><p>When those directories contain hidden files
(those beginning with a dot (<strong>.</strong>)),
they will still be transferred!</p></div>
</td>
</tr></table>
</div>
<div class="para"><p>This hint was reported by Marcus Wagner.</p></div>
<div class="paragraph"><p>This hint was reported by Marcus Wagner.</p></div>
<h3 id="_re_using_already_created_rsync_backups">6.6. Re-using already created rsync-backups</h3><div style="clear:left"></div>
<div class="para"><p>If you used <tt>rsync</tt> directly before you use <tt>ccollect</tt>, you can
<div class="paragraph"><p>If you used <tt>rsync</tt> directly before you use <tt>ccollect</tt>, you can
use this old backup as initial backup for <tt>ccollect</tt>: You
simply move it into a directory below the destination directory
and name it "<em>interval</em>.0".</p></div>
<div class="para"><p>Example:</p></div>
<div class="paragraph"><p>Example:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>backup:/home/backup/web1# ls
@ -1081,14 +1127,14 @@ backup:/home/backup/web1# mv * daily.0 2&gt;/dev/null
backup:/home/backup/web1# ls
daily.0</tt></pre>
</div></div>
<div class="para"><p>Now you can use /home/backup/web1 as the <tt>destination</tt> for the backup.</p></div>
<div class="paragraph"><p>Now you can use /home/backup/web1 as the <tt>destination</tt> for the backup.</p></div>
<div class="admonitionblock">
<table><tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
<div class="para"><p>It does not matter anymore how you name your directory, as <tt>ccollect</tt> uses
<div class="paragraph"><p>It does not matter anymore how you name your directory, as <tt>ccollect</tt> uses
the -c option from <tt>ls</tt> to find out which directory to clone from.</p></div>
</td>
</tr></table>
@ -1099,7 +1145,7 @@ the -c option from <tt>ls</tt> to find out which directory to clone from.</p></d
<div class="title">Note</div>
</td>
<td class="content">
<div class="para"><p>Older versions (pre 0.6, iirc) had a problem, if you named the first backup
<div class="paragraph"><p>Older versions (pre 0.6, iirc) had a problem, if you named the first backup
something like "daily.initial". It was needed to use the "<strong>0</strong>" (or some
number that is lower than the current year) as extension. <tt>ccollect</tt>
used <tt>sort</tt> to find the latest backup. <tt>ccollect</tt> itself uses
@ -1113,9 +1159,9 @@ wasted resources, but your backup had beer complete anyway.</p></div>
</tr></table>
</div>
<h3 id="_using_pre_post_exec">6.7. Using pre_/post_exec</h3><div style="clear:left"></div>
<div class="para"><p>Your pre_/post_exec script does not need to be a script, you can also
<div class="paragraph"><p>Your pre_/post_exec script does not need to be a script, you can also
use a link to</p></div>
<div class="ilist"><ul>
<div class="ulist"><ul>
<li>
<p>
an existing program
@ -1127,40 +1173,40 @@ an already written script
</p>
</li>
</ul></div>
<div class="para"><p>The only requirement is that it is executable.</p></div>
<div class="paragraph"><p>The only requirement is that it is executable.</p></div>
<h3 id="_using_source_specific_interval_definitions">6.8. Using source specific interval definitions</h3><div style="clear:left"></div>
<div class="para"><p>When you are backing up multiple hosts via cron each night, it may be
<div class="paragraph"><p>When you are backing up multiple hosts via cron each night, it may be
a problem that host "big_server" may only have 4 daily backups, because
otherwise its backup device will be full. But for all other hosts
you want to keep 20 daily backups. In this case you would create
<tt>/etc/ccollect/default/intervals/daily</tt> containing "20" and
<tt>/etc/ccollect/sources/big_server/intervals/daily</tt> containing "4".</p></div>
<div class="para"><p>Source specific intervals always overwrite the default values.
<div class="paragraph"><p>Source specific intervals always overwrite the default values.
If you have to specify it individually for every host, because
of different requirements, you can even omit creating
<tt>/etc/ccollect/default/intervals/daily</tt>.</p></div>
<h3 id="_comparing_backups">6.9. Comparing backups</h3><div style="clear:left"></div>
<div class="para"><p>If you want to see what changed between two backups, you can use
<div class="paragraph"><p>If you want to see what changed between two backups, you can use
<tt>rsync</tt> directly:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>[12:00] u0255:ddba034.netstream.ch# rsync -n -a --delete --stats --progress daily.20080324-0313.17841/ daily.20080325-0313.31148/</tt></pre>
</div></div>
<div class="para"><p>This results in a listing of changes. Because we pass -n to rsync no transfer
<div class="paragraph"><p>This results in a listing of changes. Because we pass -n to rsync no transfer
is made (i.e. report only mode)"</p></div>
<div class="para"><p>This hint was reported by Daniel Aubry.</p></div>
<div class="paragraph"><p>This hint was reported by Daniel Aubry.</p></div>
<h3 id="_testing_for_host_reachabilty">6.10. Testing for host reachabilty</h3><div style="clear:left"></div>
<div class="para"><p>If you want to test whether the host you try to backup is reachable, you can use
<div class="paragraph"><p>If you want to test whether the host you try to backup is reachable, you can use
the following script as source specific pre-exec:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>#!/bin/sh
# ping -c1 -q `cat "/etc/ccollect/sources/$name/source" | cut -d"@" -f2 | cut -d":" -f1`</tt></pre>
</div></div>
<div class="para"><p>This prevents the deletion of old backups, if the host is not reachable.</p></div>
<div class="para"><p>This hint was reported by Daniel Aubry.</p></div>
<div class="paragraph"><p>This prevents the deletion of old backups, if the host is not reachable.</p></div>
<div class="paragraph"><p>This hint was reported by Daniel Aubry.</p></div>
<h3 id="_easy_check_for_errors">6.11. Easy check for errors</h3><div style="clear:left"></div>
<div class="para"><p>If you want to see whether there have been any errors while doing the backup,
<div class="paragraph"><p>If you want to see whether there have been any errors while doing the backup,
you can run <tt>ccollect</tt> together with <tt>ccollect_analyse_logs.sh</tt>:</p></div>
<div class="listingblock">
<div class="content">
@ -1170,11 +1216,11 @@ you can run <tt>ccollect</tt> together with <tt>ccollect_analyse_logs.sh</tt>:</
<h2 id="_f_a_q">7. F.A.Q.</h2>
<div class="sectionbody">
<h3 id="_what_happens_if_one_backup_is_broken_or_empty">7.1. What happens if one backup is broken or empty?</h3><div style="clear:left"></div>
<div class="para"><p>Let us assume that one backup failed (connection broke or the source
hard disk had some failures). Therefore we've got one incomplete backup in our history.</p></div>
<div class="para"><p><tt>ccollect</tt> will transfer the missing files the next time you use it.
<div class="paragraph"><p>Let us assume that one backup failed (connection broke or the source
hard disk had some failures). Therefore we&#8217;ve got one incomplete backup in our history.</p></div>
<div class="paragraph"><p><tt>ccollect</tt> will transfer the missing files the next time you use it.
This leads to</p></div>
<div class="ilist"><ul>
<div class="ulist"><ul>
<li>
<p>
more transferred files
@ -1186,24 +1232,24 @@ much greater disk space usage, as no hardlinks can be used
</p>
</li>
</ul></div>
<div class="para"><p>If the whole <tt>ccollect</tt> process was interrupted, <tt>ccollect</tt> (since 0.6) can
<div class="paragraph"><p>If the whole <tt>ccollect</tt> process was interrupted, <tt>ccollect</tt> (since 0.6) can
detect that and remove the incomplete backups, so you can clone from a complete
backup instead</p></div>
<h3 id="_when_backing_up_from_localhost_the_destination_is_also_included_is_this_a_bug">7.2. When backing up from localhost the destination is also included. Is this a bug?</h3><div style="clear:left"></div>
<div class="para"><p>No. <tt>ccollect</tt> passes your source definition directly to <tt>rsync</tt>. It
<div class="paragraph"><p>No. <tt>ccollect</tt> passes your source definition directly to <tt>rsync</tt>. It
does not try to analyze it. So it actually does not know if a source
comes from local harddisk or from a remote server. And it does not want
to. When you backup from the local harddisk (which is perhaps not
even a good idea when thinking of security), add the <tt>destination</tt>
to <em>source/exclude</em>. (Daniel Aubry reported this problem)</p></div>
<h3 id="_why_does_ccollect_say_permission_denied_with_my_pre_postexec_script">7.3. Why does ccollect say "Permission denied" with my pre-/postexec script?</h3><div style="clear:left"></div>
<div class="para"><p>The most common error is that you have not given your script the correct
permissions. Try <tt>chmod 0755 /etc/ccollect/sources/<em>yoursource</em>/*_exec</tt>`.</p></div>
<div class="paragraph"><p>The most common error is that you have not given your script the correct
permissions. Try <tt>chmod 0755 /etc/ccollect/sources/'yoursource'/*_exec</tt>`.</p></div>
<h3 id="_why_does_the_backup_job_fail_when_part_of_the_source_is_a_link">7.4. Why does the backup job fail when part of the source is a link?</h3><div style="clear:left"></div>
<div class="para"><p>When a part of your path you specified in the source is a
<div class="paragraph"><p>When a part of your path you specified in the source is a
(symbolic, hard links are not possible for directories) link,
the backup <strong>must</strong> fail.</p></div>
<div class="para"><p>First of all, let us have a look at how it looks like:</p></div>
<div class="paragraph"><p>First of all, let us have a look at how it looks like:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>==&gt; ccollect 0.4: Beginning backup using interval taeglich &lt;==
@ -1216,7 +1262,7 @@ the backup <strong>must</strong> fail.</p></div>
[testsource] rsync: stat "/etc/ccollect/sources/testsource/destination/taeglich.2006-04-29-0001.3874/home/user/nico/projekte/ccollect" failed: No such file or directory (2)
[...]</tt></pre>
</div></div>
<div class="para"><p>So what is the problem? It is very obvious when you look deeper into it:</p></div>
<div class="paragraph"><p>So what is the problem? It is very obvious when you look deeper into it:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>% cat /etc/ccollect/sources/testsource/source
@ -1226,17 +1272,17 @@ lrwxrwxrwx 1 nico nico 29 2005-12-02 23:28 /home/user/nico/projekte -&gt; oeffen
% ls -l /etc/ccollect/sources/testsource/destination/taeglich.2006-04-29-0001.3874/home/user/nico
lrwxrwxrwx 1 nico nico 29 2006-04-29 00:01 projekte -&gt; oeffentlich/computer/projekte</tt></pre>
</div></div>
<div class="para"><p><tt>rsync</tt> creates the directory structure before it creates the symbolic link.
<div class="paragraph"><p><tt>rsync</tt> creates the directory structure before it creates the symbolic link.
This link now links to something not reachable (dead link). It is
impossible to create subdirectories under the broken link.</p></div>
<div class="para"><p>In conclusion you cannot use paths with a linked part.</p></div>
<div class="para"><p>However, you can backup directories containing symbolic links
<div class="paragraph"><p>In conclusion you cannot use paths with a linked part.</p></div>
<div class="paragraph"><p>However, you can backup directories containing symbolic links
(in this case you could backup /home/user/nico, which contains
/home/user/nico/projekte and oeffentlich/computer/projekte).</p></div>
<h3 id="_how_can_i_prevent_missing_the_right_time_to_enter_my_password">7.5. How can I prevent missing the right time to enter my password?</h3><div style="clear:left"></div>
<div class="para"><p>As <tt>ccollect</tt> first deletes the old backups, it may take some time
<div class="paragraph"><p>As <tt>ccollect</tt> first deletes the old backups, it may take some time
until <tt>rsync</tt> requests the password for the <tt>ssh</tt> session from you.</p></div>
<div class="para"><p>The easiest way not to miss that point is running <tt>ccollect</tt> in <tt>screen</tt>,
<div class="paragraph"><p>The easiest way not to miss that point is running <tt>ccollect</tt> in <tt>screen</tt>,
which has the ability to monitor the output for activity. So as soon as
your screen beeps, after <tt>ccollect</tt> began to remove the last directory,
you can enter your password (have a look at screen(1), especially "C-a M"
@ -1270,7 +1316,7 @@ srwali01:/etc/ccollect/sources/local-root# ccollect.sh taeglich local-root
/=&gt; Beginning to backup "local-root" ...
|-&gt; 0 backup(s) already exist, keeping 28 backup(s).</tt></pre>
</div></div>
<div class="para"><p>After that, I added some more sources:</p></div>
<div class="paragraph"><p>After that, I added some more sources:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>srwali01:~# cd /etc/ccollect/sources
@ -1319,7 +1365,7 @@ srwali01:/etc/ccollect/sources# du -sh /mnt/hdbackup/wl6/*
147M /mnt/hdbackup/wl6/taeglich.2005-12-08-14:42.312
147M /mnt/hdbackup/wl6/taeglich.2005-12-08-14:45.588</tt></pre>
</div></div>
<div class="para"><p>The backup of our main fileserver:</p></div>
<div class="paragraph"><p>The backup of our main fileserver:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>backup:~# df -h /home/backup/srsyg01/
@ -1341,7 +1387,7 @@ backup:~# du -sh /home/backup/srsyg01/*
backup:~# du --version | head -n1
du (coreutils) 5.2.1</tt></pre>
</div></div>
<div class="para"><p>Newer versions of du also detect the hardlinks, so we can even compare
<div class="paragraph"><p>Newer versions of du also detect the hardlinks, so we can even compare
the sizes directly with du:</p></div>
<div class="listingblock">
<div class="content">
@ -1358,10 +1404,10 @@ du (GNU coreutils) 5.93
1.5G hydrogenium/durcheinander.2006-01-25-23:18.31328
200M hydrogenium/durcheinander.2006-01-26-00:11.3332</tt></pre>
</div></div>
<div class="para"><p>In the second report (without -l) the sizes include the space the inodes of
<div class="paragraph"><p>In the second report (without -l) the sizes include the space the inodes of
the hardlinks allocate.</p></div>
<h3 id="_a_collection_of_backups_on_the_backup_server">8.3. A collection of backups on the backup server</h3><div style="clear:left"></div>
<div class="para"><p>All the data of my important hosts is backuped to eiche into
<div class="paragraph"><p>All the data of my important hosts is backuped to eiche into
/mnt/schwarzesloch/backup:</p></div>
<div class="listingblock">
<div class="content">
@ -1386,7 +1432,7 @@ woechentlich.2006-02-06-08:22.15994 woechentlich.2006-03-02-23:00.17346
woechentlich.2006-02-06-19:40.16321 woechentlich.2006-03-09-23:00.29317
woechentlich.2006-02-12-11:51.2514 woechentlich.2006-03-16-23:00.4218</tt></pre>
</div></div>
<div class="para"><p>And this incremental backup and the archive are copied to an external
<div class="paragraph"><p>And this incremental backup and the archive are copied to an external
usb harddisk (attention: you <strong>should</strong> really use -H to backup the backup):</p></div>
<div class="listingblock">
<div class="content">
@ -1412,7 +1458,7 @@ rsync -av -H --delete /mnt/schwarzesloch/ "$DDIR/schwarzesloch/"
rsync -av -H --delete /mnt/archiv/ "$DDIR/archiv/"</tt></pre>
</div></div>
<h3 id="_processes_running_when_doing_ccollect_p">8.4. Processes running when doing ccollect -p</h3><div style="clear:left"></div>
<div class="para"><p>Truncated output from <tt>ps axuwwwf</tt>:</p></div>
<div class="paragraph"><p>Truncated output from <tt>ps axuwwwf</tt>:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt> S+ 11:40 0:00 | | | \_ /bin/sh /usr/local/bin/ccollect.sh daily -p ddba034 ddba045 ddba046 ddba047 ddba049 ddna010 ddna011
@ -1454,13 +1500,13 @@ rsync -av -H --delete /mnt/archiv/ "$DDIR/archiv/"</tt></pre>
S+ 11:40 0:00 | | | \_ /bin/sh /usr/local/bin/ccollect.sh daily ddna011
S+ 11:40 0:00 | | | \_ sed s:^:\[ddna011\] :</tt></pre>
</div></div>
<div class="para"><p>As you can see, six processes are deleting old backups, while one backup
<div class="paragraph"><p>As you can see, six processes are deleting old backups, while one backup
(ddba034) is already copying data.</p></div>
</div>
<div id="footer">
<div id="footer-text">
Version 0.7.1<br />
Last updated 2009-01-13 12:04:33 CEST
Last updated 2009-07-01 09:53:57 CEST
</div>
</div>
</body>

7
software/ccollect/doc/ccollect.text
View File

@ -23,6 +23,7 @@ Supported and tested operating systems and architectures
- GNU/Linux on amd64/hppa/i386/ppc
- FreeBSD on amd64/i386
- Mac OS X 10.5
- NetBSD on alpha/amd64/i386/sparc/sparc64
- OpenBSD on amd64
@ -138,7 +139,7 @@ Quick start
For those who do not want to read the whole long document:
--------------------------------------------------------------------------------
# get latest ccollect tarball from http://unix.schottelius.org/ccollect/
# get latest ccollect tarball from http://www.nico.schottelius.org/software/ccollect/
# replace value for CCV with the current version
export CCV=0.7.1
@ -146,7 +147,7 @@ export CCV=0.7.1
# replace 'wget' with 'fetch' on bsd
#
holen=wget
"$holen" http://unix.schottelius.org/ccollect/ccollect-${CCV}.tar.bz2
"$holen" http://www.nico.schottelius.org/software/ccollect/ccollect-${CCV}.tar.bz2
# extract the tarball, change to the newly created directory
tar -xvjf ccollect-${CCV}.tar.bz2
@ -211,7 +212,7 @@ Installing ccollect
~~~~~~~~~~~~~~~~~~~
For the installation you need at least
- the latest ccollect package (http://unix.schottelius.org/ccollect/)
- the latest ccollect package (http://www.nico.schottelius.org/software/ccollect/)
- either `cp` and `chmod` or `install`
- for more comfort: `make`
- for rebuilding the generated documentation: additionally `asciidoc`

44
software/ccollect/doc/man/ccollect.1
View File

@ -1,25 +1,33 @@
'\" t
.\" Title: ccollect
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 03/17/2008
.\" Manual:
.\" Source:
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
.\" Date: 07/01/2009
.\" Manual: [FIXME: manual]
.\" Source: [FIXME: source]
.\" Language: English
.\"
.TH "CCOLLECT" "1" "03/17/2008" "" ""
.TH "CCOLLECT" "1" "07/01/2009" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync
ccollect \- (pseudo) incremental backup with different exclude lists using hardlinks and rsync
.SH "SYNOPSIS"
\fIccollect\.sh\fR <interval name> [args] <sources to backup>
.sp
\fIccollect\&.sh\fR <interval name> [args] <sources to backup>
.SH "DESCRIPTION"
ccollect is a backup utility written in the sh\-scripting language\. It does not depend on a specific shell, only /bin/sh needs to be bourne shell compatibel (like \fIdash\fR, \fIksh\fR, \fIzsh\fR, \fIbash\fR, \&...)\.
.sp
For more information refer to the manual titled "ccollect \- Installing, Configuring and Using" (available as text (asciidoc), texinfo or html)\.
ccollect is a backup utility written in the sh\-scripting language\&. It does not depend on a specific shell, only /bin/sh needs to be bourne shell compatibel (like \fIdash\fR, \fIksh\fR, \fIzsh\fR, \fIbash\fR, \&...)\&.
.sp
For more information refer to the manual titled "ccollect \- Installing, Configuring and Using" (available as text (asciidoc), texinfo or html)\&.
.SH "OPTIONS"
.PP
\-h, \-\-help
@ -39,23 +47,17 @@ Backup all sources specified in /etc/ccollect/sources
.PP
\-v, \-\-verbose
.RS 4
Be very verbose (uses set \-x)\.
Be very verbose (uses set \-x)\&.
.RE
.SH "SEE ALSO"
.sp
ccollect_add_source(1), ccollect_analyse_logs(1), ccollect_logwrapper(1) ccollect_delete_source(1), ccollect_list_intervals(1)
.sp
.SH "AUTHOR"
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\.org>
.sp
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\&.org>
.SH "RESOURCES"
Main web site: http://unix\.schottelius\.org/ccollect/
.sp
Main web site: http://www\&.nico\&.schottelius\&.org/software/ccollect/
.SH "COPYING"
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)\.
.sp
.SH "NOTES"
.IP " 1." 4
nico-ccollect--@--schottelius.org
.RS 4
\%mailto:nico-ccollect--@--schottelius.org
.RE
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)\&.

16
software/ccollect/doc/man/ccollect.htm
View File

@ -1,23 +1,23 @@
<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.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2503836"></a>ccollect(1)</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Nico</span> <span class="surname">Schottelius</span></h3><div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</code></p></div></div></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" lang="en"><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" lang="en"><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> &lt;interval name&gt; [args] &lt;sources to backup&gt;</p></div><div class="section" lang="en"><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.75.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="id307604"></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> &lt;interval name&gt; [args] &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),
texinfo or html).</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_options"></a>OPTIONS</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
-h, &#8212;help
texinfo or html).</p></div><div class="section" title="OPTIONS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_options"></a>OPTIONS</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
-h, --help
</span></dt><dd>
Show the help screen
</dd><dt><span class="term">
-p, &#8212;parallel
-p, --parallel
</span></dt><dd>
Parallelise backup processes
</dd><dt><span class="term">
-a, &#8212;all
-a, --all
</span></dt><dd>
Backup all sources specified in /etc/ccollect/sources
</dd><dt><span class="term">
-v, &#8212;verbose
-v, --verbose
</span></dt><dd>
Be very verbose (uses set -x).
</dd></dl></div></div><div class="section" lang="en"><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" lang="en"><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%E2%80%94@--schottelius.org" target="_top">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div><div class="section" lang="en"><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://unix.schottelius.org/ccollect/" target="_top">http://unix.schottelius.org/ccollect/</a></p></div><div class="section" lang="en"><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
</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>

163
software/ccollect/doc/man/ccollect.html
View File

@ -3,7 +3,8 @@
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.2.5" />
<meta name="generator" content="AsciiDoc 8.4.4" />
<title>ccollect(1)</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@ -26,10 +27,12 @@ a:visited {
em {
font-style: italic;
color: navy;
}
strong {
font-weight: bold;
color: #083194;
}
tt {
@ -71,6 +74,10 @@ p {
margin-bottom: 0.5em;
}
ul, ol, li > p {
margin-top: 0;
}
pre {
padding: 0;
margin: 0;
@ -104,11 +111,13 @@ div#footer-badges {
padding-bottom: 0.5em;
}
div#preamble,
div#preamble {
margin-top: 1.5em;
margin-bottom: 1.5em;
}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@ -123,6 +132,7 @@ div.content { /* Block element content. */
/* Block element titles. */
div.title, caption.title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
text-align: left;
@ -149,22 +159,33 @@ div.sidebarblock > div.content {
padding: 0.5em;
}
div.listingblock {
margin-right: 0%;
}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
padding: 0.5em;
}
div.quoteblock > div.content {
div.quoteblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.attribution {
div.quoteblock > div.attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.verseblock > div.content {
white-space: pre;
}
div.verseblock > div.attribution {
padding-top: 0.75em;
text-align: left;
}
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
@ -187,10 +208,6 @@ div.exampleblock > div.content {
padding: 0.5em;
}
div.verseblock div.content {
white-space: pre;
}
div.imageblock div.content { padding-left: 0; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }
@ -202,18 +219,38 @@ dl {
dt {
margin-top: 0.5em;
margin-bottom: 0;
font-style: italic;
font-style: normal;
color: navy;
}
dd > *:first-child {
margin-top: 0;
margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
div.olist2 ol {
ol.arabic {
list-style-type: decimal;
}
ol.loweralpha {
list-style-type: lower-alpha;
}
ol.upperalpha {
list-style-type: upper-alpha;
}
ol.lowerroman {
list-style-type: lower-roman;
}
ol.upperroman {
list-style-type: upper-roman;
}
div.compact ul, div.compact ol,
div.compact p, div.compact p,
div.compact div, div.compact div {
margin-top: 0.1em;
margin-bottom: 0.1em;
}
div.tableblock > table {
border: 3px solid #527bbd;
@ -225,22 +262,53 @@ thead {
tfoot {
font-weight: bold;
}
td > div.verse {
white-space: pre;
}
p.table {
margin-top: 0;
}
/* Because the table frame attribute is overriden by CSS in most browsers. */
div.tableblock > table[frame="void"] {
border-style: none;
}
div.tableblock > table[frame="hsides"] {
border-left-style: none;
border-right-style: none;
}
div.tableblock > table[frame="vsides"] {
border-top-style: none;
border-bottom-style: none;
}
div.hlist {
div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
div.hlist td {
padding-bottom: 5px;
div.hdlist tr {
padding-bottom: 15px;
}
td.hlist1 {
dt.hdlist1.strong, td.hdlist1.strong {
font-weight: bold;
}
td.hdlist1 {
vertical-align: top;
font-style: italic;
font-style: normal;
padding-right: 0.8em;
color: navy;
}
td.hlist2 {
td.hdlist2 {
vertical-align: top;
}
div.hdlist.compact tr {
margin: 0;
padding-bottom: 0;
}
.comment {
background: yellow;
}
@media print {
div#footer-badges { display: none; }
@ -279,6 +347,7 @@ div.sidebar-content {
padding: 0.5em;
}
div.sidebar-title, div.image-title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
margin-top: 0.0em;
@ -291,8 +360,17 @@ div.listingblock div.content {
padding: 0.5em;
}
div.quoteblock-content {
padding-left: 2.0em;
div.quoteblock-attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock-content {
white-space: pre;
}
div.verseblock-attribution {
padding-top: 0.75em;
text-align: left;
}
div.exampleblock-content {
@ -303,7 +381,6 @@ div.exampleblock-content {
/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
<title>ccollect(1)</title>
</head>
<body>
<div id="header">
@ -313,50 +390,50 @@ div#toc a:visited { color: blue; }
</div>
<h2 id="_name">1. NAME</h2>
<div class="sectionbody">
<div class="para"><p>ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync</p></div>
<div class="paragraph"><p>ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync</p></div>
</div>
<h2 id="_synopsis">2. SYNOPSIS</h2>
<div class="sectionbody">
<div class="para"><p><em>ccollect.sh</em> &lt;interval name&gt; [args] &lt;sources to backup&gt;</p></div>
<div class="paragraph"><p><em>ccollect.sh</em> &lt;interval name&gt; [args] &lt;sources to backup&gt;</p></div>
</div>
<h2 id="_description">3. DESCRIPTION</h2>
<div class="sectionbody">
<div class="para"><p><tt>ccollect</tt> is a backup utility written in the sh-scripting language.
<div class="paragraph"><p><tt>ccollect</tt> is a backup utility written in the sh-scripting language.
It does not depend on a specific shell, only <tt>/bin/sh</tt> needs to be
bourne shell compatibel (like <em>dash</em>, <em>ksh</em>, <em>zsh</em>, <em>bash</em>, &#8230;).</p></div>
<div class="para"><p>For more information refer to the manual titled
<div class="paragraph"><p>For more information refer to the manual titled
"ccollect - Installing, Configuring and Using" (available as text (asciidoc),
texinfo or html).</p></div>
</div>
<h2 id="_options">4. OPTIONS</h2>
<div class="sectionbody">
<div class="vlist"><dl>
<dt>
-h, &#8212;help
<div class="dlist"><dl>
<dt class="hdlist1">
-h, --help
</dt>
<dd>
<p>
Show the help screen
</p>
</dd>
<dt>
-p, &#8212;parallel
<dt class="hdlist1">
-p, --parallel
</dt>
<dd>
<p>
Parallelise backup processes
</p>
</dd>
<dt>
-a, &#8212;all
<dt class="hdlist1">
-a, --all
</dt>
<dd>
<p>
Backup all sources specified in /etc/ccollect/sources
</p>
</dd>
<dt>
-v, &#8212;verbose
<dt class="hdlist1">
-v, --verbose
</dt>
<dd>
<p>
@ -367,25 +444,25 @@ texinfo or html).</p></div>
</div>
<h2 id="_see_also">5. SEE ALSO</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_add_source(1), ccollect_analyse_logs(1), ccollect_logwrapper(1)
<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>
<h2 id="_author">6. AUTHOR</h2>
<div class="sectionbody">
<div class="para"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect&#8212;@--schottelius.org">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div>
<div class="paragraph"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</p></div>
</div>
<h2 id="_resources">7. RESOURCES</h2>
<div class="sectionbody">
<div class="para"><p>Main web site: <a href="http://unix.schottelius.org/ccollect/">http://unix.schottelius.org/ccollect/</a></p></div>
<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>
<h2 id="_copying">8. COPYING</h2>
<div class="sectionbody">
<div class="para"><p>Copyright (C) 2006-2008 Nico Schottelius. Free use of this software is
<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>
</div>
<div id="footer">
<div id="footer-text">
Last updated 2008-03-17 18:26:06 CEST
Last updated 2009-07-01 09:53:52 CEST
</div>
</div>
</body>

2
software/ccollect/doc/man/ccollect.text
View File

@ -52,7 +52,7 @@ Nico Schottelius <mailto:nico-ccollect--@--schottelius.org[]>
RESOURCES
---------
Main web site: http://unix.schottelius.org/ccollect/[]
Main web site: http://www.nico.schottelius.org/software/ccollect/[]
COPYING

58
software/ccollect/doc/man/ccollect_add_source.1
View File

@ -1,44 +1,52 @@
'\" t
.\" Title: ccollect_add_source
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 03/17/2008
.\" Manual:
.\" Source:
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
.\" Date: 07/01/2009
.\" Manual: [FIXME: manual]
.\" Source: [FIXME: source]
.\" Language: English
.\"
.TH "CCOLLECT_ADD_SOURCE" "1" "03/17/2008" "" ""
.TH "CCOLLECT_ADD_SOURCE" "1" "07/01/2009" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ccollect_add_source - create new source for ccollect(1)
ccollect_add_source \- create new source for ccollect(1)
.SH "SYNOPSIS"
\fIccollect_add_source\.sh\fR <hostnames to create sources for>
.sp
\fIccollect_add_source\&.sh\fR <hostnames to create sources for>
.SH "DESCRIPTION"
ccollect_add_source\.sh creates a new backup source for use with ccollect(1)\. It copies the files from to the source directory with the hostname below \fI$CCOLLECT_CONF/sources\fR\. It is designed to run on a backup server to create new directories for new hosts\.
.sp
ccollect_add_source\&.sh creates a new backup source for use with ccollect(1)\&. It copies the files from to the source directory with the hostname below \fI$CCOLLECT_CONF/sources\fR\&. It is designed to run on a backup server to create new directories for new hosts\&.
.SH "FILES"
.PP
$CCOLLECT_CONF/defaults/sources
.RS 4
Main configuration directory\. $CCOLLECT_CONF is
\fI/etc/ccollect\fR, if unset\. All the following files reside below this directory\.
Main configuration directory\&. $CCOLLECT_CONF is
\fI/etc/ccollect\fR, if unset\&. All the following files reside below this directory\&.
.RE
.PP
exclude, summary, intervals, pre_exec, post_exec, rsync_options, verbose, very_verbose
.RS 4
Those are the standard configuration files known by ccollect(1)\. If the file exist it will be copied to the newly created source\. Directories (\fIintervals\fR) are copied recursively\.
Those are the standard configuration files known by ccollect(1)\&. If the file exist it will be copied to the newly created source\&. Directories (\fIintervals\fR) are copied recursively\&.
.RE
.PP
destination_base
.RS 4
A link to the directory where to store the backups\. Below this directory
ccollect_add_source\.sh
will create a directory with the hostname you specified on the command line\. A common valua for
A link to the directory where to store the backups\&. Below this directory
ccollect_add_source\&.sh
will create a directory with the hostname you specified on the command line\&. A common valua for
destination_base
is
\fI/home/server/backup\fR\.
\fI/home/server/backup\fR\&.
.RE
.PP
source_prefix, source_postfix
@ -47,30 +55,24 @@ source_prefix, source_postfix
source_prefix
is put before the hostname,
source_postfix
is appended after it\. A common value for
is appended after it\&. A common value for
source_prefix
maybe
\fIroot@\fR
and
\fI:/\fR
for
source_postfix\.
source_postfix\&.
.RE
.SH "SEE ALSO"
ccollect(1), ccollect_analyse_logs\.sh, ccollect_delete_source(1), ccollect_list_intervals(1), ccollect_logwrapper(1),
.sp
ccollect(1), ccollect_analyse_logs\&.sh, ccollect_delete_source(1), ccollect_list_intervals(1), ccollect_logwrapper(1),
.SH "AUTHOR"
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\.org>
.sp
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\&.org>
.SH "RESOURCES"
Main web site: http://unix\.schottelius\.org/ccollect/
.sp
Main web site: http://www\&.nico\&.schottelius\&.org/software/ccollect/
.SH "COPYING"
Copyright (C) 2007\-2008 Nico Schottelius\. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3)\.
.sp
.SH "NOTES"
.IP " 1." 4
nico-ccollect--@--schottelius.org
.RS 4
\%mailto:nico-ccollect--@--schottelius.org
.RE
Copyright (C) 2007\-2008 Nico Schottelius\&. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3)\&.

8
software/ccollect/doc/man/ccollect_add_source.htm
View File

@ -1,7 +1,7 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect_add_source(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2504039"></a>ccollect_add_source(1)</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Nico</span> <span class="surname">Schottelius</span></h3><div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</code></p></div></div></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="#_files">FILES</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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_name"></a>NAME</h2></div></div></div><p>ccollect_add_source - create new source for ccollect(1)</p></div><div class="section" lang="en"><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_add_source.sh</em></span> &lt;hostnames to create sources for&gt;</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_description"></a>DESCRIPTION</h2></div></div></div><p>ccollect_add_source.sh creates a new backup source for use with ccollect(1).
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect_add_source(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="article" title="ccollect_add_source(1)"><div class="titlepage"><div><div><h2 class="title"><a name="id349179"></a>ccollect_add_source(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="#_files">FILES</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_add_source - create new source for ccollect(1)</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_add_source.sh</em></span> &lt;hostnames to create sources for&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>ccollect_add_source.sh creates a new backup source for use with ccollect(1).
It copies the files from to the source directory with the hostname below
<span class="emphasis"><em>$CCOLLECT_CONF/sources</em></span>. It is designed to run on a backup server to create
new directories for new hosts.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_files"></a>FILES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
new directories for new hosts.</p></div><div class="section" title="FILES"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_files"></a>FILES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
$CCOLLECT_CONF/defaults/sources
</span></dt><dd>
Main configuration directory. $CCOLLECT_CONF is <span class="emphasis"><em>/etc/ccollect</em></span>, if unset.
@ -41,6 +41,6 @@ source_postfix
<code class="literal">source_prefix</code> is put before the hostname, <code class="literal">source_postfix</code> is appended
after it. A common value for <code class="literal">source_prefix</code> maybe <span class="emphasis"><em>root@</em></span> and <span class="emphasis"><em>:/</em></span>
for <code class="literal">source_postfix</code>.
</dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_see_also"></a>SEE ALSO</h2></div></div></div><p>ccollect(1), ccollect_analyse_logs.sh, ccollect_delete_source(1),
ccollect_list_intervals(1), ccollect_logwrapper(1),</p></div><div class="section" lang="en"><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%E2%80%94@--schottelius.org" target="_top">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div><div class="section" lang="en"><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://unix.schottelius.org/ccollect/" target="_top">http://unix.schottelius.org/ccollect/</a></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_copying"></a>COPYING</h2></div></div></div><p>Copyright (C) 2007-2008 Nico Schottelius. Free use of this software is
</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(1), ccollect_analyse_logs.sh, ccollect_delete_source(1),
ccollect_list_intervals(1), ccollect_logwrapper(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) 2007-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>

169
software/ccollect/doc/man/ccollect_add_source.html
View File

@ -3,7 +3,8 @@
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.2.5" />
<meta name="generator" content="AsciiDoc 8.4.4" />
<title>ccollect_add_source(1)</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@ -26,10 +27,12 @@ a:visited {
em {
font-style: italic;
color: navy;
}
strong {
font-weight: bold;
color: #083194;
}
tt {
@ -71,6 +74,10 @@ p {
margin-bottom: 0.5em;
}
ul, ol, li > p {
margin-top: 0;
}
pre {
padding: 0;
margin: 0;
@ -104,11 +111,13 @@ div#footer-badges {
padding-bottom: 0.5em;
}
div#preamble,
div#preamble {
margin-top: 1.5em;
margin-bottom: 1.5em;
}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@ -123,6 +132,7 @@ div.content { /* Block element content. */
/* Block element titles. */
div.title, caption.title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
text-align: left;
@ -149,22 +159,33 @@ div.sidebarblock > div.content {
padding: 0.5em;
}
div.listingblock {
margin-right: 0%;
}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
padding: 0.5em;
}
div.quoteblock > div.content {
div.quoteblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.attribution {
div.quoteblock > div.attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.verseblock > div.content {
white-space: pre;
}
div.verseblock > div.attribution {
padding-top: 0.75em;
text-align: left;
}
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
@ -187,10 +208,6 @@ div.exampleblock > div.content {
padding: 0.5em;
}
div.verseblock div.content {
white-space: pre;
}
div.imageblock div.content { padding-left: 0; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }
@ -202,18 +219,38 @@ dl {
dt {
margin-top: 0.5em;
margin-bottom: 0;
font-style: italic;
font-style: normal;
color: navy;
}
dd > *:first-child {
margin-top: 0;
margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
div.olist2 ol {
ol.arabic {
list-style-type: decimal;
}
ol.loweralpha {
list-style-type: lower-alpha;
}
ol.upperalpha {
list-style-type: upper-alpha;
}
ol.lowerroman {
list-style-type: lower-roman;
}
ol.upperroman {
list-style-type: upper-roman;
}
div.compact ul, div.compact ol,
div.compact p, div.compact p,
div.compact div, div.compact div {
margin-top: 0.1em;
margin-bottom: 0.1em;
}
div.tableblock > table {
border: 3px solid #527bbd;
@ -225,22 +262,53 @@ thead {
tfoot {
font-weight: bold;
}
td > div.verse {
white-space: pre;
}
p.table {
margin-top: 0;
}
/* Because the table frame attribute is overriden by CSS in most browsers. */
div.tableblock > table[frame="void"] {
border-style: none;
}
div.tableblock > table[frame="hsides"] {
border-left-style: none;
border-right-style: none;
}
div.tableblock > table[frame="vsides"] {
border-top-style: none;
border-bottom-style: none;
}
div.hlist {
div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
div.hlist td {
padding-bottom: 5px;
div.hdlist tr {
padding-bottom: 15px;
}
td.hlist1 {
dt.hdlist1.strong, td.hdlist1.strong {
font-weight: bold;
}
td.hdlist1 {
vertical-align: top;
font-style: italic;
font-style: normal;
padding-right: 0.8em;
color: navy;
}
td.hlist2 {
td.hdlist2 {
vertical-align: top;
}
div.hdlist.compact tr {
margin: 0;
padding-bottom: 0;
}
.comment {
background: yellow;
}
@media print {
div#footer-badges { display: none; }
@ -279,6 +347,7 @@ div.sidebar-content {
padding: 0.5em;
}
div.sidebar-title, div.image-title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
margin-top: 0.0em;
@ -291,8 +360,17 @@ div.listingblock div.content {
padding: 0.5em;
}
div.quoteblock-content {
padding-left: 2.0em;
div.quoteblock-attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock-content {
white-space: pre;
}
div.verseblock-attribution {
padding-top: 0.75em;
text-align: left;
}
div.exampleblock-content {
@ -303,7 +381,6 @@ div.exampleblock-content {
/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
<title>ccollect_add_source(1)</title>
</head>
<body>
<div id="header">
@ -313,23 +390,23 @@ div#toc a:visited { color: blue; }
</div>
<h2 id="_name">1. NAME</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_add_source - create new source for ccollect(1)</p></div>
<div class="paragraph"><p>ccollect_add_source - create new source for ccollect(1)</p></div>
</div>
<h2 id="_synopsis">2. SYNOPSIS</h2>
<div class="sectionbody">
<div class="para"><p><em>ccollect_add_source.sh</em> &lt;hostnames to create sources for&gt;</p></div>
<div class="paragraph"><p><em>ccollect_add_source.sh</em> &lt;hostnames to create sources for&gt;</p></div>
</div>
<h2 id="_description">3. DESCRIPTION</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_add_source.sh creates a new backup source for use with ccollect(1).
<div class="paragraph"><p>ccollect_add_source.sh creates a new backup source for use with ccollect(1).
It copies the files from to the source directory with the hostname below
<em>$CCOLLECT_CONF/sources</em>. It is designed to run on a backup server to create
new directories for new hosts.</p></div>
</div>
<h2 id="_files">4. FILES</h2>
<div class="sectionbody">
<div class="vlist"><dl>
<dt>
<div class="dlist"><dl>
<dt class="hdlist1">
$CCOLLECT_CONF/defaults/sources
</dt>
<dd>
@ -338,28 +415,28 @@ $CCOLLECT_CONF/defaults/sources
All the following files reside below this directory.
</p>
</dd>
<dt>
<dt class="hdlist1">
exclude
</dt>
<dt>
<dt class="hdlist1">
summary
</dt>
<dt>
<dt class="hdlist1">
intervals
</dt>
<dt>
<dt class="hdlist1">
pre_exec
</dt>
<dt>
<dt class="hdlist1">
post_exec
</dt>
<dt>
<dt class="hdlist1">
rsync_options
</dt>
<dt>
<dt class="hdlist1">
verbose
</dt>
<dt>
<dt class="hdlist1">
very_verbose
</dt>
<dd>
@ -369,7 +446,7 @@ very_verbose
Directories (<em>intervals</em>) are copied recursively.
</p>
</dd>
<dt>
<dt class="hdlist1">
destination_base
</dt>
<dd>
@ -380,10 +457,10 @@ destination_base
<em>/home/server/backup</em>.
</p>
</dd>
<dt>
<dt class="hdlist1">
source_prefix
</dt>
<dt>
<dt class="hdlist1">
source_postfix
</dt>
<dd>
@ -397,25 +474,25 @@ source_postfix
</div>
<h2 id="_see_also">5. SEE ALSO</h2>
<div class="sectionbody">
<div class="para"><p>ccollect(1), ccollect_analyse_logs.sh, ccollect_delete_source(1),
<div class="paragraph"><p>ccollect(1), ccollect_analyse_logs.sh, ccollect_delete_source(1),
ccollect_list_intervals(1), ccollect_logwrapper(1),</p></div>
</div>
<h2 id="_author">6. AUTHOR</h2>
<div class="sectionbody">
<div class="para"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect&#8212;@--schottelius.org">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div>
<div class="paragraph"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</p></div>
</div>
<h2 id="_resources">7. RESOURCES</h2>
<div class="sectionbody">
<div class="para"><p>Main web site: <a href="http://unix.schottelius.org/ccollect/">http://unix.schottelius.org/ccollect/</a></p></div>
<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>
<h2 id="_copying">8. COPYING</h2>
<div class="sectionbody">
<div class="para"><p>Copyright (C) 2007-2008 Nico Schottelius. Free use of this software is
<div class="paragraph"><p>Copyright (C) 2007-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>
<div id="footer">
<div id="footer-text">
Last updated 2008-03-17 18:26:06 CEST
Last updated 2009-07-01 09:53:52 CEST
</div>
</div>
</body>

2
software/ccollect/doc/man/ccollect_add_source.text
View File

@ -66,7 +66,7 @@ Nico Schottelius <mailto:nico-ccollect--@--schottelius.org[]>
RESOURCES
---------
Main web site: http://unix.schottelius.org/ccollect/[]
Main web site: http://www.nico.schottelius.org/software/ccollect/[]
COPYING

44
software/ccollect/doc/man/ccollect_analyse_logs.1
View File

@ -1,23 +1,31 @@
'\" t
.\" Title: ccollect_analyse_logs
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 03/17/2008
.\" Manual:
.\" Source:
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
.\" Date: 07/01/2009
.\" Manual: [FIXME: manual]
.\" Source: [FIXME: source]
.\" Language: English
.\"
.TH "CCOLLECT_ANALYSE_LOG" "1" "03/17/2008" "" ""
.TH "CCOLLECT_ANALYSE_LOG" "1" "07/01/2009" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ccollect_analyse_logs - analyse logs produced by ccollect(1)
ccollect_analyse_logs \- analyse logs produced by ccollect(1)
.SH "SYNOPSIS"
\fIccollect_analyse_logs\.sh\fR [iwe]
.sp
\fIccollect_analyse_logs\&.sh\fR [iwe]
.SH "DESCRIPTION"
ccollect_analyse_logs\.sh reads the logfiles from stdin\. You have to specify at least one of the three loglevels (*i*nformational, *w*arning, *e*rror)\. Any combination of them is allowed\.
.sp
ccollect_analyse_logs\&.sh reads the logfiles from stdin\&. You have to specify at least one of the three loglevels (*i*nformational, *w*arning, *e*rror)\&. Any combination of them is allowed\&.
.SH "FILES"
.PP
ccollect log files
@ -26,30 +34,24 @@ Are read from stdin
.RE
.SH "EXAMPLES"
.PP
cat /var/log/ccollect/single/* | ccollect_analyse_logs\.sh iw
cat /var/log/ccollect/single/* | ccollect_analyse_logs\&.sh iw
.RS 4
Displays warnings and informational parts
.RE
.PP
ccollect_analyse_logs\.sh iw < /var/log/ccollect/all_together
ccollect_analyse_logs\&.sh iw < /var/log/ccollect/all_together
.RS 4
Displays only error messages (useful for the morning mail)
.RE
.SH "SEE ALSO"
ccollect(1), ccollect_add_source\.sh, ccollect_delete_source(1), ccollect_list_intervals(1), ccollect_logwrapper(1),
.sp
ccollect(1), ccollect_add_source\&.sh, ccollect_delete_source(1), ccollect_list_intervals(1), ccollect_logwrapper(1),
.SH "AUTHOR"
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\.org>
.sp
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\&.org>
.SH "RESOURCES"
Main web site: http://unix\.schottelius\.org/ccollect/
.sp
Main web site: http://www\&.nico\&.schottelius\&.org/software/ccollect/
.SH "COPYING"
Copyright (C) 2007\-2008 Nico Schottelius\. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3)\.
.sp
.SH "NOTES"
.IP " 1." 4
nico-ccollect--@--schottelius.org
.RS 4
\%mailto:nico-ccollect--@--schottelius.org
.RE
Copyright (C) 2007\-2008 Nico Schottelius\&. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3)\&.

10
software/ccollect/doc/man/ccollect_analyse_logs.htm
View File

@ -1,10 +1,10 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect_analyse_logs(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2503832"></a>ccollect_analyse_logs(1)</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Nico</span> <span class="surname">Schottelius</span></h3><div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</code></p></div></div></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="#_files">FILES</a></span></dt><dt><span class="section"><a href="#_examples">EXAMPLES</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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_name"></a>NAME</h2></div></div></div><p>ccollect_analyse_logs - analyse logs produced by ccollect(1)</p></div><div class="section" lang="en"><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_analyse_logs.sh</em></span> [iwe]</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_description"></a>DESCRIPTION</h2></div></div></div><p>ccollect_analyse_logs.sh reads the logfiles from stdin. You have to specify
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect_analyse_logs(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="article" title="ccollect_analyse_logs(1)"><div class="titlepage"><div><div><h2 class="title"><a name="id372151"></a>ccollect_analyse_logs(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="#_files">FILES</a></span></dt><dt><span class="section"><a href="#_examples">EXAMPLES</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_analyse_logs - analyse logs produced by ccollect(1)</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_analyse_logs.sh</em></span> [iwe]</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>ccollect_analyse_logs.sh reads the logfiles from stdin. You have to specify
at least one of the three loglevels (*i*nformational, *w*arning, *e*rror). Any
combination of them is allowed.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_files"></a>FILES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
combination of them is allowed.</p></div><div class="section" title="FILES"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_files"></a>FILES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
ccollect log files
</span></dt><dd>
Are read from stdin
</dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_examples"></a>EXAMPLES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
</dd></dl></div></div><div class="section" title="EXAMPLES"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_examples"></a>EXAMPLES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
cat /var/log/ccollect/single/* | ccollect_analyse_logs.sh iw
</span></dt><dd>
Displays warnings and informational parts
@ -12,6 +12,6 @@ cat /var/log/ccollect/single/* | ccollect_analyse_logs.sh iw
ccollect_analyse_logs.sh iw &lt; /var/log/ccollect/all_together
</span></dt><dd>
Displays only error messages (useful for the morning mail)
</dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_see_also"></a>SEE ALSO</h2></div></div></div><p>ccollect(1), ccollect_add_source.sh, ccollect_delete_source(1),
ccollect_list_intervals(1), ccollect_logwrapper(1),</p></div><div class="section" lang="en"><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%E2%80%94@--schottelius.org" target="_top">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div><div class="section" lang="en"><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://unix.schottelius.org/ccollect/" target="_top">http://unix.schottelius.org/ccollect/</a></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_copying"></a>COPYING</h2></div></div></div><p>Copyright (C) 2007-2008 Nico Schottelius. Free use of this software is
</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(1), ccollect_add_source.sh, ccollect_delete_source(1),
ccollect_list_intervals(1), ccollect_logwrapper(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) 2007-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>

153
software/ccollect/doc/man/ccollect_analyse_logs.html
View File

@ -3,7 +3,8 @@
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.2.5" />
<meta name="generator" content="AsciiDoc 8.4.4" />
<title>ccollect_analyse_logs(1)</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@ -26,10 +27,12 @@ a:visited {
em {
font-style: italic;
color: navy;
}
strong {
font-weight: bold;
color: #083194;
}
tt {
@ -71,6 +74,10 @@ p {
margin-bottom: 0.5em;
}
ul, ol, li > p {
margin-top: 0;
}
pre {
padding: 0;
margin: 0;
@ -104,11 +111,13 @@ div#footer-badges {
padding-bottom: 0.5em;
}
div#preamble,
div#preamble {
margin-top: 1.5em;
margin-bottom: 1.5em;
}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@ -123,6 +132,7 @@ div.content { /* Block element content. */
/* Block element titles. */
div.title, caption.title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
text-align: left;
@ -149,22 +159,33 @@ div.sidebarblock > div.content {
padding: 0.5em;
}
div.listingblock {
margin-right: 0%;
}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
padding: 0.5em;
}
div.quoteblock > div.content {
div.quoteblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.attribution {
div.quoteblock > div.attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.verseblock > div.content {
white-space: pre;
}
div.verseblock > div.attribution {
padding-top: 0.75em;
text-align: left;
}
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
@ -187,10 +208,6 @@ div.exampleblock > div.content {
padding: 0.5em;
}
div.verseblock div.content {
white-space: pre;
}
div.imageblock div.content { padding-left: 0; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }
@ -202,18 +219,38 @@ dl {
dt {
margin-top: 0.5em;
margin-bottom: 0;
font-style: italic;
font-style: normal;
color: navy;
}
dd > *:first-child {
margin-top: 0;
margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
div.olist2 ol {
ol.arabic {
list-style-type: decimal;
}
ol.loweralpha {
list-style-type: lower-alpha;
}
ol.upperalpha {
list-style-type: upper-alpha;
}
ol.lowerroman {
list-style-type: lower-roman;
}
ol.upperroman {
list-style-type: upper-roman;
}
div.compact ul, div.compact ol,
div.compact p, div.compact p,
div.compact div, div.compact div {
margin-top: 0.1em;
margin-bottom: 0.1em;
}
div.tableblock > table {
border: 3px solid #527bbd;
@ -225,22 +262,53 @@ thead {
tfoot {
font-weight: bold;
}
td > div.verse {
white-space: pre;
}
p.table {
margin-top: 0;
}
/* Because the table frame attribute is overriden by CSS in most browsers. */
div.tableblock > table[frame="void"] {
border-style: none;
}
div.tableblock > table[frame="hsides"] {
border-left-style: none;
border-right-style: none;
}
div.tableblock > table[frame="vsides"] {
border-top-style: none;
border-bottom-style: none;
}
div.hlist {
div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
div.hlist td {
padding-bottom: 5px;
div.hdlist tr {
padding-bottom: 15px;
}
td.hlist1 {
dt.hdlist1.strong, td.hdlist1.strong {
font-weight: bold;
}
td.hdlist1 {
vertical-align: top;
font-style: italic;
font-style: normal;
padding-right: 0.8em;
color: navy;
}
td.hlist2 {
td.hdlist2 {
vertical-align: top;
}
div.hdlist.compact tr {
margin: 0;
padding-bottom: 0;
}
.comment {
background: yellow;
}
@media print {
div#footer-badges { display: none; }
@ -279,6 +347,7 @@ div.sidebar-content {
padding: 0.5em;
}
div.sidebar-title, div.image-title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
margin-top: 0.0em;
@ -291,8 +360,17 @@ div.listingblock div.content {
padding: 0.5em;
}
div.quoteblock-content {
padding-left: 2.0em;
div.quoteblock-attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock-content {
white-space: pre;
}
div.verseblock-attribution {
padding-top: 0.75em;
text-align: left;
}
div.exampleblock-content {
@ -303,7 +381,6 @@ div.exampleblock-content {
/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
<title>ccollect_analyse_logs(1)</title>
</head>
<body>
<div id="header">
@ -313,22 +390,22 @@ div#toc a:visited { color: blue; }
</div>
<h2 id="_name">1. NAME</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_analyse_logs - analyse logs produced by ccollect(1)</p></div>
<div class="paragraph"><p>ccollect_analyse_logs - analyse logs produced by ccollect(1)</p></div>
</div>
<h2 id="_synopsis">2. SYNOPSIS</h2>
<div class="sectionbody">
<div class="para"><p><em>ccollect_analyse_logs.sh</em> [iwe]</p></div>
<div class="paragraph"><p><em>ccollect_analyse_logs.sh</em> [iwe]</p></div>
</div>
<h2 id="_description">3. DESCRIPTION</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_analyse_logs.sh reads the logfiles from stdin. You have to specify
<div class="paragraph"><p>ccollect_analyse_logs.sh reads the logfiles from stdin. You have to specify
at least one of the three loglevels (*i*nformational, *w*arning, *e*rror). Any
combination of them is allowed.</p></div>
</div>
<h2 id="_files">4. FILES</h2>
<div class="sectionbody">
<div class="vlist"><dl>
<dt>
<div class="dlist"><dl>
<dt class="hdlist1">
ccollect log files
</dt>
<dd>
@ -340,8 +417,8 @@ ccollect log files
</div>
<h2 id="_examples">5. EXAMPLES</h2>
<div class="sectionbody">
<div class="vlist"><dl>
<dt>
<div class="dlist"><dl>
<dt class="hdlist1">
cat /var/log/ccollect/single/* | ccollect_analyse_logs.sh iw
</dt>
<dd>
@ -349,7 +426,7 @@ cat /var/log/ccollect/single/* | ccollect_analyse_logs.sh iw
Displays warnings and informational parts
</p>
</dd>
<dt>
<dt class="hdlist1">
ccollect_analyse_logs.sh iw &lt; /var/log/ccollect/all_together
</dt>
<dd>
@ -361,25 +438,25 @@ ccollect_analyse_logs.sh iw &lt; /var/log/ccollect/all_together
</div>
<h2 id="_see_also">6. SEE ALSO</h2>
<div class="sectionbody">
<div class="para"><p>ccollect(1), ccollect_add_source.sh, ccollect_delete_source(1),
<div class="paragraph"><p>ccollect(1), ccollect_add_source.sh, ccollect_delete_source(1),
ccollect_list_intervals(1), ccollect_logwrapper(1),</p></div>
</div>
<h2 id="_author">7. AUTHOR</h2>
<div class="sectionbody">
<div class="para"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect&#8212;@--schottelius.org">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div>
<div class="paragraph"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</p></div>
</div>
<h2 id="_resources">8. RESOURCES</h2>
<div class="sectionbody">
<div class="para"><p>Main web site: <a href="http://unix.schottelius.org/ccollect/">http://unix.schottelius.org/ccollect/</a></p></div>
<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>
<h2 id="_copying">9. COPYING</h2>
<div class="sectionbody">
<div class="para"><p>Copyright (C) 2007-2008 Nico Schottelius. Free use of this software is
<div class="paragraph"><p>Copyright (C) 2007-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>
<div id="footer">
<div id="footer-text">
Last updated 2008-03-17 18:26:07 CEST
Last updated 2009-07-01 09:53:52 CEST
</div>
</div>
</body>

2
software/ccollect/doc/man/ccollect_analyse_logs.text
View File

@ -47,7 +47,7 @@ Nico Schottelius <mailto:nico-ccollect--@--schottelius.org[]>
RESOURCES
---------
Main web site: http://unix.schottelius.org/ccollect/[]
Main web site: http://www.nico.schottelius.org/software/ccollect/[]
COPYING

46
software/ccollect/doc/man/ccollect_delete_source.1
View File

@ -1,48 +1,50 @@
'\" t
.\" Title: ccollect_delete_source
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 03/17/2008
.\" Manual:
.\" Source:
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
.\" Date: 07/01/2009
.\" Manual: [FIXME: manual]
.\" Source: [FIXME: source]
.\" Language: English
.\"
.TH "CCOLLECT_DELETE_SOUR" "1" "03/17/2008" "" ""
.TH "CCOLLECT_DELETE_SOUR" "1" "07/01/2009" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ccollect_delete_source - delete sources from ccollect(1)
ccollect_delete_source \- delete sources from ccollect(1)
.SH "SYNOPSIS"
\fIccollect_delete_source\.sh\fR [\-d] [\-f] <hostnames to create sources for>
.sp
\fIccollect_delete_source\&.sh\fR [\-d] [\-f] <hostnames to create sources for>
.SH "DESCRIPTION"
ccollect_delete_source\.sh deletes backup sources from ccollect(1) and optional also the backups created for that source\.
.sp
ccollect_delete_source\&.sh deletes backup sources from ccollect(1) and optional also the backups created for that source\&.
.SH "OPTIONS"
\-d: Delete also the destination directory\. add_ccollect_source\.sh will change to the source/\fIname\fR/destination directory, get the absolute name and delete it recursively\. \-f: Force deletion\. Do not ask\. Very handy for people who know what they do\. Very dangerous for everyone else\.
.sp
\-d: Delete also the destination directory\&. add_ccollect_source\&.sh will change to the source/\fIname\fR/destination directory, get the absolute name and delete it recursively\&. \-f: Force deletion\&. Do not ask\&. Very handy for people who know what they do\&. Very dangerous for everyone else\&.
.SH "FILES"
.PP
$CCOLLECT_CONF/sources
.RS 4
Directory containing the sources\. $CCOLLECT_CONF is
\fI/etc/ccollect\fR, if unset\.
Directory containing the sources\&. $CCOLLECT_CONF is
\fI/etc/ccollect\fR, if unset\&.
.RE
.SH "SEE ALSO"
.sp
ccollect(1), ccollect_add_source(1), ccollect_add_source(1), ccollect_logwrapper(1), ccollect_list_intervals(1)
.sp
.SH "AUTHOR"
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\.org>
.sp
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\&.org>
.SH "RESOURCES"
Main web site: http://unix\.schottelius\.org/ccollect/
.sp
Main web site: http://www\&.nico\&.schottelius\&.org/software/ccollect/
.SH "COPYING"
Copyright (C) 2007\-2008 Nico Schottelius\. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3)\.
.sp
.SH "NOTES"
.IP " 1." 4
nico-ccollect--@--schottelius.org
.RS 4
\%mailto:nico-ccollect--@--schottelius.org
.RE
Copyright (C) 2007\-2008 Nico Schottelius\&. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3)\&.

10
software/ccollect/doc/man/ccollect_delete_source.htm
View File

@ -1,14 +1,14 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect_delete_source(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2503832"></a>ccollect_delete_source(1)</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Nico</span> <span class="surname">Schottelius</span></h3><div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</code></p></div></div></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="#_files">FILES</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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_name"></a>NAME</h2></div></div></div><p>ccollect_delete_source - delete sources from ccollect(1)</p></div><div class="section" lang="en"><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_delete_source.sh</em></span> [-d] [-f] &lt;hostnames to create sources for&gt;</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_description"></a>DESCRIPTION</h2></div></div></div><p>ccollect_delete_source.sh deletes backup sources from ccollect(1) and optional
also the backups created for that source.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_options"></a>OPTIONS</h2></div></div></div><p>-d:
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect_delete_source(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="article" title="ccollect_delete_source(1)"><div class="titlepage"><div><div><h2 class="title"><a name="id409185"></a>ccollect_delete_source(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="#_files">FILES</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_delete_source - delete sources from ccollect(1)</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_delete_source.sh</em></span> [-d] [-f] &lt;hostnames to create sources for&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>ccollect_delete_source.sh deletes backup sources from ccollect(1) and optional
also the backups created for that source.</p></div><div class="section" title="OPTIONS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_options"></a>OPTIONS</h2></div></div></div><p>-d:
Delete also the destination directory. <code class="literal">add_ccollect_source.sh</code> will change
to the source/<span class="emphasis"><em>name</em></span>/destination directory, get the absolute name and delete
it recursively.
-f:
Force deletion. Do not ask. Very handy for people who know what they do.
Very dangerous for everyone else.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_files"></a>FILES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
Very dangerous for everyone else.</p></div><div class="section" title="FILES"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_files"></a>FILES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
$CCOLLECT_CONF/sources
</span></dt><dd>
Directory containing the sources. $CCOLLECT_CONF is <span class="emphasis"><em>/etc/ccollect</em></span>, if unset.
</dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_see_also"></a>SEE ALSO</h2></div></div></div><p>ccollect(1), ccollect_add_source(1), ccollect_add_source(1),
ccollect_logwrapper(1), ccollect_list_intervals(1)</p></div><div class="section" lang="en"><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%E2%80%94@--schottelius.org" target="_top">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div><div class="section" lang="en"><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://unix.schottelius.org/ccollect/" target="_top">http://unix.schottelius.org/ccollect/</a></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_copying"></a>COPYING</h2></div></div></div><p>Copyright (C) 2007-2008 Nico Schottelius. Free use of this software is
</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(1), ccollect_add_source(1), ccollect_add_source(1),
ccollect_logwrapper(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) 2007-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>

149
software/ccollect/doc/man/ccollect_delete_source.html
View File

@ -3,7 +3,8 @@
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.2.5" />
<meta name="generator" content="AsciiDoc 8.4.4" />
<title>ccollect_delete_source(1)</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@ -26,10 +27,12 @@ a:visited {
em {
font-style: italic;
color: navy;
}
strong {
font-weight: bold;
color: #083194;
}
tt {
@ -71,6 +74,10 @@ p {
margin-bottom: 0.5em;
}
ul, ol, li > p {
margin-top: 0;
}
pre {
padding: 0;
margin: 0;
@ -104,11 +111,13 @@ div#footer-badges {
padding-bottom: 0.5em;
}
div#preamble,
div#preamble {
margin-top: 1.5em;
margin-bottom: 1.5em;
}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@ -123,6 +132,7 @@ div.content { /* Block element content. */
/* Block element titles. */
div.title, caption.title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
text-align: left;
@ -149,22 +159,33 @@ div.sidebarblock > div.content {
padding: 0.5em;
}
div.listingblock {
margin-right: 0%;
}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
padding: 0.5em;
}
div.quoteblock > div.content {
div.quoteblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.attribution {
div.quoteblock > div.attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.verseblock > div.content {
white-space: pre;
}
div.verseblock > div.attribution {
padding-top: 0.75em;
text-align: left;
}
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
@ -187,10 +208,6 @@ div.exampleblock > div.content {
padding: 0.5em;
}
div.verseblock div.content {
white-space: pre;
}
div.imageblock div.content { padding-left: 0; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }
@ -202,18 +219,38 @@ dl {
dt {
margin-top: 0.5em;
margin-bottom: 0;
font-style: italic;
font-style: normal;
color: navy;
}
dd > *:first-child {
margin-top: 0;
margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
div.olist2 ol {
ol.arabic {
list-style-type: decimal;
}
ol.loweralpha {
list-style-type: lower-alpha;
}
ol.upperalpha {
list-style-type: upper-alpha;
}
ol.lowerroman {
list-style-type: lower-roman;
}
ol.upperroman {
list-style-type: upper-roman;
}
div.compact ul, div.compact ol,
div.compact p, div.compact p,
div.compact div, div.compact div {
margin-top: 0.1em;
margin-bottom: 0.1em;
}
div.tableblock > table {
border: 3px solid #527bbd;
@ -225,22 +262,53 @@ thead {
tfoot {
font-weight: bold;
}
td > div.verse {
white-space: pre;
}
p.table {
margin-top: 0;
}
/* Because the table frame attribute is overriden by CSS in most browsers. */
div.tableblock > table[frame="void"] {
border-style: none;
}
div.tableblock > table[frame="hsides"] {
border-left-style: none;
border-right-style: none;
}
div.tableblock > table[frame="vsides"] {
border-top-style: none;
border-bottom-style: none;
}
div.hlist {
div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
div.hlist td {
padding-bottom: 5px;
div.hdlist tr {
padding-bottom: 15px;
}
td.hlist1 {
dt.hdlist1.strong, td.hdlist1.strong {
font-weight: bold;
}
td.hdlist1 {
vertical-align: top;
font-style: italic;
font-style: normal;
padding-right: 0.8em;
color: navy;
}
td.hlist2 {
td.hdlist2 {
vertical-align: top;
}
div.hdlist.compact tr {
margin: 0;
padding-bottom: 0;
}
.comment {
background: yellow;
}
@media print {
div#footer-badges { display: none; }
@ -279,6 +347,7 @@ div.sidebar-content {
padding: 0.5em;
}
div.sidebar-title, div.image-title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
margin-top: 0.0em;
@ -291,8 +360,17 @@ div.listingblock div.content {
padding: 0.5em;
}
div.quoteblock-content {
padding-left: 2.0em;
div.quoteblock-attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock-content {
white-space: pre;
}
div.verseblock-attribution {
padding-top: 0.75em;
text-align: left;
}
div.exampleblock-content {
@ -303,7 +381,6 @@ div.exampleblock-content {
/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
<title>ccollect_delete_source(1)</title>
</head>
<body>
<div id="header">
@ -313,20 +390,20 @@ div#toc a:visited { color: blue; }
</div>
<h2 id="_name">1. NAME</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_delete_source - delete sources from ccollect(1)</p></div>
<div class="paragraph"><p>ccollect_delete_source - delete sources from ccollect(1)</p></div>
</div>
<h2 id="_synopsis">2. SYNOPSIS</h2>
<div class="sectionbody">
<div class="para"><p><em>ccollect_delete_source.sh</em> [-d] [-f] &lt;hostnames to create sources for&gt;</p></div>
<div class="paragraph"><p><em>ccollect_delete_source.sh</em> [-d] [-f] &lt;hostnames to create sources for&gt;</p></div>
</div>
<h2 id="_description">3. DESCRIPTION</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_delete_source.sh deletes backup sources from ccollect(1) and optional
<div class="paragraph"><p>ccollect_delete_source.sh deletes backup sources from ccollect(1) and optional
also the backups created for that source.</p></div>
</div>
<h2 id="_options">4. OPTIONS</h2>
<div class="sectionbody">
<div class="para"><p>-d:
<div class="paragraph"><p>-d:
Delete also the destination directory. <tt>add_ccollect_source.sh</tt> will change
to the source/<em>name</em>/destination directory, get the absolute name and delete
it recursively.
@ -336,8 +413,8 @@ also the backups created for that source.</p></div>
</div>
<h2 id="_files">5. FILES</h2>
<div class="sectionbody">
<div class="vlist"><dl>
<dt>
<div class="dlist"><dl>
<dt class="hdlist1">
$CCOLLECT_CONF/sources
</dt>
<dd>
@ -349,25 +426,25 @@ $CCOLLECT_CONF/sources
</div>
<h2 id="_see_also">6. SEE ALSO</h2>
<div class="sectionbody">
<div class="para"><p>ccollect(1), ccollect_add_source(1), ccollect_add_source(1),
<div class="paragraph"><p>ccollect(1), ccollect_add_source(1), ccollect_add_source(1),
ccollect_logwrapper(1), ccollect_list_intervals(1)</p></div>
</div>
<h2 id="_author">7. AUTHOR</h2>
<div class="sectionbody">
<div class="para"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect&#8212;@--schottelius.org">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div>
<div class="paragraph"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</p></div>
</div>
<h2 id="_resources">8. RESOURCES</h2>
<div class="sectionbody">
<div class="para"><p>Main web site: <a href="http://unix.schottelius.org/ccollect/">http://unix.schottelius.org/ccollect/</a></p></div>
<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>
<h2 id="_copying">9. COPYING</h2>
<div class="sectionbody">
<div class="para"><p>Copyright (C) 2007-2008 Nico Schottelius. Free use of this software is
<div class="paragraph"><p>Copyright (C) 2007-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>
<div id="footer">
<div id="footer-text">
Last updated 2008-03-17 18:26:07 CEST
Last updated 2009-07-01 09:53:52 CEST
</div>
</div>
</body>

2
software/ccollect/doc/man/ccollect_delete_source.text
View File

@ -48,7 +48,7 @@ Nico Schottelius <mailto:nico-ccollect--@--schottelius.org[]>
RESOURCES
---------
Main web site: http://unix.schottelius.org/ccollect/[]
Main web site: http://www.nico.schottelius.org/software/ccollect/[]
COPYING

44
software/ccollect/doc/man/ccollect_list_intervals.1
View File

@ -1,45 +1,47 @@
'\" t
.\" Title: ccollect_list_intervals
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 03/17/2008
.\" Manual:
.\" Source:
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
.\" Date: 07/01/2009
.\" Manual: [FIXME: manual]
.\" Source: [FIXME: source]
.\" Language: English
.\"
.TH "CCOLLECT_LIST_INTERV" "1" "03/17/2008" "" ""
.TH "CCOLLECT_LIST_INTERV" "1" "07/01/2009" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ccollect_list_intervals - list available intervals from ccollect(1)
ccollect_list_intervals \- list available intervals from ccollect(1)
.SH "SYNOPSIS"
\fIccollect_list_intervals\.sh\fR
.sp
\fIccollect_list_intervals\&.sh\fR
.SH "DESCRIPTION"
ccollect_list_intervals\.sh shows intervals specified in the configuration for ccollect(1)\. It displays the name of each interval, followed by a colon followed by the number backups to keep\.
.sp
ccollect_list_intervals\&.sh shows intervals specified in the configuration for ccollect(1)\&. It displays the name of each interval, followed by a colon followed by the number backups to keep\&.
.SH "FILES"
.PP
$CCOLLECT_CONF/intervals
.RS 4
Directory containing the intervals\. $CCOLLECT_CONF is
\fI/etc/ccollect\fR, if unset\.
Directory containing the intervals\&. $CCOLLECT_CONF is
\fI/etc/ccollect\fR, if unset\&.
.RE
.SH "SEE ALSO"
.sp
collect(1), ccollect_add_source(1), ccollect_analyse_logs(1), ccollect_delete_source(1), ccollect_logwrapper(1)
.sp
.SH "AUTHOR"
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\.org>
.sp
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\&.org>
.SH "RESOURCES"
Main web site: http://unix\.schottelius\.org/ccollect/
.sp
Main web site: http://www\&.nico\&.schottelius\&.org/software/ccollect/
.SH "COPYING"
Copyright (C) 2007\-2008 Nico Schottelius\. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3)\.
.sp
.SH "NOTES"
.IP " 1." 4
nico-ccollect--@--schottelius.org
.RS 4
\%mailto:nico-ccollect--@--schottelius.org
.RE
Copyright (C) 2007\-2008 Nico Schottelius\&. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3)\&.

8
software/ccollect/doc/man/ccollect_list_intervals.htm
View File

@ -1,9 +1,9 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect_list_intervals(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2503832"></a>ccollect_list_intervals(1)</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Nico</span> <span class="surname">Schottelius</span></h3><div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</code></p></div></div></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="#_files">FILES</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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_name"></a>NAME</h2></div></div></div><p>ccollect_list_intervals - list available intervals from ccollect(1)</p></div><div class="section" lang="en"><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_list_intervals.sh</em></span></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_description"></a>DESCRIPTION</h2></div></div></div><p>ccollect_list_intervals.sh shows intervals specified in the configuration
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect_list_intervals(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="article" title="ccollect_list_intervals(1)"><div class="titlepage"><div><div><h2 class="title"><a name="id509367"></a>ccollect_list_intervals(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="#_files">FILES</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_list_intervals - list available intervals from ccollect(1)</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_list_intervals.sh</em></span></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>ccollect_list_intervals.sh shows intervals specified in the configuration
for ccollect(1). It displays the name of each interval, followed by a colon
followed by the number backups to keep.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_files"></a>FILES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
followed by the number backups to keep.</p></div><div class="section" title="FILES"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_files"></a>FILES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
$CCOLLECT_CONF/intervals
</span></dt><dd>
Directory containing the intervals. $CCOLLECT_CONF is <span class="emphasis"><em>/etc/ccollect</em></span>, if unset.
</dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_see_also"></a>SEE ALSO</h2></div></div></div><p>collect(1), ccollect_add_source(1), ccollect_analyse_logs(1),
ccollect_delete_source(1), ccollect_logwrapper(1)</p></div><div class="section" lang="en"><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%E2%80%94@--schottelius.org" target="_top">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div><div class="section" lang="en"><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://unix.schottelius.org/ccollect/" target="_top">http://unix.schottelius.org/ccollect/</a></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_copying"></a>COPYING</h2></div></div></div><p>Copyright (C) 2007-2008 Nico Schottelius. Free use of this software is
</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>collect(1), ccollect_add_source(1), ccollect_analyse_logs(1),
ccollect_delete_source(1), ccollect_logwrapper(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) 2007-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>

147
software/ccollect/doc/man/ccollect_list_intervals.html
View File

@ -3,7 +3,8 @@
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.2.5" />
<meta name="generator" content="AsciiDoc 8.4.4" />
<title>ccollect_list_intervals(1)</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@ -26,10 +27,12 @@ a:visited {
em {
font-style: italic;
color: navy;
}
strong {
font-weight: bold;
color: #083194;
}
tt {
@ -71,6 +74,10 @@ p {
margin-bottom: 0.5em;
}
ul, ol, li > p {
margin-top: 0;
}
pre {
padding: 0;
margin: 0;
@ -104,11 +111,13 @@ div#footer-badges {
padding-bottom: 0.5em;
}
div#preamble,
div#preamble {
margin-top: 1.5em;
margin-bottom: 1.5em;
}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@ -123,6 +132,7 @@ div.content { /* Block element content. */
/* Block element titles. */
div.title, caption.title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
text-align: left;
@ -149,22 +159,33 @@ div.sidebarblock > div.content {
padding: 0.5em;
}
div.listingblock {
margin-right: 0%;
}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
padding: 0.5em;
}
div.quoteblock > div.content {
div.quoteblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.attribution {
div.quoteblock > div.attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.verseblock > div.content {
white-space: pre;
}
div.verseblock > div.attribution {
padding-top: 0.75em;
text-align: left;
}
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
@ -187,10 +208,6 @@ div.exampleblock > div.content {
padding: 0.5em;
}
div.verseblock div.content {
white-space: pre;
}
div.imageblock div.content { padding-left: 0; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }
@ -202,18 +219,38 @@ dl {
dt {
margin-top: 0.5em;
margin-bottom: 0;
font-style: italic;
font-style: normal;
color: navy;
}
dd > *:first-child {
margin-top: 0;
margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
div.olist2 ol {
ol.arabic {
list-style-type: decimal;
}
ol.loweralpha {
list-style-type: lower-alpha;
}
ol.upperalpha {
list-style-type: upper-alpha;
}
ol.lowerroman {
list-style-type: lower-roman;
}
ol.upperroman {
list-style-type: upper-roman;
}
div.compact ul, div.compact ol,
div.compact p, div.compact p,
div.compact div, div.compact div {
margin-top: 0.1em;
margin-bottom: 0.1em;
}
div.tableblock > table {
border: 3px solid #527bbd;
@ -225,22 +262,53 @@ thead {
tfoot {
font-weight: bold;
}
td > div.verse {
white-space: pre;
}
p.table {
margin-top: 0;
}
/* Because the table frame attribute is overriden by CSS in most browsers. */
div.tableblock > table[frame="void"] {
border-style: none;
}
div.tableblock > table[frame="hsides"] {
border-left-style: none;
border-right-style: none;
}
div.tableblock > table[frame="vsides"] {
border-top-style: none;
border-bottom-style: none;
}
div.hlist {
div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
div.hlist td {
padding-bottom: 5px;
div.hdlist tr {
padding-bottom: 15px;
}
td.hlist1 {
dt.hdlist1.strong, td.hdlist1.strong {
font-weight: bold;
}
td.hdlist1 {
vertical-align: top;
font-style: italic;
font-style: normal;
padding-right: 0.8em;
color: navy;
}
td.hlist2 {
td.hdlist2 {
vertical-align: top;
}
div.hdlist.compact tr {
margin: 0;
padding-bottom: 0;
}
.comment {
background: yellow;
}
@media print {
div#footer-badges { display: none; }
@ -279,6 +347,7 @@ div.sidebar-content {
padding: 0.5em;
}
div.sidebar-title, div.image-title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
margin-top: 0.0em;
@ -291,8 +360,17 @@ div.listingblock div.content {
padding: 0.5em;
}
div.quoteblock-content {
padding-left: 2.0em;
div.quoteblock-attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock-content {
white-space: pre;
}
div.verseblock-attribution {
padding-top: 0.75em;
text-align: left;
}
div.exampleblock-content {
@ -303,7 +381,6 @@ div.exampleblock-content {
/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
<title>ccollect_list_intervals(1)</title>
</head>
<body>
<div id="header">
@ -313,22 +390,22 @@ div#toc a:visited { color: blue; }
</div>
<h2 id="_name">1. NAME</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_list_intervals - list available intervals from ccollect(1)</p></div>
<div class="paragraph"><p>ccollect_list_intervals - list available intervals from ccollect(1)</p></div>
</div>
<h2 id="_synopsis">2. SYNOPSIS</h2>
<div class="sectionbody">
<div class="para"><p><em>ccollect_list_intervals.sh</em></p></div>
<div class="paragraph"><p><em>ccollect_list_intervals.sh</em></p></div>
</div>
<h2 id="_description">3. DESCRIPTION</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_list_intervals.sh shows intervals specified in the configuration
<div class="paragraph"><p>ccollect_list_intervals.sh shows intervals specified in the configuration
for ccollect(1). It displays the name of each interval, followed by a colon
followed by the number backups to keep.</p></div>
</div>
<h2 id="_files">4. FILES</h2>
<div class="sectionbody">
<div class="vlist"><dl>
<dt>
<div class="dlist"><dl>
<dt class="hdlist1">
$CCOLLECT_CONF/intervals
</dt>
<dd>
@ -340,25 +417,25 @@ $CCOLLECT_CONF/intervals
</div>
<h2 id="_see_also">5. SEE ALSO</h2>
<div class="sectionbody">
<div class="para"><p>collect(1), ccollect_add_source(1), ccollect_analyse_logs(1),
<div class="paragraph"><p>collect(1), ccollect_add_source(1), ccollect_analyse_logs(1),
ccollect_delete_source(1), ccollect_logwrapper(1)</p></div>
</div>
<h2 id="_author">6. AUTHOR</h2>
<div class="sectionbody">
<div class="para"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect&#8212;@--schottelius.org">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div>
<div class="paragraph"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</p></div>
</div>
<h2 id="_resources">7. RESOURCES</h2>
<div class="sectionbody">
<div class="para"><p>Main web site: <a href="http://unix.schottelius.org/ccollect/">http://unix.schottelius.org/ccollect/</a></p></div>
<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>
<h2 id="_copying">8. COPYING</h2>
<div class="sectionbody">
<div class="para"><p>Copyright (C) 2007-2008 Nico Schottelius. Free use of this software is
<div class="paragraph"><p>Copyright (C) 2007-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>
<div id="footer">
<div id="footer-text">
Last updated 2008-03-17 18:26:09 CEST
Last updated 2009-07-01 09:53:52 CEST
</div>
</div>
</body>

2
software/ccollect/doc/man/ccollect_list_intervals.text
View File

@ -39,7 +39,7 @@ Nico Schottelius <mailto:nico-ccollect--@--schottelius.org[]>
RESOURCES
---------
Main web site: http://unix.schottelius.org/ccollect/[]
Main web site: http://www.nico.schottelius.org/software/ccollect/[]
COPYING

46
software/ccollect/doc/man/ccollect_logwrapper.1
View File

@ -1,32 +1,40 @@
'\" t
.\" Title: ccollect_logwrapper
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 03/17/2008
.\" Manual:
.\" Source:
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
.\" Date: 07/01/2009
.\" Manual: [FIXME: manual]
.\" Source: [FIXME: source]
.\" Language: English
.\"
.TH "CCOLLECT_LOGWRAPPER" "1" "03/17/2008" "" ""
.TH "CCOLLECT_LOGWRAPPER" "1" "07/01/2009" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ccollect_logwrapper - start ccollect(1) and create a unique logfile
ccollect_logwrapper \- start ccollect(1) and create a unique logfile
.SH "SYNOPSIS"
\fIccollect_logwrapper\.sh\fR <ccollect options>
.sp
\fIccollect_logwrapper\&.sh\fR <ccollect options>
.SH "DESCRIPTION"
ccollect_logwrapper\.sh creates a unique logfile below \fI$CCOLLECT_CONF/logwrapper\fR and redirects ccollect(1) output (stdout and stderr) to it\.
.sp
ccollect_logwrapper\&.sh creates a unique logfile below \fI$CCOLLECT_CONF/logwrapper\fR and redirects ccollect(1) output (stdout and stderr) to it\&.
.SH "OPTIONS"
Options are passed directly to ccollect(1)\.
.sp
Options are passed directly to ccollect(1)\&.
.SH "FILES"
.PP
$CCOLLECT_CONF/logwrapper
.RS 4
Directory containing the configuration\. $CCOLLECT_CONF is
\fI/etc/ccollect\fR, if unset\.
Directory containing the configuration\&. $CCOLLECT_CONF is
\fI/etc/ccollect\fR, if unset\&.
.RE
.PP
$CCOLLECT_CONF/logwrapper/destination
@ -34,20 +42,14 @@ $CCOLLECT_CONF/logwrapper/destination
Link to the destination directory for the logfiles
.RE
.SH "SEE ALSO"
.sp
ccollect(1), ccollect_add_source(1), ccollect_analyse_logs(1), ccollect_delete_source(1), ccollect_list_intervals(1)
.sp
.SH "AUTHOR"
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\.org>
.sp
Nico Schottelius <nico\-ccollect\-\-@\-\-schottelius\&.org>
.SH "RESOURCES"
Main web site: http://unix\.schottelius\.org/ccollect/
.sp
Main web site: http://www\&.nico\&.schottelius\&.org/software/ccollect/
.SH "COPYING"
Copyright (C) 2007\-2008 Nico Schottelius\. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3)\.
.sp
.SH "NOTES"
.IP " 1." 4
nico-ccollect--@--schottelius.org
.RS 4
\%mailto:nico-ccollect--@--schottelius.org
.RE
Copyright (C) 2007\-2008 Nico Schottelius\&. Free use of this software is granted under the terms of the GNU General Public License Version 3 (GPLv3)\&.

8
software/ccollect/doc/man/ccollect_logwrapper.htm
View File

@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect_logwrapper(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2504039"></a>ccollect_logwrapper(1)</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Nico</span> <span class="surname">Schottelius</span></h3><div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</code></p></div></div></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="#_files">FILES</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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_name"></a>NAME</h2></div></div></div><p>ccollect_logwrapper - start ccollect(1) and create a unique logfile</p></div><div class="section" lang="en"><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_logwrapper.sh</em></span> &lt;ccollect options&gt;</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_description"></a>DESCRIPTION</h2></div></div></div><p>ccollect_logwrapper.sh creates a unique logfile below
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ccollect_logwrapper(1)</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="article" title="ccollect_logwrapper(1)"><div class="titlepage"><div><div><h2 class="title"><a name="id572855"></a>ccollect_logwrapper(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="#_files">FILES</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_logwrapper - start ccollect(1) and create a unique logfile</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_logwrapper.sh</em></span> &lt;ccollect options&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>ccollect_logwrapper.sh creates a unique logfile below
<span class="emphasis"><em>$CCOLLECT_CONF/logwrapper</em></span> and redirects ccollect(1) output
(stdout and stderr) to it.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_options"></a>OPTIONS</h2></div></div></div><p>Options are passed directly to ccollect(1).</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_files"></a>FILES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
(stdout and stderr) to it.</p></div><div class="section" title="OPTIONS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_options"></a>OPTIONS</h2></div></div></div><p>Options are passed directly to ccollect(1).</p></div><div class="section" title="FILES"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_files"></a>FILES</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
$CCOLLECT_CONF/logwrapper
</span></dt><dd>
Directory containing the configuration. $CCOLLECT_CONF is <span class="emphasis"><em>/etc/ccollect</em></span>, if unset.
@ -8,6 +8,6 @@ $CCOLLECT_CONF/logwrapper
$CCOLLECT_CONF/logwrapper/destination
</span></dt><dd>
Link to the destination directory for the logfiles
</dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_see_also"></a>SEE ALSO</h2></div></div></div><p>ccollect(1), ccollect_add_source(1), ccollect_analyse_logs(1),
ccollect_delete_source(1), ccollect_list_intervals(1)</p></div><div class="section" lang="en"><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%E2%80%94@--schottelius.org" target="_top">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div><div class="section" lang="en"><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://unix.schottelius.org/ccollect/" target="_top">http://unix.schottelius.org/ccollect/</a></p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="_copying"></a>COPYING</h2></div></div></div><p>Copyright (C) 2007-2008 Nico Schottelius. Free use of this software is
</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(1), ccollect_add_source(1), ccollect_analyse_logs(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) 2007-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>

151
software/ccollect/doc/man/ccollect_logwrapper.html
View File

@ -3,7 +3,8 @@
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.2.5" />
<meta name="generator" content="AsciiDoc 8.4.4" />
<title>ccollect_logwrapper(1)</title>
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@ -26,10 +27,12 @@ a:visited {
em {
font-style: italic;
color: navy;
}
strong {
font-weight: bold;
color: #083194;
}
tt {
@ -71,6 +74,10 @@ p {
margin-bottom: 0.5em;
}
ul, ol, li > p {
margin-top: 0;
}
pre {
padding: 0;
margin: 0;
@ -104,11 +111,13 @@ div#footer-badges {
padding-bottom: 0.5em;
}
div#preamble,
div#preamble {
margin-top: 1.5em;
margin-bottom: 1.5em;
}
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
margin-right: 10%;
margin-top: 1.5em;
margin-bottom: 1.5em;
}
@ -123,6 +132,7 @@ div.content { /* Block element content. */
/* Block element titles. */
div.title, caption.title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
text-align: left;
@ -149,22 +159,33 @@ div.sidebarblock > div.content {
padding: 0.5em;
}
div.listingblock {
margin-right: 0%;
}
div.listingblock > div.content {
border: 1px solid silver;
background: #f4f4f4;
padding: 0.5em;
}
div.quoteblock > div.content {
div.quoteblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.attribution {
div.quoteblock > div.attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock {
padding-left: 2.0em;
margin-right: 10%;
}
div.verseblock > div.content {
white-space: pre;
}
div.verseblock > div.attribution {
padding-top: 0.75em;
text-align: left;
}
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
@ -187,10 +208,6 @@ div.exampleblock > div.content {
padding: 0.5em;
}
div.verseblock div.content {
white-space: pre;
}
div.imageblock div.content { padding-left: 0; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }
@ -202,18 +219,38 @@ dl {
dt {
margin-top: 0.5em;
margin-bottom: 0;
font-style: italic;
font-style: normal;
color: navy;
}
dd > *:first-child {
margin-top: 0;
margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
div.olist2 ol {
ol.arabic {
list-style-type: decimal;
}
ol.loweralpha {
list-style-type: lower-alpha;
}
ol.upperalpha {
list-style-type: upper-alpha;
}
ol.lowerroman {
list-style-type: lower-roman;
}
ol.upperroman {
list-style-type: upper-roman;
}
div.compact ul, div.compact ol,
div.compact p, div.compact p,
div.compact div, div.compact div {
margin-top: 0.1em;
margin-bottom: 0.1em;
}
div.tableblock > table {
border: 3px solid #527bbd;
@ -225,22 +262,53 @@ thead {
tfoot {
font-weight: bold;
}
td > div.verse {
white-space: pre;
}
p.table {
margin-top: 0;
}
/* Because the table frame attribute is overriden by CSS in most browsers. */
div.tableblock > table[frame="void"] {
border-style: none;
}
div.tableblock > table[frame="hsides"] {
border-left-style: none;
border-right-style: none;
}
div.tableblock > table[frame="vsides"] {
border-top-style: none;
border-bottom-style: none;
}
div.hlist {
div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
div.hlist td {
padding-bottom: 5px;
div.hdlist tr {
padding-bottom: 15px;
}
td.hlist1 {
dt.hdlist1.strong, td.hdlist1.strong {
font-weight: bold;
}
td.hdlist1 {
vertical-align: top;
font-style: italic;
font-style: normal;
padding-right: 0.8em;
color: navy;
}
td.hlist2 {
td.hdlist2 {
vertical-align: top;
}
div.hdlist.compact tr {
margin: 0;
padding-bottom: 0;
}
.comment {
background: yellow;
}
@media print {
div#footer-badges { display: none; }
@ -279,6 +347,7 @@ div.sidebar-content {
padding: 0.5em;
}
div.sidebar-title, div.image-title {
color: #527bbd;
font-family: sans-serif;
font-weight: bold;
margin-top: 0.0em;
@ -291,8 +360,17 @@ div.listingblock div.content {
padding: 0.5em;
}
div.quoteblock-content {
padding-left: 2.0em;
div.quoteblock-attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock-content {
white-space: pre;
}
div.verseblock-attribution {
padding-top: 0.75em;
text-align: left;
}
div.exampleblock-content {
@ -303,7 +381,6 @@ div.exampleblock-content {
/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
<title>ccollect_logwrapper(1)</title>
</head>
<body>
<div id="header">
@ -313,26 +390,26 @@ div#toc a:visited { color: blue; }
</div>
<h2 id="_name">1. NAME</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_logwrapper - start ccollect(1) and create a unique logfile</p></div>
<div class="paragraph"><p>ccollect_logwrapper - start ccollect(1) and create a unique logfile</p></div>
</div>
<h2 id="_synopsis">2. SYNOPSIS</h2>
<div class="sectionbody">
<div class="para"><p><em>ccollect_logwrapper.sh</em> &lt;ccollect options&gt;</p></div>
<div class="paragraph"><p><em>ccollect_logwrapper.sh</em> &lt;ccollect options&gt;</p></div>
</div>
<h2 id="_description">3. DESCRIPTION</h2>
<div class="sectionbody">
<div class="para"><p>ccollect_logwrapper.sh creates a unique logfile below
<div class="paragraph"><p>ccollect_logwrapper.sh creates a unique logfile below
<em>$CCOLLECT_CONF/logwrapper</em> and redirects ccollect(1) output
(stdout and stderr) to it.</p></div>
</div>
<h2 id="_options">4. OPTIONS</h2>
<div class="sectionbody">
<div class="para"><p>Options are passed directly to ccollect(1).</p></div>
<div class="paragraph"><p>Options are passed directly to ccollect(1).</p></div>
</div>
<h2 id="_files">5. FILES</h2>
<div class="sectionbody">
<div class="vlist"><dl>
<dt>
<div class="dlist"><dl>
<dt class="hdlist1">
$CCOLLECT_CONF/logwrapper
</dt>
<dd>
@ -340,7 +417,7 @@ $CCOLLECT_CONF/logwrapper
Directory containing the configuration. $CCOLLECT_CONF is <em>/etc/ccollect</em>, if unset.
</p>
</dd>
<dt>
<dt class="hdlist1">
$CCOLLECT_CONF/logwrapper/destination
</dt>
<dd>
@ -352,25 +429,25 @@ $CCOLLECT_CONF/logwrapper/destination
</div>
<h2 id="_see_also">6. SEE ALSO</h2>
<div class="sectionbody">
<div class="para"><p>ccollect(1), ccollect_add_source(1), ccollect_analyse_logs(1),
<div class="paragraph"><p>ccollect(1), ccollect_add_source(1), ccollect_analyse_logs(1),
ccollect_delete_source(1), ccollect_list_intervals(1)</p></div>
</div>
<h2 id="_author">7. AUTHOR</h2>
<div class="sectionbody">
<div class="para"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect&#8212;@--schottelius.org">nico-ccollect&#8212;@--schottelius.org</a>&gt;</p></div>
<div class="paragraph"><p>Nico Schottelius &lt;<a href="mailto:nico-ccollect--@--schottelius.org">nico-ccollect--@--schottelius.org</a>&gt;</p></div>
</div>
<h2 id="_resources">8. RESOURCES</h2>
<div class="sectionbody">
<div class="para"><p>Main web site: <a href="http://unix.schottelius.org/ccollect/">http://unix.schottelius.org/ccollect/</a></p></div>
<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>
<h2 id="_copying">9. COPYING</h2>
<div class="sectionbody">
<div class="para"><p>Copyright (C) 2007-2008 Nico Schottelius. Free use of this software is
<div class="paragraph"><p>Copyright (C) 2007-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>
<div id="footer">
<div id="footer-text">
Last updated 2008-03-17 18:26:08 CEST
Last updated 2009-07-01 09:53:52 CEST
</div>
</div>
</body>

2
software/ccollect/doc/man/ccollect_logwrapper.text
View File

@ -47,7 +47,7 @@ Nico Schottelius <mailto:nico-ccollect--@--schottelius.org[]>
RESOURCES
---------
Main web site: http://unix.schottelius.org/ccollect/[]
Main web site: http://www.nico.schottelius.org/software/ccollect/[]
COPYING