Blob Blame History Raw
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>bf_tar</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="bf_tar.1"></a><div class="titlepage"></div><div class="refnamediv"><a name="name"></a><h2>Name</h2><p>bf_tar &#8212; shell script to write a tar file of a
	    <span class="application">bogofilter</span> directory to stdout</p></div><div class="refsynopsisdiv"><a name="synopsis"></a><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">bf_tar</code>  [-r] [-R]  <em class="replaceable"><code>bogofilter_directory</code></em> </p></div></div><div class="refsect1"><a name="description"></a><h2>Description</h2><p><span class="command"><strong>bf_tar</strong></span> bundles a <span class="application">bogofilter</span>
	    working directory in tar format and copies it to
	    standard output (your console, or where you redirect it, see
	    <a class="link" href="#examples" title="Examples">EXAMPLES</a> below).</p></div><div class="refsect1"><a name="options"></a><h2>Options</h2><p>The <code class="option">-r</code> option causes <span class="command"><strong>bf_tar</strong></span> to remove
	    inactive log files after the archive has been written
	    successfully. The default is to leave log files.</p><p>The <code class="option">-R</code> option causes <span class="command"><strong>bf_tar</strong></span> to remove
	    inactive log files before the archive is written. This may
	    reduce chances that the resulting archive is recoverable
	    should it become damaged. The archive may be smaller
	    though. The default is to leave log files.</p></div><div class="refsect1"><a name="exitstatus"></a><h2>Exit Status</h2><p>The script exits with status code 0 if everything went
	    well, and nonzero if it encountered trouble.</p></div><div class="refsect1"><a name="examples"></a><h2>Examples</h2><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><strong class="userinput"><code>bf_tar ~/.bogofilter &gt; outfile.tar</code></strong></p><p>Writes a standard .tar file containing the essential files
		from <code class="filename">~/.bogofilter</code> to
		<code class="filename">outfile.tar</code>.</p></li><li class="listitem"><p><strong class="userinput"><code>bf_tar ~/.bogofilter | gzip -9 -c &gt;
		outfile.tar.gz</code></strong></p><p>Writes a gzipped .tar.gz file containing the essential files
		from <code class="filename">~/.bogofilter</code> to
		<code class="filename">outfile.tar.gz</code>.</p></li><li class="listitem"><p><strong class="userinput"><code>bf_tar `pwd`/mydirectory
		&gt; outfile.tar</code></strong></p><p>Prepend <strong class="userinput"><code>$(pwd)/</code></strong> or
		<strong class="userinput"><code>`pwd`/</code></strong> if you want to specify an
		absolute path instead of a relative path.</p></li></ul></div></div><div class="refsect1"><a name="notes"></a><h2>Notes</h2><p>This script is meant for use with Berkeley DB based
	    <span class="application">bogofilter</span> versions.</p><p>This script requires a SUSv2 compliant
	    <span class="command"><strong>pax</strong></span> utility.</p><p>This script expects a SUSv2 compliant shell.  Solaris
	    systems should have the <code class="systemitem">SUNWxcu4</code> package
	    installed (when <span class="application">bogofilter</span> is configured)
	    so that <code class="filename">/usr/xpg4/bin/sh</code> can be used.</p></div><div class="refsect1"><a name="authors"></a><h2>Authors</h2><p><span class="author"><span class="firstname">Matthias</span> <span class="surname">Andree</span></span></p></div></div></body></html>