SITAR - System InformaTion At Runtime
sitar|sitar.pl --format=format --outfile=file --help --version
Available formats: html, tex, sdocbook, yast1, yast2
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:
If called with --format and --outfile exactly this is produced.
.html
for HTML, .tex
for TeX or LaTeX, .sdocbook.xml
for simplified docbook-xml, .sel
for YaST-Selection-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.
The program may silently fail if either the /proc
Filesystem does not exist or the program is not startet by the root
user.
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.
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/
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.
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.