.\" 2000 PTM Przemek Borys <pborys@dione.ids.pl>
.\" updated to procps-2.0.7 - Andrzej M. Krzysztofowicz <ankry@mif.pg.gda.pl>
.\"                           październik 2002
.\" 
.\" This file Copyright 1992 Robert J. Nation 
.\" (nation@rocket.sanders.lockheed.com)
.\" It may be distributed under the GNU Public License, version 2, or
.\" any higher version.  See section COPYING of the GNU Public license
.\" for conditions under which this file may be redistributed.
.\"
.\" Modified 1994/04/25 Michael Shields <mjshield@nyx.cs.du.edu>
.\" Cleaned up, and my changes documented.  New `.It' macro.  Edited.
.\" modified 1996/01/27 Helmut Geyer to match my changes.
.
.de It
.TP 0.5i
.B "\\$1 "
..
.TH TOP 1 "Feb 1 1993" "Linux" "Podręcznik użytkownika Linuksa"
.SH NAZWA
top \- wyświetl najważniejsze procesy CPU
.SH SKŁADNIA
.B top
.RB [ \- ]
.RB [ d
.IR opóźnienie ]
.RB [ p
.IR pid ]
.RB [ q ]
.RB [ c ]
.RB [ C ]
.RB [ S ]
.RB [ s ]
.RB [ i ]
.RB [ n ]
.RB [ b ]
.SH OPIS
\fI Uwaga! To tłumaczenie może być nieaktualne!\fP
.PP
.B top
daje spojrzenie w czasie rzeczywistym na działalność procesora. Wyświetla
listę najbardziej zasobożernych zadań systemu i udostępnia interakcyjny
interfejs obsługi procesów. Może sortować zadania wg zużycia CPU, pamięci i
czasu działania.
.B top
może być lepiej skonfigurowany niż standardowy top z procps. Większość
właściwości można wybrać albo przez komendę interakcyjną, albo przez podanie
właściwości w pliku konfiguracyjnym. Zobacz niżej szczegóły.
.PP
.SH "OPCJE LINII POLECEŃ"
.It d
Określa opóźnienie między odświeżeniami ekranu. Można to zmieniać
komendą interakcyjną
.BR s .
.It p
Monitoruje jedynie procesy o danym id procesu. Opcję tę można podawać do
dwudziestu razy. Jest ona niedostępna interakcyjnie ani nie może być
ustawiona w pliku konfiguracyjnym.
.It q
Powoduje to, że
.B top
odświeża się bez opóźnienia. Jeśli wywołujący jest superużytkownikiem, top
działa z najwyższym możliwym priorytetem.
.It S
Określa tryb kumulacyjny, gdzie każdy proces jest wypisywany z czasem CPU,
który spożytkowanym przez niego
.IR "oraz jego martwe dzieci" .
Jest to podobne do flagi
.B -S
programu
.BR ps (1).
Zobacz dyskusję poniżej o komendzie interakcyjnej
.BR S .
.It s
Nakazuje programowi
.B top
pracę w trybie bezpiecznym. Wyłącza potencjalnie niebezpieczne komendy
interakcyjne (patrz niżej). Szykownie jest pozostawić bezpiecznego
.BR top a
na dodatkowym terminalu.
.It i
Uruchamia
.BR top a,
ignorując wszelkie procesy duchy i procesy próżnujące. Zobacz też komendę
interakcyjną
.B i
poniżej.
.It C
wyświetla oprócz indywidulnych stanów CPU również łączne stany CPU. Opcja ta
ma znaczenie jedynie w systemach SMP.
.It c
wyświetla linię poleceń zamiast samej nazwy polecenia. Domyślne zachowanie
zostało zmienione, gdyż wydaje się to bardziej przydatne.
.It n
Liczba iteracji. Odświeża wyświetlacz tyle razy i zakończ działanie.
.It b
Tryb wsadowy. Przydatne do wysyłania wyjścia z top do innych programów lub
do pliku. W trybie tym
.B top
nie przyjmuje wejścia z linii poleceń. Działa dopóki nie wykona określonej
za pomocą opcji
.B n
liczby iteracji lub dopóki nie zostanie zabity. Wyjście jest czystym tekstem,
nadającym się do wyświetlenia na zwykłym terminalu.
.
.SH "OPISY PÓL"
.B top
wyświetla różne informacje o stanie procesora. Wyświetlacz domyślnie jest
odświeżany co 5 sekund, lecz można to zmienić opcją
.B d
linii poleceń, lub komendą interakcyjną
.BR s .
.It "uptime"
Ta linia wyświetla czas, przez jaki system pracuje oraz trzy miary obciążenia
systemu. Określaja one średnią liczbę procesów gotowych do uruchomienia w
ostatniej minucie, ostatnich 5 i 15 minutach. Linia ta jest podobna do wyniku
polecenia
.BR uptime (1).
Wyświetlanie uptime może być przełączane komendą interakcyjną
.BR l .
.It processes
Całkowita liczba procesów, pracujących podczas ostatniego odświeżenia.
Jest to rozbite na liczbę zadań, które aktualnie się wykonują, śpią, są
zatrzymane, lub niemartwe. Wyświetlanie procesów i stanów może być
przełączane komendą interakcyjną
.BR t .
.It "CPU states"
Pokazuje zajętość czasu CPU w trybie użytkownika, w trybie systemowym, w
trybie zadań z ujemną wartością nice i trybie bezczynności.
Czas spędzony na zadaniach z ujemną wartością nice jest wliczany do czasu
systemowego i użytkownika, więc całość przekroczy 100%. Wyświetlanie procesów
i stanów może być przełączane komendą interakcyjną
.BR t .
.It Mem
Statystyki użycia pamięci, obejmujące całkowitą dostępną pamięć, wolną
pamięć, pamięć zajętą, pamięć dzieloną i pamięć przeznaczoną na bufory.
Wyświetlanie informacji o pamięci można przełączać komendą interakcyjną
.BR m .
.It Swap
Statystyki obszaru wymiany, opisujące całkowity obszar wymiany, dostępny
obszar wymiany i użyty obszar wymiany. Linia ta, wraz z
.B Mem
są podobne do wyjścia komendy
.BR free (1).
.It PID
Identyfikator procesu danego zadania.
.It PPID
Identyfikator procesu rodzicielskiego danego zadania.
.It UID
Identyfikator użytkownika, który jest właścicielem zadania.
.It USER
Nazwa użytkownika, który jest właścicielem zadania.
.It PRI
Priorytet zadania.
.It NI
Wartość nice zadania. Ujemne wartości nice oznaczają wyższy priorytet.
.It SIZE
Pokazywany jest tu w kilobajtach rozmiar kodu zadania plus obszar danych
plus rozmiar stosu.
.It TSIZE
Rozmiar kodu zadania. Podaje to dziwne wartości dla procesów jądra i jest
zepsute dla procesów ELF.
.It DSIZE
Rozmiar danych + stosu. Jest to zepsute dla procesów ELF.
.It TRS
Rozmiar rezydentnet sekcji text (Text Resident Size).
.It SWAP
Rozmiar części zadania, która uległa wymianie.
.It D
Rozmiar stron, zaznaczonych jako brudne.
.It LC
Ostatnio używany procesor. (Wartość zmienia się od czasu do czasu \- nie
jest to błąd; Linux celowo używa słabego powinowactwa. Zauważ również, że
sam fakt uruchomienia topa może naruszyć słabe powinowactwo i spowodować, że
więcej procesów częściej będzie zmieniać aktualny CPU ze względu na
dodatkowe żądania czasu CPU.) 
.It RSS
Całkowity rozmiar pamięci fizycznej używanej przez zadanie, w kilobajtach.
Dla procesów ELF wliczane są użyte strony biblioteki, dla a.out nie.
.It SHARE
Rozmiar pamięci dzielonej, używanej przez zadanie.
.It STAT
Stan pokazywanego zadania. Stan to albo
.B S
\- spanie,
.B D
\- nieprzerywane spanie,
.B R
\- działanie,
.B Z
\- duchy albo
.B T
dla procesów zatrzymanych, bądź śledzonych. Stany te są modyfikowane przez
dalsze
.B <
dla procesów o ujemnej wartości nice,
.B N
dla procesów o dodatniej wartości nice,
.B W
dla procesów, które uległy wymianie (nie działa to prawidłowo dla procesów
jądra).
.It WCHAN
zależnie od dostępności
.I /boot/psdatabase
lub mapy konsolidacji jądra
.IR /boot/System.map ,
pokazuje adres lub nazwę funkcję jądra, podczas wykonywania której zadanie
aktualnie śpi.
.It TIME
Całkowity czas CPU, zużyty przez zadanie od uruchomienia. Jeśli włączony
jest tryb kumulacyjny, wliczany jest też czas zużyty przez zmarłe dzieci 
procesu. Tryb kumulacyjny można ustawić opcją
.B S
linii poleceń lub przełączać komendą interakcyjną
.BR S . 
Linia nagłówka zmieni się wtedy na 
.BR CTIME .
.It %CPU
Udział zadania w czasie CPU od ostatniego odświeżenia ekranu, wyrażony jako
procent całkowitego czasu CPU.
.It %MEM
Udział zadania w pamięci fizycznej.
.It COMMAND
Nazwa polecenia zadania, która jest skracana, jeśli jest zbyt długa, by
zmieścić się w jednej linii. Zadania w pamięci mają pełną linię poleceń,
lecz zadania, które uległy wymianie (swapped-out) mają tylko nazwę programu,
ujętą w nawiasy (np. "(getty)").
.It "A , WP"
te pola z kmem top nie są obsługiwane.
.
.SH "KOMENDY INTERACYJNE"
Podczas pracy,
.B top
rozpoznaje parę jednoklawiszowych funkcji. Część z nich jest wyłączona po
przekazaniu opcji
.B s
z linii poleceń.
.It spacja
Odświeża natychmiast ekran.
.It ^L
Przerysowywuje ekran.
.It "h\fR lub \fB?"
Wyświetla ekran pomocy, podając krótki opis komend i status trybu
bezpiecznego i kumulacyjnego.
.It k
Zabija proces. Zostaniesz zapytany o PID zadania i sygnał, który mu wysłać.
Dla normalnego zabicia, wyślij sygnał 15. Dla pewnego, lecz brutalnego
zabicia, wyślij sygnał 9. Domyślnym sygnałem, jak dla
.BR kill (1),
jest 15,
.BR SIGTERM .
Komenda ta nie jest dostępna w trybie bezpiecznym.
.It i
Ignoruj procesy bezczynne i procesy duchy. Jest to przełącznik.
.It I
Przełącz pomiędzy widokiem w stylu Solarisa (procentowa zajętość CPU
rozdzielona pomiędzy łączną liczbę CPU) a widokiem w stylu Iriksa
(procentowa zajętość CPU obliczna wyłącznie jako ilość czasu). Jest to
przełącznik, który ma znaczenie tylko w stystemach SMP.
.It "n\fR lub \fB#"
Zmień liczbę pokazywanych procesów. Zostaniesz zapytany o liczbę. Zastępuje
to automatyczne liczbę pokazywanych procesów określoną na podstawie rozmiaru
okna. Jeśli podane zostanie 0, top pokaże tyle procesów, ile
zmieści się na ekranie. Tak jest domyślnie.
.It q
Koniec pracy.
.It r
Zmień wartość nice dla procesu. Zostaniesz zapytany o PID zadania i wartość
nice, jaką mu ustawić. Wstawianie wartości dodatniej spowoduje utratę
priorytetu. Jeśli
.BR top 
jest uruchomiony przez roota, można wstawić wartość ujemną powodującą, że
proces uzyska większy priorytet. Domyślną wartością renice jest 10. Komenda
ta nie jest dostępna w trybie bezpiecznym.
.It S
Przełącza do/z trybu kumulacyjnego, równoważnego
.BR "ps -S" ,
tj. czasy CPU będą zawierać czasy zakończonych procesów potomnych. Dla
niektórych programów, takich jak kompilatory, które pracują przez rozwidlanie
wielu zadań, tryb normalny powoduje, że wydają się mniej wymagające niż mówi
rzeczywistość. Dla innych jednak, takich jak powłoki czy
.BR init ,
zachowanie to jest prawidłowe. W każdym razie, zawsze można wypróbować tryb
kumulacyjny jako inne spojrzenie na zajętość CPU.
.It s
Zmienia opóźnienie między odświeżeniami. Zostaniesz zapytany o czas
opóźnienia w sekundach. Rozpoznawane są wartości ułamkowe, aż do
mikrosekund. Wstawienie 0 powoduje stałe odświeżanie. Domyślną wartością
jest 5 sekund. Zauważ, że niskie wartości powodują niemal nieczytelnie
szybkie zmiany obrazu i mocno zwiększają obciążenie. Komenda ta nie jest
dostępna w trybie bezpiecznym.
.It "f\fR lub \fBF"
Dodaje pola do wyświetlacza lub je usuwa. Zobacz niżej dla dalszych
informacji.
.It "o\fR lub \fBO"
Zmienia kolejność wyświetlanych pól. Dalsze informacje poniżej.
.It l
przełączaj wyświetlanie informacji o obciążeniu i uptime.
.It m
przełączaj wyświetlanie informacji o pamięci.
.It t
przełączaj wyświetlanie informacji o procesach i stanach CPU.
.It c
przełączaj wyświetlanie nazwy komendy i jej pełnej nazwy.
.It A
sortuj zadania według wieku (najnowsze najpierw).
.It M
sortuj zadania według zajętości pamięci.
.It N
sortuj zadania według PIDu (\fIn\fPumerycznie).
.It P
sortuj zadania według zajętości CPU (domyślne).
.It T
sortuj zadania według czasu / czasu skumulowanego.
.It W
Zapisz konfigurację do
.IR ~/.toprc .
Jest to zalecany sposób zapisywania konfiguracji topa.
.
.SH Ekrany pól i kolejności
Po naciśnięciu
.BR f ,
.BR F ,
.B o
lub
.B O
pokaże ci się ekran, pokazujący w górnej linii kolejność pól oraz krótkie
opisy ich zawartości. Łańcuch kolejności pól ma następującą składnię:
Jeśli odpowiadająca danemu polu litera w łańcuchu pól jest wielka, to pole
jest wyświetlane. Jest to dodatkowo oznaczane gwiazdką na początku opisu pola.
Kolejność pól odpowiada kolejności liter w łańcuchu.
 Z ekranu wyboru `f' pola można łatwo przełączać wyświetlanie danego pola,
naciskając odpowiednią literę.
 Z ekranu kolejności `o' można przesuwać pole w lewo, naciskając odpowiadającą
mu wielką literę, a w prawo, naciskając małą.
.
.SH Pliki konfiguracyjne
Top odczytuje domyślną konfigurację z dwóch plików,
.I /etc/toprc
i
.IR ~/.toprc .
Globalny plik konfiguracyjny może służyć do ograniczenia dla
nieuprzywilejowanych użytkowników możliwości topa do trybu bezpiecznego.
Jeśli to jest wymagane, plik powinien zawierać 's', określające tryb
bezpieczny oraz cyfrę d (2<=d<=9), określającą domyślne opóźnienie (w
sekundach) w jednej linii.
.
Prywatny plik konfiguracyjny składa się z dwóch linii. Pierwsza zawiera małe
i wielkie litery określające, które pola i w jakiej kolejności mają być
wyświetlane. Litery te odpowiadają literom z ekranu wyboru topa. Jako że nie
jest to zbyt pouczające, zaleca się wybieranie pól interacyjnie i zapisanie
kolejności za pomocą polecenia
.IR W .
.
Druga linia jest bardziej interesująca (i ważniejsza). Zawiera informacje o
innych opcjach. Najważniejsze, jeśli zachowałeś konfigurację w trybie
bezpiecznym, jest to, że nie uzyskasz niebezpiecznego topa bez usunięcia
\&'s' ze swojego
.IR ~/.toprc .
Cyfra określa czas opóźnienia między odświeżeniami, wielkie 'S' \- tryb
kumulacyjny, małe 'i' \- tryb bez-próżnowania, wielkie 'I' \- widok w stylu
Iriksa. Podobnie jak w trybie interakcyjnym, małe 'm', 'l', 't' powstrzymują
wyświetlanie informacji o pamięci i czasie działania odp. procesów oraz o
stanie CPU. Zmiana domyślnej kolejności sortowania (wg zajętości CPU) nie jest
obecnie wspierana.
.
.SH UWAGI
Ten oparty o
.B proc
.B top
działa przez odczyt plików z systemu plików
.BR proc ,
zamontowanego w
.IR /proc .
Jeśli
.I /proc
nie jest zamontowany,
.B top
nie będzie działać.
.PP
.B %CPU
Pokazuje procent czasu_cpu/czasu_rzeczywistego w okresie czasu między
odświeżeniami. Dla pierwszego odświeżenia używane jest krótkie opóźnienie i
dominuje tam 
.BR top .
Później,
.B top
spadnie na dalsze pozycje i widoczne stanie się bardziej sensowne
zestawienie zajętości CPU.
.PP
Pola
.B SIZE
i
.B RSS 
nie liczą tablic stron i
.B task_struct
procesu; jest to co najmniej 12K pamięci, która jednak pozostaje użyta.
.B SIZE
jest rozmiarem wirtualnym procesu (kod+dane+stos).
.PP
Pamiętaj, że proces musi umrzeć, aby jego czas został zanotowany przez
rodzica w trybie kumulacyjnym. Być może przydatniejsze byłoby śledzenie
takich procesów i dodawanie czasu, lecz byłoby to dość kosztowne. Poza tym
wtedy zachowanie
.BR top
byłoby niekompatybilne z
.BR ps .
.
.SH PLIKI
.I /etc/toprc 
Globalny plik konfiguracyjny.
.I ~/.toprc
Prywatny plik konfiguracyjny.
.
.SH "ZOBACZ TAKŻE"
.BR ps (1),
.BR free (1),
.BR uptime (1),
.BR kill (1),
.BR renice (1)
.
.SH
BŁĘDY
Jeśli okno jest mniejsze niż ok. 70x7,
.B top
nie będzie prawidłowo formatował danych. 
 Wiele pól wciąż ma problemy z procesami ELF.
 Ekrany pomocy nie są jeszcze zoptymalizowane na okna mniejsze niż 25 linii.
.
.SH AUTOR
.B top
został początkowo napisany przez Rogera Binnsa, w oparciu o program ps
Branko Lankestera <lankeste@fwi.uva.nl>.
Robert Nation <nation@rocket.sanders.lockheed.com> 
zmodyfikował go znacząco do używania systemu plików proc, w oparciu o
program ps Michaela K. Johnsona <johnsonm@redhat.com>.
Michael Shields <mjshield@nyx.cs.du.edu> 
dokonał wielu zmian, łącznie z bezpiecznym i kumulacyjnym trybem działania.
Tim Janik <timj@gtk.org> dodał sortowanie według wieku oraz możliwość
monitorowania poszczególnych procesów na postawie ich identyfikatorów.

Helmut Geyer <Helmut.Geyer@iwr.uni-heidelberg.de>
zmienił znacząco program w celu obsługi konfigurowalnych pól i innych nowych
opcji oraz dokonał dalszych czystek kodu i skorzystał z nowego interfejsu
readproc.

Opcje "b" i "n" zostały przekazane przez George'a Bonsera <george@captech.com> 
dla CapTech IT Services.

Obecnym opiekunem jest Michael K. Johnson <johnsonm@redhat.com>.

Zgłoszenia błędów wysyłaj do <procps-bugs@redhat.com>.
.SH "INFORMACJE O TŁUMACZENIU"
Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i 
\fImoże nie być aktualne\fR. W razie zauważenia różnic między powyższym opisem
a rzeczywistym zachowaniem opisywanego programu lub funkcji, prosimy o zapoznanie 
się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:
.IP
man \-\-locale=C 1 top
.PP
Prosimy o pomoc w aktualizacji stron man \- więcej informacji można znaleźć pod
adresem http://sourceforge.net/projects/manpages\-pl/.
