NAME

SITAR - System InformaTion At Runtime


SYNOPSIS

sitar|sitar.pl --format=format --outfile=file --help --version

Available formats: html, tex, sdocbook, yast1, yast2


DESCRIPTION

Prepare system information using perl, reading the /proc filesystem. Output is in HTML, LaTeX, simplified docbook-xml (planned: SQL) and can be converted to PostScript and PDF. Sitar is an ancient Indian instrument as well (see HISTORY below).

There are three files/links available:

sitar
sitar.pl
If called without --outfile and/or without --format, all available output formats are produced below /tmp/sitar-$hostname-$date.

If called with --format and --outfile exactly this is produced.

support_all.pl
must always be called with both options: --format --outfile, but does nothing, if called without any options.


OPTIONS

--help
Prints a short summary of options.

--version
Prints the sitar version

--format=format
Tell SITAR, which output format to use. At the moment four formats are supported:
tex
as an alias, also latex can be used.

html
sdocbook
produces simplified docbook-xml; the format is not named xml, because there are several (in theory:an arbitrary number) of xml flavours available.

yast1
yast2
--outfile=file
All formatted output will be stored in the file given here. Please don't forget to give the right extension here: .html for HTML, .tex for TeX or LaTeX, .sdocbook.xml for simplified docbook-xml, .sel for YaST-Selection-files.


FILES

From a tool called PaDS by Thorsten Wandersmann sitar inherited the ability, to extend the list of configuration files. To achieve that, just put a perl-snippet in the directory /var/lib/support/; this snippet must have the extension .include and may include only one perl-statement: an array-declaration for the array @files, that contains the file-names with full path, see EXAMPLES below.


ERRORS

The program may silently fail if either the /proc Filesystem does not exist or the program is not startet by the root user.


DIAGNOSTICS

While running, stdout is redirected to the designated outfile file. So one will find diagnostics in this file; this (not very helpful) behaviour may change in the future.


EXAMPLES

For generating a HTML documentation type as user root:


C<sitar.pl --format=html --outfile=/tmp/$HOSTNAME.html>

For PDF type as user root:

sitar.pl --format=tex --outfile=/tmp/$HOSTNAME.tex

and twice (as an ordinary user):

pdflatex /tmp/$HOSTNAME.tex

A typical file to include the configurations files of the application foobar could look like this:

 # /var/lib/support/foobar.include
 
 @files= (
        "/etc/opt/foobar/foo.conf",
        "/etc/opt/foobar/bar.conf"
        );
 # eof
 
=head1 AUTHOR

The SITAR project was created by Matthias G. Eckermann <mge@suse.de>; Stephan Müller helped with Firewalling and Security issues; Janto Trappe and Waldemar Brodkorb created the Debian port; Björn Jacke helped on several issues; Bernhard Thoni introduced the software raid support; Pascal Fuckerieder wrote the IPTables/Netfilter code and Andreas Rother submitted a patch for running sitar on RedHat Linux. So finally these Linux Systems are supported: SuSE Linux, Debian, RedHat.

For more information on SITAR, see: http://sitar.berlios.de/


LICENSE

Copyright (C) 1999-2005 SuSE Linux, a Novell Business

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


HISTORY

The sitar is the invention of Amir Shusru, the famous poet and singer attached to the Court of Sultan Alauddin Khilju of Delhi (1295-1315). This is the most popular instrument in Northern India. The sitar is a lute-like instrument with a long fretted neck and a resonating gourd. It is plucked by the index finger of the left hand fitted with a plectrum made of wire. Sitars generally have 6 or 7 main playing strings which run above the frets, and an additional 12 or more sympathetic strings which give the instrument a shimmering echo when played. The frets herein are movable and can be adjusted according to the scale selected to be played upon. The sitar is also called as satar and sundari.