TaRyFikator by Maciej Korze <eaquer@ceti.pl>.
http://www.ceti.pl/eaquer/trf/

1. Jak mwi nazwa programu, suy on do obliczania kosztw pocze modemowych.
Moliwoci:
	- obsuga ryczatu (dugo ryczatu mona zmienia, przydaje si gdy
	  kilka osb w domu korzysta z komputera i przez to kady moe
          wykorzysta tylko pewien czas z ryczatu),
	- jeeli nie mamy wykupionego ryczatu, to ustawiamy jego dugo na '0'
	  i nie ma problemw,
	- obliczanie czasu poczenia i obliczanie kosztw jest realizowane
	  przez dwa odrbne programy - rozwizanie jest bardziej elastyczne,
	- program dziaa poprawnie na FreeBSD i Linuksie,
	- wszystkie komunikaty wywietlane s w jzyku polskim.

Wady:
	- zosta napisany pod ktem pocze z TP S.A., moe nie nadawa si do
	  stosowania z innymi providerami bez przerobienia kodu,
	- nie potrafi poprawnie obliczy ceny pocze dokonanych na przeomie
	  miesicy (poczenie rozpoczte w jednym miesicu, a zakoczone w
	  drugim), takie poczenia s przypisywane do miesica w ktrym miay
	  pocztek.

2. Instalacja
W katalogu ze rdami wystarczy napisa make all install. Mona stosowa
zmienne DESTDIR i prefix (jeeli kto bdzie chcia zrobi paczk).

3. Uywanie
Plik z logami pocze to ~/.trf. Informacje o aktualnym poczeniu s
przechowywane w ~/.trf.current. Dugo ryczatu okrelamy w zmiennej rodowiska
TRFLIMIT. Przy czym warto musi by w _sekundach_. Domylnie przyjmowana jest
warto 14 godzin (81000 sekund), wikszo osb prawdopodobnie bdzie chciaa
ustawi j na 30 godzin (czyli 108000 sekund). Przed rozpoczciem poczenia
naley uruchomi skrypt trf, ktry bdzie ledzi czas poczenia i co sekund
zapisywa jego aktualny stan do ~/.trf.current. Po zakoczeniu poczenia
zawarto tego pliku zostanie dopisana do ~/.trf, a ~/.trf.current usunity.
Takie rozwizanie ma kilka zalet:
	- jeeli w czasie poczenia z internetem z niezalenych od nas przyczyn
	  komputer przerwie prac, to i tak informacje o poczeniu bd w
	  ~/.trf.current, wystarczy wtedy po uruchomieniu komputera wyda
	  polecenie 'cat .trf.current >> .trf ; rm .trf.current'. Skrypt trf
	  przed uruchomieniem sprawdza czy plik ~/.trf.current istnieje, jeeli
	  tak to przerywa dziaanie.
	- w ~/.trf dane s zapisywane w postaci dwch dat oddzielonych spacjami
	  (pierwsza data to pocztek poczenia, a druga to koniec poczenia),
	  moemy wic napisa wasny program do sprawdzania czasw pocze,
	  np. na podstawie logw systemowych,
	- trf za rozpoczcie poczenia uwaa utworzenie pliku
	  /var/run/<INTERFEJS>.pid (we FreeBSD), lub /var/lock/LCK..<PORT> (w
	  Linuksie), czyli zliczane jest od momentu wybierania numeru przez
	  modem (w ten sposb logowane s nawet nieudane poczenia).
Poniewa trf za poczenie uwaa kade podniesienie interfejsu (FreeBSD) lub
otworzenie portu modemu (Linux) nie jest zalecane uruchamianie go w tle, aby
dziaa przez cay czas. Lepiej jest go uruchamia przed rozpoczciem poczenia
i wycza po jego zakoczeniu. To rozwizanie dziaa bardzo dobrze, gdy we
FreeBSD czymy si za pomoc 'ppp -background XXX'.
Program trfs suy do wywietlania informacji o poczenia, oblicza koszty,
czasy pocze, ilo impulsw. Dla uatwienia w ostatniej kolumnie wywietlane
s flagi - ich opis jest pod tabelk. Litery mniejsze (t, d i w) obrazuj w
obrbie jakich taryf znalazo si poczenie. Np. "t" oznacza, e poczenie
naley do taryfy taszej, natomiast "tdt" oznacza, e poczenie byo kolejno w
obrbie taryf taszej, droszej i taszej. Due litery (R, Z, P) okrelaj czy
poczenie zostao jeszcze objte przez ryczat, cz poczenia odbya si w
jeszcze w ryczacie, a cz poza, oraz e poczenie odbyo si ju poza
ryczatem. Jeeli program zostanie uruchomiony w trakcie istniejcego
poczenia, to ostatnie (biece) poczenie bdzie miao flag A. Jeeli
poczenie bdzie bardzo dugie (conajmniej kilka dni ;-)) i kilka flag si nie
zmieci do tabeli, to zostanie to oznaczone przy pomocy flagi '!'.

4. Logi
Ze wzgldu na rne implementacje funkcji strftime i strptime w Linuksie i
FreeBSD, logi utworzone na tych systemach nie s kompatybilne.

5. Zmienne rodowiska
TRF pozwala na zmian jego domylnego zachowania poprzez ustawienie zmiennych
rodowiska:
TRFFILE - lokalizacja pliku z logami, wzgldem katalogu domowego,
TRFLIMIT - dugo czasu ryczatu w sekundach.

6. Argumenty
Trfs moe by uruchomiony z argumentami:
 -V			- wywietla wersj programu,
 -m miesic		- numer miesica (od 1 do 12), dla ktrego maj zosta
			  wywietlone koszty, domylnie jest to biecy miesic.

Trf obsuguje wyej wymienion opcj "-V" i "-f plik" oraz "-d", ktra
wcza debugowanie.

7. Podpis PGP
W plikach .asc znajduj si sygnatury potwierdzajce autentyczno archiwum z
programem. Mj klucz publiczny znajduje si pod adresem www.ceti.pl/eaquer/pgp.

8. Najnowsze wersje
Najnowsze wersje programu mona znale pod adresem: www.ceti.pl/eaquer/trf.

9. Kontakt
Wszelkie uwagi prosz wysya na adres eaquer@ceti.pl

 vim:tw=80:
