<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd" [
  <!ENTITY kappname "&ksysguard;">
  <!ENTITY package "kdebase">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">
<bookinfo>
<title
>O Manual do &ksysguard;</title>

<authorgroup>
<author
>&Chris.Schlaeger;&Chris.Schlaeger.mail; </author>

<othercredit role="developer"
><personname
><firstname
>John</firstname
><surname
>Tapsell</surname
></personname
> <email
>john@geola.co.uk</email
> </othercredit>

<othercredit role="developer"
>&Chris.Schlaeger;&Chris.Schlaeger.mail; </othercredit>

<othercredit role="developer"
>&Tobias.Koenig;&Tobias.Koenig.mail; </othercredit>

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2000</year>
<holder
>&Chris.Schlaeger;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2000-12-14</date>
<releaseinfo
>1.00.00</releaseinfo>

<abstract
><para
>O &ksysguard; é um gestor de tarefas para a rede e uma aplicação de monitorização do sistema.</para
></abstract
> 

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KSysGuard</keyword>
<keyword
>monitor de processos</keyword>
<keyword
>monitor de performance</keyword>
<keyword
>monitor do sistema</keyword>
<keyword
>top</keyword>
<keyword
>ps</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>O &ksysguard; é o Monitor de Performance e Tarefas do &kde;. </para>
<para
>Baseia-se numa arquitectura cliente/servidor que permite a monitorização das máquinas locais e remotas. A interface gráfica usa alguns sensores para obter a informação que mostram. O sensor poderá devolver valores simples ou mesmo informações complexas como, por exemplo, tabelas. Para cada tipo de informação, existem uma ou mais áreas de visualização. As áreas estão organizadas em folhas de trabalho que podem ser gravadas e carregadas independentemente umas das outras. Como tal, o &ksysguard; não só é um gestor de tarefas simples como também é uma ferramenta bastante poderosa para controlar as várias colónias de servidores.</para>

</chapter>

<chapter id="usingtheksysguard">
<title
>Usar o &ksysguard;</title>

<sect1 id="getting-started">
<title
>Introdução</title>

<para
>&ksysguard; can be started from the &kmenu;, using the entry <guimenuitem
>System Monitor</guimenuitem
> in the <menuchoice
> <guimenu
>Applications</guimenu
><guisubmenu
>System</guisubmenu
></menuchoice
> menu. Alternatively, you can start it by typing <command
>ksysguard</command
> in a terminal.</para>

<para
>A janela principal do &ksysguard; consiste numa barra de menu, numa barra de ferramentas opcional e numa barra de estado, assim como no gestor de sensores e no espaço de trabalho. </para>
<para
>By default &ksysguard; shows two worksheets: "Process Table" and "Sensor Load". The Process Table lists the running processes and lets the user control them. Multiple processes can be selected and controlled at once. The Sensor Load worksheet shows graphs of system utilization: (clockwise from Top-Left) CPU Load, the system Load Average over the past minute, Physical Memory (RAM) usage, and finally Swap Memory usage. </para>

<para
>Esta mesma configuração é o suficiente para um utilizador inexperiente fazer alguma gestão do sistema. Um utilizador mais experiente ou mesmo um administrador de sistemas de um laboratório com grandes computadores têm diferentes necessidades. Para se acomodar a um conjunto vasto de utilizadores, o &ksysguard; é altamente flexível.</para>
</sect1>

<sect1 id="the-sensor-browser">
<title
>The Sensor Browser</title>
<para
>The sensor browser exposes &ksysguard;'s advanced functionality. To use it, you must first go to the file menu and create a new worksheet. It is shown whenever a custom worksheet is selected.</para>
<para
>A lista de sensores mostra as máquinas registadas e os sensores no formato de uma árvore. Carregue nos nós da árvore para abrir ou fechar uma ramificação. Cada sensor vigia um dado valor do sistema.</para>

<sect2 id="connectingtootherhosts">
<title
>Estabelecer ligações a outros computadores</title>

<para
>To connect to a new host use <guimenuitem
>Monitor remote machine...</guimenuitem
> from the <guimenu
>File</guimenu
> menu. A dialog box will appear and allows you to enter the name of the host you want to connect to. Below the name you can choose the connection method. The default is <application
>ssh</application
>, the secure shell. Alternatively the <application
>rsh</application
>, the remote shell, or the daemon mode can be used. Click <guibutton
>OK</guibutton
> to establish the connection. Shortly afterwards the new host will appear in the sensor browser and you can browse the list of sensors.</para>

<para
>Para estabelecer uma ligação, deve-se instalar na nova máquina um programa chamado <application
>ksysguardd</application
>, o qual poderá ser iniciado nos dois modos seguintes.</para>

<variablelist>
<varlistentry>
<term
>modo servidor</term>
<listitem>
<para
>You can start <application
>ksysguardd</application
> at boot time in <guilabel
>Daemon</guilabel
> mode by adding <parameter
>-d</parameter
> as the argument. In this case, you have to select daemon mode at the connection dialog of <application
>ksysguard</application
>. A disadvantage of this connection type is that you won't be able to kill or renice a process with the <guilabel
>Process Controller</guilabel
> and the data exchange over network won't be encrypted. As a result, daemon mode is not recommended.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>modo da linha de comandos</term>
<listitem>
<para
>Neste modo, o <application
>ksysguardd</application
> é iniciado na altura da ligação pelo <application
>ksysguard</application
>. Para tornar isto possível, a sua localização deverá ser incluída na sua <envar
>PATH</envar
>. Infelizmente, o 'ssh' não executa o seu ficheiro <filename
>.profile</filename
>, como tal a sua configuração da <envar
>PATH</envar
> normal não estará disponível. Em vez disso, utiliza uma <envar
>PATH</envar
> por omissão do tipo <parameter
>/bin:/usr/bin</parameter
>. Dado que é muito provável que o KDE não esteja instalado nessas pastas, o utilizador terá de criar ou actualizar um ficheiro na sua pasta pessoal. Esse ficheiro chama-se <filename
>environment</filename
> e necessita estar numa pasta escondida chamada <filename
>.ssh</filename
>. Veja a página do manual do <application
>ssh</application
> para mais detalhes. O ficheiro necessita ter uma linha semelhante a:</para>

<screen
><userinput
>PATH=/bin:/usr/bin:/opt/kde/bin</userinput
>
</screen>

<para
>assumindo que o <application
>ksysguardd</application
> pode ser encontrado em <filename
>/opt/kde/bin/ksysguardd</filename
>.</para>

<tip
><para
>Ao usar o <application
>ssh</application
> terá de confirmar se tem o <filename
>identity.pub</filename
> instalado na máquina remota e se a chave da mesma máquina se encontra registada na sua máquina. Se não configurar o <filename
>identity.pub</filename
>, ser-lhe-á pedida a senha sempre que iniciar o ksysguard. A forma mais fácil de verificar isso é escrever <command
>ssh <option
>maquina_remota ksysguardd</option
></command
> numa linha de comandos. Se o <application
>ksysguardd</application
> o atender, o utilizador poderá escrever <userinput
>quit</userinput
> e está tudo pronto.</para
></tip>
</listitem>
</varlistentry>
</variablelist>

<note
><para
>Para os peritos: o <application
>ksysguardd</application
> é uma aplicação muito pequena que só está compilada com a 'libc'. Como tal poderá ser usada nas máquinas que não tenham uma instalação completa do &kde;, como acontece nos servidores. Muitas das distribuições oferecem um pacote <application
>ksysguardd</application
> separado para sua conveniência. Se escolher a opção do comando personalizado na ligação à máquina terá de especificar o comando completo para iniciar o <application
>ksysguardd</application
>.</para
></note>

</sect2>

<sect2 id="disconnecting-hosts">
<title
>Disconnecting hosts</title>

<para
>To disconnect from a host, select the host in the sensor browser and choose <guimenuitem
>Disconnect Host</guimenuitem
> from the <guimenu
>File</guimenu
> menu. If you still have sensors in use, the display frames will be grayed and the displays won't update any longer.</para>
</sect2>
</sect1>

<sect1 id="the-workspace">
<title
>The Work Space</title>

<para
>The work space is organized as worksheets. Select <guimenuitem
>New Worksheet...</guimenuitem
> from the <guimenu
>File</guimenu
> menu to create a new worksheet. A dialog will appear where you can set the name, the dimension and the update interval of the worksheet. To remove a worksheet again, select <guimenuitem
>Close</guimenuitem
> from the <guimenu
>File</guimenu
> menu. Any modifications will be saved to the worksheet file. If a worksheet has never been saved, you will be asked for a file name. Worksheets consist of cells organized as a grid.</para>

<para
>Cada célula poderá ser preenchida com uma área para um ou mais sensores. Poderá preencher uma célula ao arrastar um sensor a partir da lista de sensores e ao largá-la na célula. Se existir mais do que uma área disponível para esse tipo de sensor, irá aparecer um menu de contexto. Poderá então seleccionar qual a área que prefere usar. Certo tipo de áreas podem mostrar mais do que um sensor. Adicione mais sensores a uma área, bastando para tal arrastá-los da lista de sensores e largá-loas na área já existente.</para>

<para
>Worksheets can be configured by clicking <guimenuitem
>Configure Worksheet </guimenuitem
> at the <guimenu
>Edit</guimenu
> menu. In the appearing dialog you can set the dimension and the update interval. This update interval is used by all displays of the worksheet, which has the <guilabel
>use update interval of worksheet</guilabel
> set in its timer configuration dialog.</para>

<para
>The entry <guimenuitem
>Configure Style</guimenuitem
> of the <guimenu
>Settings</guimenu
> menu gives you the possibility to configure the global style attributes and apply them to the current active worksheet.</para>

<para
>Displays can be configured by clicking with the right mouse button on them. A popup menu appear where you can select whether you want to change the properties of that display, remove it from the worksheet, change its update interval type and value or pause and restart its updating.</para>

<sect2 id="signal-plotter">
<title
>Signal Plotter</title>

<para
>The signal plotter prints samples of one or more sensors over time. If, several sensors are displayed, the values are piled in different colors. If the display is large enough a grid will be displayed to show the range of the plotted samples. By default, the automatic range mode is active so the minimum and maximum values will be set automatically. Sometimes you want fixed minimum and maximum values. In that case, you can deactivate automatic range mode and set the values in the properties dialog.</para>
</sect2>

<sect2 id="multimeter">
<title
>Multimeter</title>

<para
>O multímetro mostra os valores dos sensores como um multímetro digital. Nas janelas de propriedades poderá escolher um limite inferior e superior. Se o intervalo for excedido, a área é colorida com a cor do alarme.</para>
</sect2>

<sect2 id="process-controller">
<title
>Process Controller</title>

<para
>The Process Controller gives you a list of processes on your system. The list can be sorted by each column. Just press the left mouse button at the head of the column. </para>

<para
>A lista dá-lhe as seguintes informações sobre cada processo. Lembre-se que nem todas as propriedades estarão disponíveis em todos os sistemas operativos.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Nome</guilabel
></term>
<listitem
><para
>The name of the executable that started the process.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>PID</guilabel
></term>
<listitem
><para
>The Process <abbrev
>ID</abbrev
>. A unique number for each process.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>PPID</guilabel
></term>
<listitem
><para
>The Process <abbrev
>ID</abbrev
> of the process parent.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>UID</guilabel
></term>
<listitem
><para
>The <abbrev
>ID</abbrev
> of the user that started the process.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>GID</guilabel
></term>
<listitem
><para
>The <abbrev
>ID</abbrev
> of the group the process belongs to.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Status</guilabel
></term>
<listitem
><para
>The process status.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>User%</guilabel
></term>
<listitem>
<para
>The processor load of the process in user space (in percent).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>System%</guilabel
></term>
<listitem>
<para
>The processor load of the process in system space (in percent).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Nice</guilabel
></term>
<listitem
><para
>The scheduling priority.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>VmSize</guilabel
></term>
<listitem
><para
>The total amount of virtual memory used by the process (in kBytes).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>VmRss</guilabel
></term>
<listitem
><para
>The total amount of physical memory used by the process (in kBytes).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Login</guilabel
></term>
<listitem
><para
>The login name of the user that started the process.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Comando</guilabel
></term>
<listitem
><para
>The complete start command of the process.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Underneath the table you find four buttons which will be described now from left to right.</para>

<sect3 id="the-tree-view">
<title
>The <guibutton
>Tree</guibutton
> View</title>

<para
>A vista em árvore foi desenhada para mostrar as relações entre os processos em execução. Um processo que é iniciado por outro processo é denominado como seu filho. Uma árvore é uma forma elegante de mostrar esta relação de pai para filho. O processo <emphasis
>init</emphasis
> é o ascendente de todos os processos.</para>

<para
>Se não estiver interessado nos filhos de um processo em particular poderá carregar na pequena opção à esquerda do pai para que a sua sub-árvore se feche. Se voltar a carregar no mesmo símbolo, a mesma sub-árvore abrir-se-á de novo.</para>

</sect3>

<sect3 id="the-process-filter">
<title
>The Process Filter </title>

<para
>The Process Filter can be used to reduce the number of processes displayed in the table. You can filter out processes you are not interested in. Currently you can display all processes, system processes only, user processes only or your processes only.</para>

</sect3>

<sect3 id="therefreshbutton">
<title
>The <guibutton
>Refresh</guibutton
> Button </title>

<para
>This button can be used to force an immediate update of the process list.</para>

</sect3>

<sect3 id="thekillbutton">
<title
>The <guibutton
>Kill</guibutton
> Button </title>

<para
>If you have selected one or more processes you can press the kill button to kill them. A so called <errorcode
>SIGKILL</errorcode
> is sent to the processes which causes them to terminate immediately. If these applications still have unsaved data this data will be lost. So use this button with care.</para>

</sect3>
</sect2>

<sect2 id="bargraph">
<title
>BarGraph</title>

<para
>The bargraph displays the sensor values as dancing bars. In the properties dialog you can specify minimum and maximum values of range and a lower and upper limit. If the range is exceeded, the display is colored in the alarm color.</para>
</sect2>

<sect2 id="sensorlogger">
<title
>Sensor Logger</title>

<para
>The sensor logger does not display any values, but logs them in a file with additional date and time information. For each sensor you can specify a lower and upper limit in the properties dialog. If the range is exceeded, the entry of the sensor table is colored in the alarm color and a <application
>knotify</application
> event is sent.</para>
</sect2>

<sect2 id="logfile">
<title
>Log File</title>

<para
>The log file monitor displays the content of a file &eg; <filename
>/var/log/messages</filename
>. In the properties dialog, you can compose a list of regular expressions that will be compared with the content of the file. If one of the expressions match, a <application
>knotify</application
> event will be sent. </para>
</sect2>

<sect2 id="listview">
<title
>List View</title>

<para
>The listview displays the data of some sensors in the form of a table.</para>
</sect2>

</sect1>
</chapter>

<chapter id="multiple-platforms">
<title
>Configurar o <application
>ksysguardd</application
></title>

<para
>A interface gráfica está disponível para todas as plataformas onde o &kde; se executa. A infra-estrutura está de momento disponível para as seguintes variantes do &UNIX;:</para>

<variablelist>
<varlistentry>
<term
>&Linux; 2.x</term>
<listitem
><para
>Para o <application
>ksysguardd</application
> funcionar é necessário compilar o 'kernel' do &Linux; com o suporte para o sistema de ficheiros <filename
>/proc</filename
> activo. Esta é a configuração por omissão e a maioria das distribuições do &Linux; já o têm.</para
> </listitem>
</varlistentry>
<varlistentry>
<term
>FreeBSD</term>
<listitem
><para
>O programa <application
>ksysguardd</application
> necessita de pertencer ao grupo <systemitem class="groupname"
>kmem</systemitem
> e necessita de ter o 'bit' 'setgid' activo.</para
></listitem
> 
</varlistentry>
<varlistentry>
<term
>&Solaris;</term>
<listitem
><para
>A ser escrito</para
></listitem>
</varlistentry>
</variablelist>

<para
>O suporte para as outras plataformas está em progresso. Agradece-se-á bastante a sua ajuda.</para>
</chapter>

<chapter id="credits-and-licenses">
<title
>Créditos e Licenças</title>

<para
>O &ksysguard; está a ser desenvolvido e mantido pelo &John.Tapsell; &John.Tapsell.mail;. O &ksysguard; é uma reinvenção do <application
>KTop</application
>, o gestor de tarefas do &kde; 1.x. Várias outras pessoas trabalharam no <application
>KTop</application
>:</para>

<itemizedlist>
<listitem
><para
>A. Sanda <email
>alex@darkstar.ping.at</email
></para
></listitem>
<listitem
><para
>Ralf Mueller <email
>ralf@bj-ig.de</email
></para
></listitem>
<listitem
><para
>&Bernd.Johannes.Wuebben; <email
>wuebben@math.cornell.edu</email
></para
></listitem>
<listitem
><para
>Nicolas Leclercq <email
>nicknet@planete.net</email
></para
></listitem>
</itemizedlist>

<para
>A passagem para outras plataformas que não o &Linux; foi feita por:</para>

<itemizedlist>
<listitem
><para
>FreeBSD: Hans Petter Bieker <email
>zerium@traad.lavvu.no</email
></para
></listitem>
</itemizedlist>

<para
>Tradução de José Nuno Pires <email
>zepires@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

