.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH EDPYKOTA "1" "octobre 2005" "C@LL - Conseil Internet & Logiciels Libres" "User Commands"
.SH NOM
edpykota \- page de manuel de edpykota 1.23_unofficial
.SH DESCRIPTION
edpykota v1.23_unofficial (c) 2003, 2004, 2005 Jerome Alet \- alet@librelogiciel.com
.PP
Edytor limitów drukowania dla systemu PyKota.
.PP
użycie z linii poleceń :
.IP
edpykota [opcje] użytkownik1 użytkownik2 ... użytkownikN
.IP
edpykota [opcje] grupa1 grupa2 ... grupaN
.PP
opcje :
.TP
\fB\-v\fR | \fB\-\-version\fR
Wyświetla wersję systemu PyKota i kończy działanie.
.TP
\fB\-h\fR | \fB\-\-help\fR
Wyświetla tą wiadomość i kończy działanie.
.TP
\fB\-a\fR | \fB\-\-add\fR
Dodaje użytkowników i/lib drukarki jeśli te nie istnieją
w systemie limitów na serwerze.
.TP
\fB\-d\fR | \fB\-\-delete\fR
Usuwa użytkowników/grupy z systemu limitów.
Drukarki nigdy nie są usuwane.
.TP
\fB\-c\fR | \fB\-\-charge\fR p[,j]
Ustawia cenę za stronę i za zadanie drukowania
dla wybranej drukarki. Cena zadania drukowania jest argumentem opcjonalnym.
Jeśli obydwie wartości mają być ustawione, oddziel je przecinkiem.
Liczby zmiennoprzecinkowe są dozwolone.
.TP
\fB\-o\fR | \fB\-\-overcharge\fR f
Ustawia współczynnik doliczania dla wybranego użytkownika
który będzie użyty podczas wyliczania ceny zadania drukowania. Dodatnie oraz
ujemne wartości zmiennoprzecinkowe są dozwolone,
co pozwala na ustawienie na prawdę ciekawych
efektów jak uzupełnianie konta za każdym razem kiedy uzytkownik coś
drukuje. Liczba stron nie jest modyfikowana
przez ten współczynnik, tylko
koszt zadania drukowania dla danego użytkownika.
Tylko użytkownicy posiadają współczynniki.
.TP
\fB\-i\fR | \fB\-\-ingroups\fR g1[,g2...]
Dołącza użytkowników do każdej z wymienionych grup,
oddzielonych przecinkami. Grupy
.IP
muszą istnieć w systemie limitów.
.TP
\fB\-u\fR | \fB\-\-users\fR
Edytuj limity użytkownika, akcja domyślna.
.TP
\fB\-P\fR | \fB\-\-printer\fR p
Edytuj limity tylko dla drukarki p. Dodatkowo p akceptuje
wzorce dopasowania tak abyś mógł wybrać tylko
niektóre drukarki. Domyślną wartością jest * co oznacza
wszystkie drukarki.
Możesz podać wiele nazw lub wzorców dopasowania,
rozdziel je przecinkami.
.TP
\fB\-G\fR | \fB\-\-pgroups\fR pg1[,pg2...] Dodaje drukarkę/drukarki do grup drukarek
pg1, pg2, etc... które muszą istnieć w bazie danych.
Grupa drukarek to nic innego jak zwykła drukarka ,
z tą róznicą, że nie jest widoczna przez nadrzędny system drukowania.
Utwórz grupę drukarek tak
jak dodajesz nowe drukarki, następnie dodaj inne
drukarki do tej grupy przy użyciu tej opcji.
Rozliczanie jest przeprowadzane na drukarce oraz na
wszystkich grupach drukarek do których należy dana drukarka, sprawdzanie limitów
jest przeprowadzane na drukarce oraz na wszystkich grupach drukarek
do których należy dana drukarka.
.TP
\fB\-g\fR | \fB\-\-groups\fR
Edytuj limity grup użytkowników, nie użytkowników.
.TP
\fB\-p\fR | \fB\-\-prototype\fR u|g Używa użytkownika u lub grupy g jako prototypu dla ustalenia
limitów drukowania
.TP
\fB\-n\fR | \fB\-\-noquota\fR
Ustawia obydwa limity (miękki i twardy) na wartość None dla
konkretnego wpisu w systemie limitów.
Ta opcja NIE jest równoważna opcji \fB\-\-limitby\fR noquota
która swoim działaniem obejmuje WSZYSTKIE wpisy limitów dla
wybranego uzytkownika.
.TP
\fB\-r\fR | \fB\-\-reset\fR
Zeruje licznik stron dla wybranego użytkownika lub
grupy na podanej drukarce.
Licznik 'life time page counter' nie jest modyfikowany.
.TP
\fB\-R\fR | \fB\-\-hardreset\fR
Zeruje WSZYSTKIE liczniki stron (aktualny i 'life time')
dla użytkownika lub grupy na wybranej
drukarce/wybranych drukarkach. Jest to skrót dla opcji '\-\-used 0'.
.TP
\fB\-l\fR | \fB\-\-limitby\fR l
Wybierz sposób ograniczania drukowania
albo poprzez stan konta lub poprzez limit stron.
Domyślną wartością jest limit stron. Dozwolone wartości to
\&'quota' 'balance' 'noquota' 'noprint'
i 'nochange' :
.IP
\- quota : ograniczaj względej liczby wydrukowanych stron na danej drukarce.
\- balance : ograniczaj względem stanu konta.
\- noquota : brak limitu, rozliczanie jest przeprowadzane.
\- nochange : brak limitu, rozliczanie nie jest przeprowadzane.
\- noprint : zakaz drukowania.
.IP
UWAGA : 'nochange' i 'noprint' nie mają zastosowania w przypadku grup.
.TP
\fB\-b\fR | \fB\-\-balance\fR b
Ustawia stan konta na b.
Stan konta może być zwiększony lub zmniejszony
jeśli b jest poprzedzone znakiem + lub \-.
UWAGA : jeśli pomniejszasz stan konta,
wówczas ogólna wartość wpłat dla użytkownika jest także pomniejszana.
Grupy nie mają rzeczywistego stanu konta, jedynie
sumę sald użytkowników tworzących grupę.
.TP
\fB\-C\fR | \fB\-\-comment\fR txt
Definiuje tekst informacyjny który będzie połączony ze zmianą
stanu konta użytkownika.
Ma sens tylko jeśli opcja \fB\-b\fR | \fB\-\-balance\fR jest określona.
.TP
\fB\-S\fR | \fB\-\-softlimit\fR sl
Ustala limit miękki na sl stron.
.TP
\fB\-H\fR | \fB\-\-hardlimit\fR hl
Ustawia limit twardy na hl stron.
.TP
\fB\-I\fR | \fB\-\-increase\fR v
Zmień oba limity (twardy i miękki) o wartość v.
Wartość v może być poprzedzona znakiem + lub \-. Jeśli żaden ze znaków nie jest
podany,wówczas domyślnym jest znak +.
.TP
\fB\-U\fR | \fB\-\-used\fR ustr
Ustawia liczniki stron na wartość ustr stron;
użyteczne podczas migracji użytkowników z innego systemu
gdzie liczniki miały wartość niezerową. Oba liczniki : Aktualny
i Life Time mogą być zwiększone lub zmniejszone
jeśli ustr jest poprzedzone znakiem + lub \-.
UWAGA : OBA liczniki stron są modyfikowane w każdym przypadku,
więc bądź ostrożny.
UWAGA : jeśli istr jest równe 0, wówczas opcja ta odpowiada opcji
\fB\-\-hardreset\fR opisanej powyżej.
.IP
Nazwy użytkownik1 do użytkownikN i grupa1 do grupaN ackeptują wzorce dopasowania
jeśli opcja \fB\-\-add\fR nie jest obecna.
.PP
przykłady :
.IP
\f(CW$ edpykota --add -p jerome john paul george ringo/ringo@example.com\fR
.IP
Komenda doda użytkowników john, paul, george oraz ringo do systemu
limitów, dodatkowo ich limity zostaną ustawione na wartość limitów użytkownika
jerome. Użytkownik jerome musi istnieć w systemie limitów.
Adres e\-mail użytkownika ringo zostanie dodatkowo ustawiony na 'ringo@example.com'
.IP
\f(CW$ edpykota --printer lp -S 50 -H 60 jerome\fR
.IP
Powyższa komenda ustali na drukarce lp limit miękki dla użytkownika jerome na 50 stron,
zaś limit twardy na 60 stron. Jeśli użytkownik jerome lub
drukarka lp nie istnieją w systemie limitów wówczas nic nie jest wykonywane.
.IP
\f(CW$ edpykota --add --printer lp --ingroups coders,it -S 50 -H 60 jerome\fR
.IP
Jak powyżej z tą różnicą, że jeśli użytkownik jerome lub drukarka lp nie istnieją
w systemie limitów wówczas są automatycznie dodawane. Dodatkowo
użytkownik jerome będzie dodany do grup "coders" i "it" które to
muszą istnieć w systemie limitów.
.IP
\f(CW$ edpykota -g -S 500 -H 550 financial support\fR
.IP
Komenda ustali limit miękki na 500 stron i limit twardy na 550 stron
dla grup financial i support na wszystkich drukarkach.
.IP
\f(CW$ edpykota --reset jerome "jo*"\fR
.IP
Komenda wyzeruje licznik stron dla użytkownika jerome na wszystkich drukarkach, jak i
dla każdego innego użytkownika którego nazwa ropoczyna się od słowa 'jo'.
Licznik 'life time' dla tych użytkowników pozostanie niezmieniony.
Jeśli chcesz wyzerować licznik 'life time' wówczas skorzystaj z opcji
\fB\-\-hardreset\fR | \fB\-R\fR.
.IP
\f(CW$ edpykota --printer hpcolor --noquota jerome\fR
.IP
Powyższa komenda spowoduje że użytkownik jerome będzie mógł drukować bez ograniczeń
na drukarce hpcolor. Wszystkie zadania drukowania będą akceptowane przez drukarkę, jednakże
rozliczanie stron w dalszym ciągu będzie prowadzone.
Limity drukowania na innych drukarkach dla użytkownika jerome pozostaną niezmienione.
.IP
\f(CW$ edpykota --limitby balance jerome\fR
.IP
Powyższa komenda spowoduje, że użytkownik jerome będzie ograniczany względem
stanu swojego konta.
.IP
\f(CW$ edpykota --balance +10.0 jerome\fR
.IP
Powyższa komenda spowoduje zwiększenie stanu konta użytkownika jerome o 10.0 jednostek (w lokalnej
walucie). Możesz pomniejszyć stan konta jeśli podasz znak \-
przed kwotą, możesz również ustalić stan konta na sztywno, wówczas nie podawaj znaku + ani \-.
.IP
\f(CW$ edpykota --delete jerome rachel\fR
.IP
Usuwa użytkowników jerome i rachel z systemu limitów.
Wszystkie limity oraz historia zadań drukowania skojarzona z tymi użytkownikami zostanie także usunięta.
.IP
\f(CW$ edpykota --printer lp --charge 0.1\fR
.IP
Powyższa komenda ustali cenę za stronę na drukarce lp na 0.1. Cena za zadanie drukowania
nie będzie zmieniona.
.IP
\f(CW$ edpykota --printer hplj1,hplj2 --pgroups Laser,HP\fR
.IP
Drukarki hplj1 i hplj2 zostanę umieszczone w grupach drukarek Laser i HP.
Podczas drukowania na hplj1 lub hplj2, limit drukowania będzie sprawdzony i rozliczony
także na wirtualnych drukarkach Laser i HP.
.IP
\f(CW$ edpykota --overcharge 2.5 biednystudent\fR
.IP
Od tego momentu użytkownik biednystudent będzie płacił 2.5 raza więcej za każdą wydrukowaną stronę/zadanie drukowania.
.IP
\f(CW$ edpykota --overcharge -1 jerome\fR
.IP
Od tego momentu użytkownik jerome będzie 'zarabiał' za każdym razem kiedy drukuje.
.IP
\f(CW$ edpykota --overcharge 0 boss\fR
.IP
Użytkownik boss może drukować bez żadnych ograniczeń, ponieważ
koszt każdego zadania drukowania będzie przemnożony przez 0.
.PP
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.
.PP
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.
.PP
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., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA.
.PP
Raporty o błędach proszę kierować do : Jerome Alet \- alet@librelogiciel.com