[Sblim-commit] gather/man gatherctl.8.xml.pre.in, NONE, 1.1 gatherd.8.xml.pre.in, NONE, 1.1 gatherd

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/sblim/gather/man
In directory vz-cvs-3.sog:/tmp/cvs-serv3513/man

Added Files:
	gatherctl.8.xml.pre.in gatherd.8.xml.pre.in 
	gatherd.conf.5.xml.pre.in reposctl.8.xml.pre.in 
	reposd.8.xml.pre.in reposd.conf.5.xml.pre.in 
Log Message:
Fixed 3019058: add man pages/help for gatherd and reposd

--- NEW FILE: gatherd.8.xml.pre.in ---
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<refentry id="gatherd">

<refentryinfo>
<productname>@PACKAGE_NAME@-@PACKAGE_VERSION@</productname>
</refentryinfo>

<refmeta>
<refentrytitle>gatherd</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo class="manual">Linux Programmer's Manual</refmiscinfo>
</refmeta>

<refnamediv>
<refname>gatherd</refname>
<refpurpose>SBLIM metric collection daemon</refpurpose>
<refclass>UNIX/Linux</refclass>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>gatherd</command>
<arg choice="opt"><replaceable>argument</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title>Description</title>
<para>
The <command>gatherd</command> program is a system daemon that collects 
performance metrics for various components via a set of metric plugins. 
Raw metric data is forwarded to a seperate repository daemon 
that is located either locally or remotely
(see <citerefentry><refentrytitle>reposd</refentrytitle>
<manvolnum>8</manvolnum></citerefentry>).
The repository destination, location of plugin directory, and 
other controllable configuration options are described in the configuration 
file man page (see <citerefentry>
<refentrytitle>gatherd.conf</refentrytitle>
<manvolnum>5</manvolnum></citerefentry>).
</para>
<para>
The <command>gatherd</command> daemon can be controlled at runtime by way of the
<citerefentry><refentrytitle>gatherctl</refentrytitle><manvolnum>8</manvolnum>
</citerefentry> command. This provides the ability to load and unload metric 
plugins online without the need to restart <command>gatherd</command>.
</para>
<para>
The primary goal of the the sblim-gather package is to implement the DMTF's Base 
Metric Model (DSP1053). While, <command>gatherd</command>, 
<citerefentry><refentrytitle>reposd</refentrytitle>
<manvolnum>8</manvolnum></citerefentry>, and their plugins can be used standalone, 
the greatest benefit comes from using their CIM provider layer in conjuction with 
a CIM Object Manager (see <citerefentry><refentrytitle>cimserver</refentrytitle>
<manvolnum>1</manvolnum></citerefentry>). For more information about CIM and the Base
Metric Model refer to the Distrubuted Management Task Force (DMTF) at http://www.dmtf.org.
</para>
</refsect1>

<refsect1>
<title>Options</title>
<variablelist>
<varlistentry>
<term><option><replaceable>argument</replaceable></option></term>
<listitem>
<para><command>gatherd</command> daemonizes by default. Passing any value on the
command line will cause it to run in the terminal.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Files</title>
<variablelist>
<varlistentry>
<term><replaceable>@sysconfdir@/gatherd.conf</replaceable></term>
<listitem>
<para>This file contains the daemon configuration settings. See
<citerefentry>
<refentrytitle>gatherd.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry> for more information.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Bugs</title>
<para>The SBLIM project maintains a mailing list to which you should direct all
questions regarding sfcb, sfcc, wbemcli, the metric data gatherer, or any of the 
SBLIM providers. To subscribe to this list visit:

<screen><![CDATA[https://lists.sourceforge.net/lists/listinfo/sblim-issues]]></screen>
</para>

<para>Please report bugs you discover to the bug tracker. The SBLIM project bug 
tracking page can be found at:

<screen><![CDATA[https://sourceforge.net/tracker/?group_id=128809&atid=712784]]></screen>
</para>
</refsect1>

<refsect1>
<title>Authors</title>
<para>Please refer to the AUTHORS file distributed with sblim-gather.</para>
</refsect1>

<refsect1>
<title>Copyright</title>
<para>Copyright Â© 2003-2012 IBM Corp.</para>
</refsect1>

<refsect1>
<title>License</title>
<para><command>gatherd</command> is distributed under the terms of the Eclipse
Public License ("Agreement"). Any use, reproduction or distribution of this
program constitutes recipeients acceptance of the agreement.</para>

<para>You can obtain a current copy of the Eclipse Public License from
http://www.opensource.org/licenses/eclipse-1.0.php</para>
</refsect1>

<refsect1>
<title>See Also</title>
<para>
<citerefentry>
<refentrytitle>gatherctl</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>gatherd.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>reposd</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>cimserver</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>
</para>
</refsect1>

</refentry>

--- NEW FILE: reposd.8.xml.pre.in ---
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<refentry id="reposd">

<refentryinfo>
<productname>@PACKAGE_NAME@-@PACKAGE_VERSION@</productname>
</refentryinfo>

<refmeta>
<refentrytitle>reposd</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo class="manual">Linux Programmer's Manual</refmiscinfo>
</refmeta>

<refnamediv>
<refname>reposd</refname>
<refpurpose>SBLIM metric repository daemon</refpurpose>
<refclass>UNIX/Linux</refclass>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>reposd</command>
<arg choice="opt"><replaceable>argument</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title>Description</title>
<para>
The <command>reposd</command> program is a system daemon that maintains
a temporary repository of raw performance metrics for various system components. 
Raw metric data is forwarded from a seperate collection daemon 
that is located either locally or remotely
(see <citerefentry><refentrytitle>gatherd</refentrytitle>
<manvolnum>8</manvolnum></citerefentry>). The calculation of usable metrics
from raw data is performed via repository metric plugins. 
The repository communication port, location of plugin directory, and 
other controllable configuration options are described in the configuration 
file man page (see <citerefentry>
<refentrytitle>reposd.conf</refentrytitle>
<manvolnum>5</manvolnum></citerefentry>).
</para>
<para>
The <command>reposd</command> daemon can be controlled at runtime by way of the
<citerefentry><refentrytitle>reposctl</refentrytitle><manvolnum>8</manvolnum>
</citerefentry> command. This provides the ability to query metric values or
load and unload metric plugins online without the need to restart <command>reposd</command>.
</para>
<para>
The primary goal of the the sblim-gather package is to implement the DMTF's Base 
Metric Model (DSP1053). While, <command>reposd</command>, 
<citerefentry><refentrytitle>gatherd</refentrytitle>
<manvolnum>8</manvolnum></citerefentry>, and their plugins can be used standalone, 
the greatest benefit comes from using their CIM provider layer in conjuction with 
a CIM Object Manager (see <citerefentry><refentrytitle>cimserver</refentrytitle>
<manvolnum>1</manvolnum></citerefentry>). For more information about CIM and the Base
Metric Model refer to the Distrubuted Management Task Force (DMTF) at http://www.dmtf.org.
</para>
</refsect1>

<refsect1>
<title>Options</title>
<variablelist>
<varlistentry>
<term><option><replaceable>argument</replaceable></option></term>
<listitem>
<para><command>reposd</command> daemonizes by default. Passing any value on the
command line will cause it to run in the terminal.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Files</title>
<variablelist>
<varlistentry>
<term><replaceable>@sysconfdir@/reposd.conf</replaceable></term>
<listitem>
<para>This file contains the daemon configuration settings. See
<citerefentry>
<refentrytitle>reposd.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry> for more information.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Bugs</title>
<para>The SBLIM project maintains a mailing list to which you should direct all
questions regarding sfcb, sfcc, wbemcli, the metric data gatherer, or any of the 
SBLIM providers. To subscribe to this list visit:

<screen><![CDATA[https://lists.sourceforge.net/lists/listinfo/sblim-issues]]></screen>
</para>

<para>Please report bugs you discover to the bug tracker. The SBLIM project bug 
tracking page can be found at:

<screen><![CDATA[https://sourceforge.net/tracker/?group_id=128809&atid=712784]]></screen>
</para>
</refsect1>

<refsect1>
<title>Authors</title>
<para>Please refer to the AUTHORS file distributed with sblim-gather.</para>
</refsect1>

<refsect1>
<title>Copyright</title>
<para>Copyright Â© 2003-2012 IBM Corp.</para>
</refsect1>

<refsect1>
<title>License</title>
<para><command>reposd</command> is distributed under the terms of the Eclipse
Public License ("Agreement"). Any use, reproduction or distribution of this
program constitutes recipeients acceptance of the agreement.</para>

<para>You can obtain a current copy of the Eclipse Public License from
http://www.opensource.org/licenses/eclipse-1.0.php</para>
</refsect1>

<refsect1>
<title>See Also</title>
<para>
<citerefentry>
<refentrytitle>reposctl</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>reposd.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>gatherd</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>cimserver</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>
</para>
</refsect1>

</refentry>

--- NEW FILE: reposctl.8.xml.pre.in ---
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<refentry id="reposctl">

<refentryinfo>
<productname>@PACKAGE_NAME@-@PACKAGE_VERSION@</productname>
</refentryinfo>

<refmeta>
<refentrytitle>reposctl</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo class="manual">Linux Programmer's Manual</refmiscinfo>
</refmeta>

<refnamediv>
<refname>reposctl</refname>
<refpurpose>control utility for reposd</refpurpose>
<refclass>UNIX/Linux</refclass>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>reposctl</command>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title>Description</title>
<para>
<command>reposctl</command> is a simple shell program for controling the 
<citerefentry>
<refentrytitle>reposd</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>
metric repository daemon. It provides the ability to manipulate the state of 
the daemon as well as online loading and unloading of metric repository plugins.
</para>
</refsect1>

<refsect1>
<title>Commands</title>
<variablelist>
<varlistentry>
<term><option>h</option></term>
<listitem><para>print help message</para></listitem>
</varlistentry>
<varlistentry>
<term><option>s</option></term>
<listitem><para>print status of daemon</para></listitem>
</varlistentry>
<varlistentry>
<term><option>i</option></term>
<listitem><para>initialize repository service</para></listitem>
</varlistentry>
<varlistentry>
<term><option>t</option></term>
<listitem><para>terminate repository service</para></listitem>
</varlistentry>
<varlistentry>
<term><option>l</option> <replaceable>pluginlib</replaceable></term>
<listitem><para>load plugin library</para></listitem>
</varlistentry>
<varlistentry>
<term><option>u</option> <replaceable>pluginlib</replaceable></term>
<listitem><para>unload plugin library</para></listitem>
</varlistentry>
<varlistentry>
<term><option>v</option> <replaceable>pluginlib</replaceable></term>
<listitem><para>view/list metrics supported by plugin library</para></listitem>
</varlistentry>
<varlistentry>
<term><option>q</option></term>
<listitem><para>quit/exit control utility</para></listitem>
</varlistentry>
<varlistentry>
<term><option>g</option> <replaceable>id</replaceable></term>
<listitem><para>retrieve values for given metric id</para></listitem>
</varlistentry>
<varlistentry>
<term><option>f</option> <replaceable>id</replaceable> <replaceable>num</replaceable></term>
<listitem><para>retrieve filtered (top-n, sorted) values for given metric id</para></listitem>
</varlistentry>
<varlistentry>
<term><option>r</option> <replaceable>id</replaceable></term>
<listitem><para>list system and type of resource for given metrid id</para></listitem>
</varlistentry>
<varlistentry>
<term><option>G</option></term>
<listitem><para>list current global metric filter</para></listitem>
</varlistentry>
<varlistentry>
<term><option>F</option> <replaceable>num</replaceable></term>
<listitem><para>set the global metric filter</para></listitem>
</varlistentry>
<varlistentry>
<term><option>k</option></term>
<listitem><para>kill gathering daemon</para></listitem>
</varlistentry>
<varlistentry>
<term><option>d</option></term>
<listitem><para>start gathering daemon</para></listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Files</title>
<variablelist>
<varlistentry>
<term><replaceable>@sysconfdir@/reposd.conf</replaceable></term>
<listitem>
<para>This file contains the daemon configuration settings. See
<citerefentry>
<refentrytitle>reposd.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry> for more information.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Bugs</title>
<para>The SBLIM project maintains a mailing list to which you should direct all
questions regarding sfcb, sfcc, wbemcli, the metric data gatherer, or any of the 
SBLIM providers. To subscribe to this list visit:

<screen><![CDATA[https://lists.sourceforge.net/lists/listinfo/sblim-issues]]></screen>
</para>

<para>Please report bugs you discover to the bug tracker. The SBLIM project bug 
tracking page can be found at:

<screen><![CDATA[https://sourceforge.net/tracker/?group_id=128809&atid=712784]]></screen>
</para>
</refsect1>

<refsect1>
<title>Authors</title>
<para>Please refer to the AUTHORS file distributed with sblim-gather.</para>
</refsect1>

<refsect1>
<title>Copyright</title>
<para>Copyright Â© 2003-2012 IBM Corp.</para>
</refsect1>

<refsect1>
<title>License</title>
<para><command>reposctl</command> is distributed under the terms of the Eclipse
Public License ("Agreement"). Any use, reproduction or distribution of this
program constitutes recipeients acceptance of the agreement.</para>

<para>You can obtain a current copy of the Eclipse Public License from
http://www.opensource.org/licenses/eclipse-1.0.php</para>
</refsect1>

<refsect1>
<title>See Also</title>
<para>
<citerefentry>
<refentrytitle>reposd</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>reposd.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry>,
</para>
</refsect1>

</refentry>

--- NEW FILE: gatherctl.8.xml.pre.in ---
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<refentry id="gatherctl">

<refentryinfo>
<productname>@PACKAGE_NAME@-@PACKAGE_VERSION@</productname>
</refentryinfo>

<refmeta>
<refentrytitle>gatherctl</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo class="manual">Linux Programmer's Manual</refmiscinfo>
</refmeta>

<refnamediv>
<refname>gatherctl</refname>
<refpurpose>control utility for gatherd</refpurpose>
<refclass>UNIX/Linux</refclass>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>gatherctl</command>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title>Description</title>
<para>
<command>gatherctl</command> is a simple shell program for controling the 
<citerefentry>
<refentrytitle>gatherd</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>
metric collection daemon. It provides the ability to manipulate the state of 
the daemon as well as online loading and unloading of metric collection plugins.
</para>
</refsect1>

<refsect1>
<title>Commands</title>
<variablelist>
<varlistentry>
<term><option>h</option></term>
<listitem><para>print help message</para></listitem>
</varlistentry>
<varlistentry>
<term><option>s</option></term>
<listitem><para>print status of daemon</para></listitem>
</varlistentry>
<varlistentry>
<term><option>i</option></term>
<listitem><para>initialize gathering service</para></listitem>
</varlistentry>
<varlistentry>
<term><option>t</option></term>
<listitem><para>terminate gathering service</para></listitem>
</varlistentry>
<varlistentry>
<term><option>b</option></term>
<listitem><para>start sampling plugins</para></listitem>
</varlistentry>
<varlistentry>
<term><option>e</option></term>
<listitem><para>stop sampling plugins</para></listitem>
</varlistentry>
<varlistentry>
<term><option>l</option> <replaceable>pluginlib</replaceable></term>
<listitem><para>load plugin library</para></listitem>
</varlistentry>
<varlistentry>
<term><option>u</option> <replaceable>pluginlib</replaceable></term>
<listitem><para>unload plugin library</para></listitem>
</varlistentry>
<varlistentry>
<term><option>v</option> <replaceable>pluginlib</replaceable></term>
<listitem><para>view/list metrics supported by plugin library</para></listitem>
</varlistentry>
<varlistentry>
<term><option>q</option></term>
<listitem><para>quit/exit control utility</para></listitem>
</varlistentry>
<varlistentry>
<term><option>k</option></term>
<listitem><para>kill gathering daemon</para></listitem>
</varlistentry>
<varlistentry>
<term><option>d</option></term>
<listitem><para>start gathering daemon</para></listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Files</title>
<variablelist>
<varlistentry>
<term><replaceable>@sysconfdir@/gatherd.conf</replaceable></term>
<listitem>
<para>This file contains the daemon configuration settings. See
<citerefentry>
<refentrytitle>gatherd.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry> for more information.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Bugs</title>
<para>The SBLIM project maintains a mailing list to which you should direct all
questions regarding sfcb, sfcc, wbemcli, the metric data gatherer, or any of the 
SBLIM providers. To subscribe to this list visit:

<screen><![CDATA[https://lists.sourceforge.net/lists/listinfo/sblim-issues]]></screen>
</para>

<para>Please report bugs you discover to the bug tracker. The SBLIM project bug 
tracking page can be found at:

<screen><![CDATA[https://sourceforge.net/tracker/?group_id=128809&atid=712784]]></screen>
</para>
</refsect1>

<refsect1>
<title>Authors</title>
<para>Please refer to the AUTHORS file distributed with sblim-gather.</para>
</refsect1>

<refsect1>
<title>Copyright</title>
<para>Copyright Â© 2003-2012 IBM Corp.</para>
</refsect1>

<refsect1>
<title>License</title>
<para><command>gatherctl</command> is distributed under the terms of the Eclipse
Public License ("Agreement"). Any use, reproduction or distribution of this
program constitutes recipeients acceptance of the agreement.</para>

<para>You can obtain a current copy of the Eclipse Public License from
http://www.opensource.org/licenses/eclipse-1.0.php</para>
</refsect1>

<refsect1>
<title>See Also</title>
<para>
<citerefentry>
<refentrytitle>gatherd</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>gatherd.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry>,
</para>
</refsect1>

</refentry>

--- NEW FILE: gatherd.conf.5.xml.pre.in ---
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<refentry id="gatherd.conf">

<refentryinfo>
<productname>@PACKAGE_NAME@-@PACKAGE_VERSION@</productname>
</refentryinfo>

<refmeta>
<refentrytitle>gatherd.conf</refentrytitle>
<manvolnum>5</manvolnum>
<refmiscinfo class="manual">Linux Programmer's Manual</refmiscinfo>
</refmeta>

<refnamediv>
<refname>gatherd.conf</refname>
<refpurpose>SBLIM metric repository daemon configuration file</refpurpose>
<refclass>UNIX/Linux</refclass>
</refnamediv>

<refsect1>
<title>Description</title>
<para>
The file <replaceable>gatherd.conf</replaceable> is read by <citerefentry>
<refentrytitle>gatherd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
at startup. Each line consists of a configuration option value pair delimited
by an '=' character. A '#' (number sign) indicates the beginning of a comment.
</para>
</refsect1>

<refsect1>
<title>Options</title>
<variablelist>
<varlistentry>
<term><option>RepositoryHost</option>=<replaceable>addr</replaceable></term>
<listitem>
<para>The ip address of the remote repository daemon to which metric values will
be sent. Default is <command>localhost</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>RepositoryPort</option>=<replaceable>port</replaceable></term>
<listitem>
<para>TCP port of remote repository daemon. Default is <command>6363</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>TraceLevel</option>=<replaceable>level</replaceable></term>
<listitem>
<para>Trace level for the <command>gatherd</command> process. Default is
<command>0</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>TraceFile</option>=<replaceable>file</replaceable></term>
<listitem>
<para>Name of file to write tracing information. Default is
<command>stderr</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>TraceComponents</option>=<replaceable>comps[:comps...]</replaceable></term>
<listitem>
<para>Gatherer components to be traced seperated by a colon (:).
Valid components are: comm, util, gather, rrepos. Default is <command>none</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>PluginDirectory</option>=<replaceable>dir</replaceable></term>
<listitem>
<para>Directory where metric collection plugins are located. Default is
<command>@libdir@/gather/mplug</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>AutoLoad</option>=<replaceable>plugin[:plugin...]</replaceable></term>
<listitem>
<para>Plugins to automatically load, initalize and start sampling. Valid values are:
* or colon-seperated list. Default is <command>none</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>SampleInterval</option>=<replaceable>secs</replaceable></term>
<listitem>
<para>If specified this interval will override the plugin defined individual
sampling intervals. Unit is in seconds.</para>
<para><command>WARNING:</command> This config option should only be used for
debugging purposes. It overrides the per metric defined sample interval of all
plugins, and really short intervals can introduce skew in the data due to seconds
not being a high enough sample resolution.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>Synchronization</option>=<replaceable>0|1</replaceable></term>
<listitem>
<para>Specifies whether the metric plugins are invoked in a time-synchronized
manner. Synchronized metrics with the same sample interval will be scheduled
together. Possible values are:</para>
<screen><![CDATA[1 synchronized relative to Jan, 1st, 1970, 00:00]]></screen>
<screen><![CDATA[0 unsynchronized, will be scheduled asap]]></screen>
<para>Default is <command>1</command>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Bugs</title>
<para>The SBLIM project maintains a mailing list to which you should direct all
questions regarding sfcb, sfcc, wbemcli, the metric data gatherer, or any of the 
SBLIM providers. To subscribe to this list visit:

<screen><![CDATA[https://lists.sourceforge.net/lists/listinfo/sblim-issues]]></screen>
</para>

<para>Please report bugs you discover to the bug tracker. The SBLIM project bug 
tracking page can be found at:

<screen><![CDATA[https://sourceforge.net/tracker/?group_id=128809&atid=712784]]></screen>
</para>
</refsect1>

<refsect1>
<title>Authors</title>
<para>Please refer to the AUTHORS file distributed with sblim-gather.</para>
</refsect1>

<refsect1>
<title>Copyright</title>
<para>Copyright Â© 2003-2012 IBM Corp.</para>
</refsect1>

<refsect1>
<title>License</title>
<para><command>gatherd.conf</command> is distributed under the terms of the Eclipse
Public License ("Agreement"). Any use, reproduction or distribution of this
program constitutes recipeients acceptance of the agreement.</para>

<para>You can obtain a current copy of the Eclipse Public License from
http://www.opensource.org/licenses/eclipse-1.0.php</para>
</refsect1>

<refsect1>
<title>See Also</title>
<para>
<citerefentry>
<refentrytitle>gatherd</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>
</para>
</refsect1>

</refentry>

--- NEW FILE: reposd.conf.5.xml.pre.in ---
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<refentry id="reposd.conf">

<refentryinfo>
<productname>@PACKAGE_NAME@-@PACKAGE_VERSION@</productname>
</refentryinfo>

<refmeta>
<refentrytitle>reposd.conf</refentrytitle>
<manvolnum>5</manvolnum>
<refmiscinfo class="manual">Linux Programmer's Manual</refmiscinfo>
</refmeta>

<refnamediv>
<refname>reposd.conf</refname>
<refpurpose>SBLIM metric repository daemon configuration file</refpurpose>
<refclass>UNIX/Linux</refclass>
</refnamediv>

<refsect1>
<title>Description</title>
<para>
The file <replaceable>reposd.conf</replaceable> is read by <citerefentry>
<refentrytitle>reposd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
at startup. Each line consists of a configuration option value pair delimited
by an '=' character. A '#' (number sign) indicates the beginning of a comment.
</para>
</refsect1>

<refsect1>
<title>Options</title>
<variablelist>
<varlistentry>
<term><option>RepositoryPort</option>=<replaceable>port</replaceable></term>
<listitem>
<para>TCP port repository daemon will listen. Default is <command>6363</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>RepositoryMaxConnections</option>=<replaceable>conns</replaceable></term>
<listitem>
<para>Number of parallel client connections the repository daemon is able to handle.
Default is <command>100</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>TraceLevel</option>=<replaceable>level</replaceable></term>
<listitem>
<para>Trace level for the <command>reposd</command> process. Default is
<command>0</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>TraceFile</option>=<replaceable>file</replaceable></term>
<listitem>
<para>Name of file to write tracing information. Default is
<command>stderr</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>TraceComponents</option>=<replaceable>comps[:comps...]</replaceable></term>
<listitem>
<para>Repository components to be traced seperated by a colon (:).
Valid components are: comm, util, repos. Default is <command>none</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>PluginDirectory</option>=<replaceable>dir</replaceable></term>
<listitem>
<para>Directory where repository metric plugins are located. Default is
<command>@libdir@/gather/rplug</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>AutoLoad</option>=<replaceable>plugin[:plugin...]</replaceable></term>
<listitem>
<para>Plugins to be automatically load, initalize and start sampling. Valid values are:
* or colon-seperated list. Default is <command>none</command>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>ExpirationInterval</option>=<replaceable>secs</replaceable></term>
<listitem>
<para>Specifies how many seconds metric values are kept in the in-core repository. 
Note that the longer the interval is the more memory that will be consumed by
<command>reposd</command>. Valid values are: and integer between 60 and 86400.
Default is <command>1200</command>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title>Bugs</title>
<para>The SBLIM project maintains a mailing list to which you should direct all
questions regarding sfcb, sfcc, wbemcli, the metric data gatherer, or any of the 
SBLIM providers. To subscribe to this list visit:

<screen><![CDATA[https://lists.sourceforge.net/lists/listinfo/sblim-issues]]></screen>
</para>

<para>Please report bugs you discover to the bug tracker. The SBLIM project bug 
tracking page can be found at:

<screen><![CDATA[https://sourceforge.net/tracker/?group_id=128809&atid=712784]]></screen>
</para>
</refsect1>

<refsect1>
<title>Authors</title>
<para>Please refer to the AUTHORS file distributed with sblim-gather.</para>
</refsect1>

<refsect1>
<title>Copyright</title>
<para>Copyright Â© 2003-2012 IBM Corp.</para>
</refsect1>

<refsect1>
<title>License</title>
<para><command>reposd.conf</command> is distributed under the terms of the Eclipse
Public License ("Agreement"). Any use, reproduction or distribution of this
program constitutes recipeients acceptance of the agreement.</para>

<para>You can obtain a current copy of the Eclipse Public License from
http://www.opensource.org/licenses/eclipse-1.0.php</para>
</refsect1>

<refsect1>
<title>See Also</title>
<para>
<citerefentry>
<refentrytitle>reposd</refentrytitle>
<manvolnum>8</manvolnum>
</citerefentry>
</para>
</refsect1>

</refentry>

[Sblim-commit] gather/man gatherctl.8.xml.pre.in, NONE, 1.1 gatherd.8.xml.pre.in, NONE, 1.1 gatherd

[Sblim-commit] gather/man gatherctl.8.xml.pre.in, NONE, 1.1 gatherd.8.xml.pre.in, NONE, 1.1 gatherd.conf.5.xml.pre.in, NONE, 1.1 reposctl.8.xml.pre.in, NONE, 1.1 reposd.8.xml.pre.in, NONE, 1.1 reposd.conf.5.xml.pre.in, NONE, 1.1