File: README

package info (click to toggle)
pppstatus 0.4.2-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 152 kB
  • ctags: 124
  • sloc: ansic: 1,552; makefile: 60
file content (132 lines) | stat: -rw-r--r-- 4,221 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
                           PPPStatus version 0.4.2
                           =======================

Author: Gabriel Montenegro
Email:  johnpetrucci@users.sourceforge.net
Homepage: http://pppstatus.sourceforge.net/

Copyright (c) 1999-2000 by Gabriel Montenegro.  This program is free software
which I release under the GNU General Public License.
Read the COPYRIGHT file for more info.


Description
===========

	PPPstatus was developed for Linux users that are usually in console 
mode. It is a simple, easy to use program for displaying commonly needed /
wanted statistics in real time about ingoing and outgoing TCP/IP traffic 
that is usually hard to find, with a simple, effecient interface.
	With that in mind, I have decided to write something useful with
exibition of a variety of protocol informations. Now the user has no need
to edit PATH variables, given the fact that pppstatus covers almost all
outputs from commands like pppstats, ifconfig, etc.


Characteristics
===============

	-> Theme (Change the Colors)
	-> Shows local IP address
	-> Verify if there's a connection every 100 miliseconds
	-> Receiving/Transfering data LED's
	-> Connection time
	-> 76x10 graphic, updated every second
	-> Constant change of modem speed, for better graphic interaction
 	-> Interface selection (ppp0, ppp1 ...)
	-> Selection beetween two exibition modes: Monochromatic, VGA
 	-> Check for new e-mails 
	-> LOG file where all the datas of all conections are stored
	-> Costs Calculator 

Requirements
============

	For the instalation of PPPStatus, you will need the following

             -ncurses library
             -GNU make

Instalation
===========
            
	Instalation is very simple, as you can see above
           
            
            PPPStatus~$ make
            * become root
            PPPStatus~$ su
            PPPStatus~# make install

                      *Instalation Complete*

Configuration File
==================

	PPPstatus uses two methods for default configurations changes:
pppstatus.cfg, and flags
	The configuration file (pppstatus.cfg) is interpreted, 
followed by the flags. In case your're using flags, it will be the method 
used by pppstatus, because the interpretetions of the configuration file will
only be overposted by the used flags. (only the used ones)
	There are two paths for pppstatus.cfg:

	* ~/.pppstatus/pppstatus.cfg - For normal users
	* /var/log/pppstatus.cfg - For root or who are using runonboot.
		
Configuration file variables
============================
        
	Here are they: interface, video, speed, high_contrast, user_email


Interface     -> PPPStatus watches * interface    ( * can be ppp0, ppp1,
                 ppp2, ...)
Video         -> Choose between Vga (colored) and mono (black and white)
Speed         -> Interaction speed beetween the graphic and the conection
bytes_info    -> Multiples of bytes on information (mbytes/kbytes/bytes)
User_email    -> check the user email


                                 Runonboot


Definition
==========

	 runonboot makes your life much easier because PPPStatus will be 
autolaunched, saving your time and leaving it in whatever terminal you want.
One privilege developed for Slackware/Red Hat/Debian Linux users.
            
Options
=======

	Understanting the flags

Flag -t -> you specifies the terminal you want pppstatus runs on boot (You'll
           probably want to put a tty that doesn't work as a terminal).
           The most commons examples are the terminals 8 to 12.
Flag -d -> you specifies your linux distribution so the program can update 
           all the new data in the right places
            
	In case you're using slackware distribution and wants to run PPPstatus
on tty 12, do the following:
 
			 ~$ runonboot -d slack -t 12

In case you use the runonboot remember that the configuration file 
(pppstatus.cfg) is on (/var/log), just like the log file (pppstatus.pppX.log)

                 X = Interface number (1,2,3,4,...)

Costs Calculator
================

	Read README.costs file to understand how it works.

Beta Testers
============

        HawkGod   -     Vitor Peres
        hdab      -     Hermes Borges
        acidx     -     Leandro Pereira