sitar(1)
NAME
SITAR - System InformaTion At Runtime
SYNOPSIS
sitar|sitar.pl --format=format --outfile=file --help
--version
Available formats: html, tex, yast1, yast2
DESCRIPTION
Prepare system information using perl, reading the /proc
filesystem. Output is in HTML and LaTeX (planned: XML,
SQL) and can be converted to PostScript and PDF. Sitar is
an ancient Indian instrument as well (see "HISTORY"
below).
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
html
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 LaTeX, ".sel" for
YaST-Selection-files.
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":
"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"
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 cre
ated the Debian port; Björn Jacke helped on several
issues; Bernhard Thoni introduced the software raid sup
port; 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 sup
ported: SuSE Linux, United Linux, Debian, RedHat.
For more information on SITAR, see:
http://sitar.berlios.de/
LICENSE
Copyright (C) 1999-2003 SuSE Linux AG
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 addi
tional 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.