0 0 0 0 0 0 0 0
0
Grafist - a bandwidth utilization viewer

This Software is distributed under the GNU General Public License - see the accompanying COPYING file for more details.

You can reach the author at:
Faruk Eskicioglu (farukesk@comu.edu.tr)

You can get the latest version at official Grafist web site:
http://projects.comu.edu.tr/grafist/

Description

Requirements

Installing

Running

File Descriptions

data Directory

baslama

xsayac

x.dat

x2.dat

xrep

xrep2

bin directory

grafist

create

oku

sayacoku

sunx

uretec

Translating

Translators


Description:

Grafist is a bandwidth utilization viewer.It gets the bandwidth utilization information for variable interfaces from the /proc/net/dev file in 15-second periods, and stores it in four data files (daily, weekly, monthly, and yearly). When a request is sent to index.php, it executes four programs to create graphics (using the GD library) and a summary for each file. Grafist provides localization support for 24 languages.


Requirements:

For running Grafist you need:

Installed Apache, php, and gd packages,


Installing:

Run ./install.sh


Running:

Run grafist This will wait the minute to be 0 in modula 5. The results may be seen at http://server_address/grafist/index.php.
Also you can select the language at runtime like this "http://server_address/grafist/index.php?lang=LANGUAGE" where LANGUAGE is one of the languages that are supported by grafist.
If you want it to start automaticly when the system start, you should add "grafist &" to /etc/rc.d/rc.local file.


File Descriptions:

- data Directory

- baslama

Stores the starting date and time of grafist in ASCII format.

- xsayac

These files store the number of updates in binary format on the corresponding *.dat file where x can be gunluk, haftalik, aylik, yillik. The values in gunluksayac, haftaliksayac and ayliksayac are set to 0 on every end of days. These files are needed by "create" and can be read with "sayacoku".

- xdat

These files store the bandwidth usage information for output in binary format. Each of these files stores 395 floating point numbers. Where x can be;

-gunluk (=daily): The last value in the array stored in this file reflects the bandwidth usage information for the preceeding five minutes.
-haftalik (=weekly): The last value in the array stored in this file reflects the bandwidth usage information for the preceeding thirty minutes.
-aylik (=monthly): The last value in the array stored in this file reflects the bandwidth usage information for the preceeding two hours.
-yillik (=yearly): The last value in the array stored in this file reflects the bandwidth usage information for the preceeding day.
These files can be read with "oku".

- x2dat

These files are the same as above with exception of input rather than output.

- xrep

These files are created by sunx where x can be gunluk, haftalik, aylik, yillik and each of these reflects a summary for corresponing *.dat file.

- xrep2

These files are the same as above with exception of input rather than output.

- bin Directory

- grafist

Performs the necessary procedures to start grafist. These procedures are creating data files and running uretec and uretec2.

- create

This is executed by grafist, creates and initializes the data files (*.dat file in data directory). If a previous execution of grafist which terminated because of any reason, exists, reads old data files and moves the necessary informations to new data files. (never run)

- oku

Takes a name of a data file (*.dat file in data directory) as an argument from command line and prints the bandwidth utilization values stored in the data file to the stdandart output. (Actually this is for debugging)

- sayacoku

Takes a name of a counter file (xsayac file in data directory where x can be gunluk, haftalik, aylik, yillik) as an argument from commandline and prints the number of updates on the corresponding *.dat file. (Actually this is for debugging)

- sunx

(=present x where x can be gunluk, haftalik, aylik, yillik): This is executed by index.php, creates the x.png file which reflects the datas on corresponding *.dat file. (you dont need to run)

- uretec (=generator) and uretec2

uretec reads /proc/net/dev to get the bandwidth usage information for output in 15-second periods and stores these informations in *.dat files. uretec2 does the same things with the exceptions of the names of the data files (*2.dat rather than *.dat ) and input rather than output.


Translating:

Translate default.h and default.inc to Your_language.h and Your_language.inc. default.* files contains commented and uncommented lines for each variables. Write the statements which correspond with the commented line to uncommented lines. Send Your_Language.h and Your_language.inc to farukesk@comu.edu.tr


Language Support:
Language Translator
GermanHarry Auschner (hqa at gmx dot net)
RussianAnton Lykov (last at mv dot ru)
FrenchSebastien RAYNAUD (sray at isostorm dot com)
ItalianLoris (loris at icenet dot it)
ArabicMesut YAZICI (mesutyazici at comu dot edu dot tr)
AzeriMehmet Ali SALAHLI (msalahli at comu dot edu dot tr)
GreekStergios Nastopoulos (sterna at ioa dot forthnet dot gr)
BrazilianJoao Carlos Martins (joao dot martins at attla dot com)
CzechRadek Hanus (smurf at volny dot cz)
DutchMaarten Akerboom (maarten dot akerboom at planet dot nl)
PolishTomasz Wolbach (cybergate at thelema dot eu dot org)
Chinese (Simplified)Chencanhui (cchandyou at 163 dot net)

No localisation possible without them. Thank you all.