<chapter id="cups-configuration">
<title
>Configuração do Servidor de Impressão: CUPS</title>

<para
>Inicia a configuração do servidor de impressão (agora que já escolheste o &CUPS;, esta é a configuração do servidor do &CUPS;) carregando no botão apropriado. Descobri-lo-ás movendo lentamente o rato pelos botões e lendo as dicas. Deverá ser o 11º a contar da esquerda, ou o terceiro a contar da direita; o seu ícone é uma <guiicon
>chave de porcas</guiicon
>.</para>

<para
>Aparece então a janela de configuração do servidor de &CUPS;. Dá-te uma vista estruturada de todas as opções que se aplicam ao servidor. O seu ficheiro de configuração está localizado normalmente em <filename
>/etc/cups/cupsd.conf</filename
>. Este é um ficheiro normal em <acronym
>ASCII</acronym
> com uma sintaxe semelhante ao do servidor Web <application
>Apache</application
>. É uma boa ideia criar uma cópia de segurança, para o caso de algo correr mal na configuração através das janelas de Configuração do Servidor do &kdeprint;/&CUPS;:</para>

<screen
><userinput
><command
>cp</command
> <filename
>/etc/cups/cupsd.conf</filename
> <filename
>/etc/cups/cupsd.conf.bak</filename
></userinput
></screen>

<para
>Dado que esta interface gráfica para a edição do ficheiro de configuração ainda é uma novidade, deverás ter uma segunda oportunidade de voltares ao ficheiro original. Por isso, salvaguarda-o.</para>

<sect1 id="quick-help">
<title
>Ajuda Rápida</title>

<para
>Uma funcionalidade muito útil é a <quote
>Ajuda Rápida</quote
> disponível. Se carregares no pequeno ponto de interrogação (<guiicon
>O que é isto?</guiicon
>) na barra de título da tua janela, irá ver o cursor a mudar de forma. Agora carrega num campo de configuração do <command
>cupsd</command
> para descobrires o que significa e quais são as tuas opções. Na maioria dos casos deverás compreender o seu significado imediatamente, e mesmo que isso não aconteça tens sempre a excelente documentação do &CUPS;. (Se o teu servidor de &CUPS; estiver a correr, tê-la-ás na tua máquina em <ulink url="http://localhost:631/documentation.html"
>http://localhost:631/documentation.html</ulink
>).</para>
<para
>Se o &CUPS; não estiver a correr, mas estiver instalado no teu sistema, podê-lo ias encontrar no sistema de ficheiros da tua própria máquina. A localização exacta depende do teu sistema operativo, mas no &Linux; o valor por omissão é <filename class="directory"
>/usr/share/doc/cups/</filename
> ou <filename class="directory"
> /usr/share/doc/cups/documentation.html</filename
>.</para>

</sect1>
<sect1 id="longer-help">
<title
>Ajuda Extensa</title>

<para
>Para mais informações, mais detalhadas e mais recentes, deves sempre basear-te na documentação original do &CUPS;. O &CUPS; está, tal como o &kde;, num processo de desenvolvimento rápido. Existem constantemente novas funcionalidades, que poderão ser configuráveis apenas através da edição dos ficheiros de configuração. A &GUI; do &kdeprint; poderá não ter acompanhado o desenvolvimento do &CUPS;.</para>

<para
>Para o caso em que queiras olhar para os ficheiros de configuração originais do teu sistema &CUPS; -- estes estão aqui:</para>

<note>
<para
>Estes locais baseiam-se na instalação por omissão. O teu sistema operativo pode tê-los instalado num prefixo diferente, como por exemplo <filename class="directory"
>/usr/local/</filename
>, mas a hierarquia deve ser mais ou menos como em baixo.</para>
</note>

<variablelist>
<varlistentry>
<term
><filename class="directory"
>/etc/cups/</filename
></term>
<listitem>
<para
>A pasta com os ficheiros de configuração</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><filename
>/etc/cups/cupsd.conf</filename
></term>
<listitem>
<para
>O ficheiro de configuração para o servidor do &CUPS;</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><filename
>/etc/cups/printers.conf</filename
></term>
<listitem>
<para
>O ficheiro de configuração que contém a informação sobre as tuas impressoras locais.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><filename class="directory"
>/etc/cups/ppd/</filename
></term>
<listitem>
<para
>A pasta com os ficheiros &PPD; das impressoras instaladas.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>As ligações seguintes só funcionam se o teu servidor &CUPS; estiver em execução. Para acederes a toda a documentação original do &CUPS; vai a:</para>

<variablelist>
<varlistentry>
<term
><ulink url="http://localhost:631/documentation.html"
>http://localhost:631/documentation.html</ulink
></term>
<listitem>
<para
>Uma página com ligações para todos os outros documentos.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><ulink url="http://localhost:631/sam.html"
>http://localhost:631/sam.html</ulink
></term>
<listitem>
<para
>Acesso directo ao Manual de Administração de 'Software' do &CUPS; no formato <acronym
>HTML</acronym
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><ulink url="http://localhost:631/sam.pdf"
>http://localhost:631/sam.pdf</ulink
></term>
<listitem>
<para
>Acesso directo ao Manual de Administração de 'Software' do &CUPS; no formato <acronym
>PDF</acronym
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><ulink url="http://www.cups.org/documentation.html"
>http://www.cups.org/documentation.html</ulink
></term>
<listitem>
<para
>A última documentação 'online' do 'site' Web do &CUPS;.</para>
</listitem>
</varlistentry>
</variablelist>
<para
>As seguintes ligações dão-lhe acesso aos mesmos ficheiros (poderão faltar os ícones e imagens) mesmo que o seu servidor do CUPS não esteja a correr. Você necessitas, porém, de ter o CUPS instalado no seu sistema (Algumas distribuições poderão ter os ficheiros noutro local -- terá de ser você próprio a descobri-los...). Para aceder a toda a documentação original do &CUPS;, vá a:</para>

<para
>Esta documentação está disponíveis mesmo que o servidor do &CUPS; não esteja instalado, se bem que podes reparar na falta de algumas imagens e ícones ao veres os ficheiros <acronym
>HTML</acronym
>.</para>

<para
>Como foi referido em cima, a hierarquia em baixo deve estar intacta, mas o teu sistema operativo poderá ter instalado o &CUPS; num local diferente.</para>

<variablelist>
<varlistentry>
<term
><filename
>/usr/share/doc/cups/documentation.html</filename
></term>
<listitem>
<para
>Uma página com ligações para todos os outros documentos.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><filename
>/usr/share/doc/cups/sam.html</filename
></term>
<listitem>
<para
>Acesso directo ao Manual de Administração de 'Software' do &CUPS; no formato <acronym
>HTML</acronym
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><filename
>/usr/share/doc/cups/sam.pdf</filename
></term>
<listitem>
<para
>Acesso directo ao Manual de Administração de 'Software' do &CUPS; no formato <acronym
>PDF</acronym
>.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>Existem alguns 'sites' Web e grupos de discussão do &CUPS; (e da impressão no &Linux; em geral) para dar ajuda aos mais novatos em:</para>

<variablelist>
<varlistentry>
<term
><ulink url="http://www.cups.org/newsgroups.php"
>http://www.cups.org/newsgroups.php</ulink
></term>
<listitem>
<para
>O 'site' Web do &CUPS;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><ulink url="http://www.linuxprinting.org/newsportal/"
>http://www.linuxprinting.org/newsportal/</ulink
></term>
<listitem>
<para
>LinuxPrinting.org, a casa do HOWTO de impressão em &Linux; e da Base de Dados de Impressoras do &Linux;</para>
</listitem>
</varlistentry>
</variablelist>

<para
>E, finalmente, existirá um 'site' Web para o &kdeprint; e a documentação relacionada com ele em <ulink url="http://kdeprint.sourceforge.net/"
> http://kdeprint.sourceforge.net/</ulink
></para>

<para
>Na próxima secção eu guiar-te-ei através da maioria das opções de configuração do &kdeprint; com o &CUPS;.</para>

</sect1>
<sect1 id="explaining-different-gui-elements">
<title
>Explicando os diferentes elementos da &GUI;</title>

<sect2>
<title
>Janela Superior: Vista das Impressoras Reais e Virtuais</title>

<para
>Esta secção ainda não está completa</para>

<itemizedlist>
<listitem>
<para
>Janela em árvore, em ícones e como uma lista</para>
</listitem>
<listitem>
<para
>Os ícones da barra de tarefas</para>
</listitem>
<listitem>
<para
>Diferentes tipos de letra para diferentes impressoras</para>
</listitem>
<listitem>
<para
>Os diferentes ícones de impressoras significam diferentes coisas</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Janela Inferior: Vista por Secções dos Detalhes</title>

<para
>Esta secção ainda não está completa.</para>

<itemizedlist>
<listitem>
<para
>Os ícones da barra de tarefas</para>
</listitem>
<listitem>
<para
>As Secções</para>
</listitem>
<listitem>
<para
>Mudar a configuração das impressoras</para>
</listitem>
</itemizedlist>

</sect2>

</sect1>


<sect1 id="welcome-to-cups-server-configuration">
<title
>Bem-vindo à Configuração do Servidor do &CUPS;</title>

<para
>Este é o Ecrã de Boas-Vindas para as janelas de configuração do seu servidor. Ao carregar num dos itens da árvore à esquerda do ecrã, abre a componente apropriada da configuração.</para>

<para
>Cada opção tem um valor por omissão. Os valores por omissão permitem ao &CUPS; funcionar normalmente como um cliente perfeitamente funcional. Os clientes esperam no porto de TCP/IP 631 por difusões de informação dos servidores do &CUPS; na <acronym
>LAN</acronym
>. Esta informação permite aos clientes imprimir imediatamente após a sua recepção, sem terem de instalar qualquer controlador ou configurar qualquer impressora nos clientes.</para>

<para
>Para configurares um servidor do &CUPS; (que difunda o seu serviço para a <acronym
>LAN</acronym
>) tens de alterar os valores por omissão.</para>

<para
>O ecrã de boas-vindas da janela de configuração do servidor do &CUPS;. </para>
<screenshot>
<screeninfo
>Janela de configuração do servidor de &CUPS;: ecrã de boas-vindas</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration1_welcome.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para configurar o servidor de &CUPS;: ecrã de boas-vindas</phrase
></textobject>
<caption
><para
>A janela para configurar o servidor de &CUPS;: ecrã de boas-vindas</para
></caption>
</mediaobject>
</screenshot>

<para
>Para seleccionares o valor por omissão de qualquer item basta assinalares a opção à direita do ecrã. Para alterares o valor de um item, desliga a opção e efectua a tua alteração na parte esquerda do ecrã.</para>

<para
>A configuração completa do servidor inclui:</para>

<itemizedlist>
<listitem>
<para
><link linkend="server-general-configuration"
>Configuração Geral do <guilabel
>Servidor</guilabel
></link
></para>
</listitem>
<listitem>
<para
><link linkend="server-logging-configuration"
>Configuração dos <guilabel
>Registos</guilabel
> do Servidor</link
></para>
</listitem>
<listitem>
<para
><link
linkend="server-directories-configuration"
>Definições da Localização e <guilabel
>Pastas</guilabel
> do Servidor</link
></para>
</listitem>
<listitem>
<para
><link linkend="server-configuration"
>Configuração do Servidor <guilabel
>HTTP</guilabel
></link
></para>
</listitem>
<listitem>
<para
><link linkend="server-encryption-support-configuration"
>Configuração do Suporte de <guilabel
>Cifra</guilabel
> e Certificados do Servidor</link
></para>
</listitem>
<listitem>
<para
><link linkend="server-miscellaneous-configuration"
>Configurações <guilabel
>Diversas</guilabel
> do Servidor</link
></para>
</listitem>
<listitem>
<para
>Configuração Geral da <guilabel
>Rede</guilabel
></para>
</listitem>
<listitem>
<para
><link linkend="network-clients-configuration"
>Configuração dos <guilabel
>Clientes</guilabel
> da Rede</link
></para>
</listitem>
<listitem>
<para
><link
linkend="browsing-general-configuration"
>Configuração Geral da <guilabel
>Navegação</guilabel
></link
></para>
</listitem>
<listitem>
<para
><link linkend="browsing-connection-configuration"
>Configuração da <guilabel
>Ligação</guilabel
> de Navegação</link
></para>
</listitem>
<listitem>
<para
><link
linkend="browsing-masks-configuration"
>Configuração das <guilabel
>Máscaras</guilabel
> de Navegação</link
></para>
</listitem>
<listitem>
<para
><link linkend="browsing-timeouts-configuration"
>Configuração dos <guilabel
>Tempos-Limite</guilabel
> de Navegação</link
></para>
</listitem>
<listitem>
<para
><link linkend="browsing-relay-configuration"
>Configuração do <guilabel
>Reencaminhamento</guilabel
> da Navegação</link
></para>
</listitem>
<listitem>
<para
><link
linkend="security-configuration"
>Configuração da <guilabel
>Segurança</guilabel
></link
></para>
</listitem>
</itemizedlist>

<para
>Cada um destes itens de configuração será descrito nas secções seguintes do manual.</para>

</sect1>

<sect1 id="server-general-configuration">
<title
>Configuração Geral do Servidor</title>

<para
>A configuração geral do servidor é feita neste ecrã. Inclui:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Nome do servidor</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Email do administrador</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Utilizador do servidor</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Grupo do servidor</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Utilizador remoto</guilabel
></para
></listitem>
</itemizedlist>

<para
>A janela para as configurações gerais do servidor de &CUPS; permite-te alterar os valores por omissão. Carrega no pequeno ponto de interrogação e depois em qualquer campo para obteres uma <quote
>Ajuda Rápida</quote
> sobre o significado da opção.</para>

<para
>Se não tens a certeza, deixa estar e vai em primeiro lugar à documentação original do &CUPS;. Se o teu servidor do &CUPS; já estiver em execução, esta está acessível ao &konqueror; através do &URL; <ulink url="http://localhost:631/documentation.html"
> http://localhost:631/documentation.html</ulink
>.</para>

<para
>Aí, pode ter o primeiro contacto com o Manual de Administração do Software. Caso contrário, por exemplo, se o servidor do &CUPS; não estiver em execução, pode tentar ver no seu sistema de ficheiros local em <filename class="directory"
>/usr/share/doc/cups/</filename
> ou em <filename
>/usr/share/doc/cups/documentation.html</filename
>, os locais por omissão.</para>

<screenshot>
<screeninfo
>Janela de configuração geral do servidor de &CUPS;: ServerName, AdminMail, ServerUser, ServerGroup, RemoteUserName</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration2_general.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para configurar as opções gerais do servidor do &CUPS;: ServerName, AdminMail, ServerUser, ServerGroup, RemoteUserName </phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Nome do Servidor</guilabel
></term>
<listitem>
<para
>O nome do teu servidor, tal como anunciado para o mundo. Por omissão, o &CUPS; irá usar o nome da máquina no sistema. Para configurares o servidor por omissão usado pelos clientes, vê o ficheiro <filename
>client.conf</filename
>.</para>

<informalexample>
<para
>Por exemplo, escreve <userinput
>estamaquina.estedominio.com</userinput
></para>
</informalexample>

<para
>Este é o nome da máquina que é comunicado aos clientes. Se tiveres problemas estranhos no acesso ao servidor, indica aqui o seu endereço <acronym
>IP</acronym
> para tentares localizar o problema. Assim eliminas quaisquer problemas de resolução do nome das máquinas e podes mais facilmente localizar o problema real.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Email do administrador</guilabel
></term>
<listitem>
<para
>Este é o endereço de email para onde enviar todas as queixas ou problemas. Por omissão o &CUPS; irá usar o <quote
>root@nomemaquina</quote
>.</para>

<informalexample>
<para
>Por exemplo, escreve <userinput
>root@estamaquina.com</userinput
>.</para>
</informalexample>

<note>
<para
>Ao contrário do que a ajuda rápida sugere, também é possível enviar um e-mail com entusiasmo acerca do &CUPS; e do &kdeprint; ao administrador do sistema.</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Utilizador do Servidor</guilabel
></term>
<listitem>
<para
>O utilizador com que o servidor está a correr. Este é normalmente o <systemitem class="username"
>lp</systemitem
>, mas podes configurar outro utilizador se necessário.</para>

<note>
<para
>O servidor necessita de ser executado inicialmente como root para suportar o porto de <acronym
>IPP</acronym
> por omissão 631. Altera os utilizadores sempre que é executado um programa exterior.</para>
</note>

<informalexample>
<para
>Escreve por exemplo <userinput
>lp</userinput
>.</para>
</informalexample>

<para
>Esta é a conta de utilizador de &UNIX; por omissão para os filtros e programas <acronym
>CGI</acronym
> serem executados. Os programas <acronym
>CGI</acronym
> são responsáveis por lhe mostrar a interface de administração Web que está acessível em <ulink url="http://localhost:631/"
>http://localhost:631/</ulink
>).</para>

<warning>
<para
>Não há a necessidade de alterar a directiva <guilabel
>User</guilabel
> para <systemitem class="username"
>root</systemitem
>, por isso nunca o faças, porque pode envolver perigos. Se alguém descobrir vulnerabilidades do sistema num dos filtros de ficheiros usados, controladores ou programas <acronym
>CGI</acronym
>, pode executar comandos arbitrários no teu sistema com privilégios de 'root'. Usa sempre uma conta não-privilegiada para a directiva do servidor <guilabel
>User</guilabel
>.</para>
</warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Grupo do servidor</guilabel
></term>
<listitem>
<para
>O grupo com o qual o servidor se executa. Normalmente deve ser o <systemitem class="groupname"
>sys</systemitem
>, mas podes configurar as coisas para outro grupo se necessário.</para>

<informalexample>
<para
>Escreve por exemplo <userinput
>sys</userinput
>.</para>
</informalexample>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Utilizador remoto</guilabel
></term>
<listitem>
<para
>O nome do utilizador atribuído aos acessos não-autenticados dos sistemas remotos. Por omissão é o <userinput
>remroot</userinput
>.</para>

<para
>Este nome irá aparecer nos ficheiros de registo e nas pesquisas sobre o dono da tarefa &etc;, para todos os recursos e localizações do servidor de &CUPS; que estão configurados para permitir o acesso <emphasis
>sem</emphasis
> autenticação. Os registos não autenticados irão transportar os nomes autenticados.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="server-logging-configuration">
<title
>Configuração dos Registos do Servidor</title>

<para
>A configuração dos registos do servidor é feita neste ecrã. Esta inclui:</para>

<itemizedlist>
<listitem
><para
>Configuração do <guilabel
>ficheiro de registo de acessos</guilabel
></para
></listitem>
<listitem
><para
>Configuração do <guilabel
>ficheiro de registo de erros</guilabel
></para
></listitem>
<listitem
><para
>Configuração do ficheiro de <guilabel
>registo de páginas</guilabel
></para
></listitem>
<listitem
><para
>Configuração do <guilabel
>nível de registo</guilabel
></para
></listitem>
<listitem
><para
>Configuração do <guilabel
>tamanho máximo do ficheiro de registo</guilabel
></para
></listitem>
</itemizedlist>

<para
>Este é um ecrã importante para ti. Se alguma vez encontrares problemas: este é o local para definires o nível de registo para <quote
>debug</quote
>, reiniciares o servidor do &CUPS; e então olhares para o registo de erros aqui definido para veres os elementos que te possam dar uma ideia do problema.</para>

<screenshot>
<screeninfo
>Janela de configuração do servidor do &CUPS;: <guilabel
>Registos do servidor</guilabel
> </screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration3_logging.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para configurar o servidor do &CUPS;: <guilabel
>Registos do servidor</guilabel
></phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Registo de acessos</guilabel
></term>
<listitem>
<para
>Aqui é onde os acessos ao servidor são registados. Se não começar por um <literal
>/</literal
>, assume-se relativo à raiz do servidor.</para>

<para
>Podes também usar o nome especial <userinput
>syslog</userinput
> para enviar o resultado para o ficheiro ou servidor 'syslog'.</para>

<informalexample>
<para
>Indica um nome de ficheiro, como por exemplo <userinput
><filename
>/var/log/cups/acces_log</filename
></userinput
>.</para>
</informalexample>

<para
>Este ficheiro é armazenado no formato comum <quote
>Common Log Format</quote
>. Desta forma podes usar programas como o <application
>Webalyzer</application
> ou outra ferramenta de acesso à Web para gerar os relatórios da actividade do servidor do &CUPS;.</para>

<para
>Para incluíres o nome do servidor no nome do ficheiro utiliza um <token
>%s</token
> neste. Exemplo: <userinput
><filename
>/var/log/cups/access_log-%s</filename
></userinput
>.</para>

<screen
><prompt
>kurt@transmeta:~ 
></prompt
><userinput
><command
>tail</command
> <parameter
>/var/log/cups/access_log</parameter
></userinput>
<computeroutput>
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST /printers/ HTTP/1.1" 200 109
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST /admin/ HTTP/1.1" 401 0
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST / HTTP/1.1" 200 210
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "GET /ppd/DANKA_P450.ppd HTTP/1.1" 200 51021
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST /jobs/ HTTP/1.1" 200 246
10.160.16.45 - - [04/Aug/2001:20:11:39 +0100] "GET /printers/DANKA_P450 HTTP/1.0" 200 0
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST / HTTP/1.1" 200 80
127.0.0.1    - - [04/Aug/2001:20:11:39 +0100] "POST / HTTP/1.1" 200 139
10.160.16.45 - - [04/Aug/2001:20:11:40 +0100] "GET /cups.css HTTP/1.0" 200 198
127.0.0.1    - - [04/Aug/2001:20:11:40 +0100] "POST / HTTP/1.1" 200 139
10.160.16.45 - - [04/Aug/2001:20:11:39 +0100] "GET /printers/DANKA_P450 HTTP/1.0" 200 7319
10.160.16.45 - - [04/Aug/2001:20:11:40 +0100] "GET /images/title-logo.gif HTTP/1.0" 200 5729
</computeroutput
></screen>

<para
>Poderá ver uma linha em separado para cada acesso único, a qual mostra o endereço <acronym
>IP</acronym
> do cliente que acedeu, a data e hora do acesso, o método de acesso (<command
>POST</command
> ou <command
>GET</command
>), o recurso referenciado, a versão do &HTTP; usada pelo cliente, o código de estado e o número de 'bytes' transferidos. O código de estado <errorcode
>200</errorcode
> significa <errorname
>com sucesso-OK</errorname
>; o <errorcode
>401</errorcode
> acima foi um <errorname
>acesso não-autorizado</errorname
>, o qual foi recusado. Para uma explicação mais detalhada do formato do registo vá ao <ulink url="http://localhost:631/sam.html#7_6_1"
>Manual de Administração do 'Software' do &CUPS;</ulink
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Registo de erros</guilabel
></term>
<listitem>
<para
>Se este não começar com um <literal
>/</literal
>, então assume-se como relativo à raiz do servidor. O valor por omissão é <filename
>/var/log/cups/error_log</filename
>.</para>

<para
>Podes também usar o nome especial <userinput
>syslog</userinput
> para enviar o resultado para o ficheiro ou servidor 'syslog'.</para>

<informalexample>
<para
>Indica a sua localização, como por exemplo <userinput
><filename
>/var/log/cups/error_log</filename
></userinput
>.</para>
</informalexample>

<para
>O excerto do registo de erros em baixo mostra-te a parte registada por imprimir a página de teste com o valor por omissão de <guilabel
>Nível de registo</guilabel
> igual a <quote
>info</quote
>. Para uma explicação sobre o <guilabel
>Nível de Registo</guilabel
> vê mais abaixo.</para>

<screen
><prompt
>kurt@transmeta:~ 
></prompt
><userinput
><command
> tail </command
> <parameter
>/var/log/cups/error_log</parameter
></userinput>
<computeroutput>
I [04/Aug/2001:23:15:10 +0100] Job 213 queued on 'DANKA_P450' by 'root'
I [04/Aug/2001:23:15:10 +0100] Started filter /usr/lib/cups/filter/pstops (PID 18891) for job 213.
I [04/Aug/2001:23:15:10 +0100] Started backend /usr/lib/cups/backend/lpd (PID 18892) for job 213.
</computeroutput
></screen>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Registo de páginas</guilabel
></term>
<listitem>
<para
>Se este não começar com um <literal
>/</literal
>, então assume-se como relativo à raiz do servidor. O valor por omissão é <filename
>/var/log/cups/page_log</filename
>.</para>

<para
>Podes também usar o nome especial <userinput
>syslog</userinput
> para enviar o resultado para o ficheiro ou servidor 'syslog'.</para>

<informalexample>
<para
>Indica a sua localização, como por exemplo <userinput
><filename
>/var/log/cups/page_log</filename
></userinput
>.</para>
</informalexample>
<para
>O registo de páginas tem uma linha por cada página de uma tarefa impressa.</para>

<para
>Aqui pode-se ver como alguns campos aparecem:</para>

<screen
><prompt
>kurt@transmeta:~ 
></prompt
><userinput
><command
> tail </command
> <parameter
>/var/log/cups/page_log</parameter
></userinput>
<computeroutput>
GIMP_print_stp_HP kdetest 201 [03/Aug/2001:03:18:03 +0100] 4 1
GIMP_print_stp_HP kdetest 201 [03/Aug/2001:03:18:03 +0100] 5 1
GIMP_print_stp_HP kdetest 202 [03/Aug/2001:11:46:49 +0100] 1 1
GIMP_print_stp_HP kdetest 203 [03/Aug/2001:11:46:54 +0100] 1 1
DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 1 33
DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 2 33
DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 3 33
DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 4 33
DANKA_infotec_P450 root 205 [04/Aug/2001:19:12:34 +0100] 1 14
DANKA_infotec_P450 root 206 [04/Aug/2001:19:15:20 +0100] 1 1
</computeroutput
></screen>

<para
>Neste excerto do ficheiro podes obter informações sobre o nome das impressoras (<systemitem class="resource"
>GIMP_print_stp_HP</systemitem
> e <systemitem class="resource"
>DANKA_infotec_P450</systemitem
>) usadas através deste servidor, os nomes dos utilizadores (<systemitem class="username"
>kdetest</systemitem
>, <systemitem class="username"
>kurt</systemitem
> e <systemitem class="username"
>root</systemitem
>), os IDs das tarefas (<quote
>201</quote
> a <quote
>205</quote
>), a hora da impressão, o número de página dentro da tarefa e o número de cópias das páginas. Por exemplo, a tarefa 204 teve 4 páginas e 33 cópias, enquanto a tarefa 205 teve 14 cópias de 1 página).</para>

<note>
<para
>O &CUPS; está dependente (para o seu cálculo do número de páginas de uma tarefa) de passar o &PostScript; pelo filtro <quote
>pstops</quote
>. Vê o <link linkend="architecture-diagram"
>Fluxograma do &kivio;</link
> da arquitectura de filtros do &CUPS; para teres uma ideia onde este filtro se encaixa em todo o processo de impressão). Mais, o <command
>pstops</command
> depende na contagem de <acronym
>DSC</acronym
> (as <acronym
>DSC</acronym
> são Document Structuring Conventions, a standard defined by Adobe) enviadas pelo cliente. Na maior parte dos casos isto é funcional.</para>

<para
>Contudo, esta contabilidade de páginas não funciona para as filas de impressão <quote
>sem formato</quote
> (dado que estas, por definição, não efectuam nenhuma filtragem na máquina do &CUPS; e por isso não passam pelo <command
>pstops</command
>.) Cada tarefa que passe por uma fila <quote
>sem formato</quote
> é contada como uma tarefa com 1 página (com múltiplas cópias possíveis). Isto é especialmente verdade para todas as tarefas enviadas dos clientes do &Microsoft; &Windows; através do <application
>Samba</application
> para o servidor do &CUPS;, dado que estas tarefas já chegam no formato correcto à impressora, dado que os clientes utilizam o controlador original da impressora.</para>
</note>

<note>
<para
>Ainda estou à espera que alguém faça uma ferramenta agradável de análise dos registos de páginas do &CUPS;. Esta deve gerar um relatório com um aspecto gráfico semelhante ao dos registos do <application
>Webalizer</application
>. Desta forma poderás ter estatísticas claras que possam ser usadas para contabilizar a utilização das impressoras e a dependência da carga em relação à hora ou dia da semana, utilizadores &etc;. Alguém se oferece?</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Nível de registo</guilabel
></term>
<listitem>
<para
>Esta opção controla o número de mensagens registadas no ficheiro de erros. Podes ser uma das seguintes:</para>

<variablelist>
<varlistentry>
<term
>debug2</term>
<listitem>
<para
>Registar tudo.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>debug</term>
<listitem>
<para
>Registar quase tudo.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>info</term>
<listitem>
<para
>Registar todos os pedidos e mudanças de estado.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>warn</term>
<listitem>
<para
>Registar os erros e avisos.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>error</term>
<listitem>
<para
>Registar apenas os erros.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>none</term>
<listitem>
<para
>Não registar nada.</para>
</listitem>
</varlistentry>

</variablelist>

<para
>Se precisares de descobrir problemas (ou se quiseres estudar o funcionamento interno do &CUPS;), altera o nível de registo para debug ou debug2. Aí o registo de erros terá muito mais entradas (não apenas os erros, mas também mensagens informativas).</para
> 

<para
>Podes usar isto para assistires <quote
>ao vivo</quote
> o que o &CUPS; está a fazer quando envias uma tarefa de impressão. Num &konsole; escreve:</para>

<screen
><prompt
>kurt@transmeta:~ 
></prompt
><userinput
><command
>tail</command
> <option
>-f</option
> <option
>-n</option
><parameter
>100</parameter
> <parameter
>/var/log/cups/error_log</parameter
></userinput
></screen>

<para
>Isto dar-te-á as últimas 100 linhas (<option
>-n</option
> <parameter
>100</parameter
>) do ficheiro no ecrã e uma actualização <quote
>em tempo-real</quote
> (<option
>-f</option
>) do que se está a passar. A lista seguinte mostra a impressão de uma página de teste (algumas partes foram cortadas por razões de espaço... Tenta por ti próprio se necessitas de mais informações):</para>

<screen
><computeroutput
> 
I [04/Aug/2001:23:15:12 +0100] Job 214 queued on 'DANKA_P450' by 'root'
D [04/Aug/2001:23:15:12 +0100] StartJob(214, 08426fe0) 
D [04/Aug/2001:23:15:12 +0100] StartJob() id = 214, file = 0/1 
D [04/Aug/2001:23:15:12 +0100] job-sheets=none,none 
D [04/Aug/2001:23:15:12 +0100] banner_page = 0 
D [04/Aug/2001:23:15:12 +0100] StartJob: argv = "DANKA_P450","214","root","KDE Print Test",
[....]  
D [04/Aug/2001:23:15:12 +0100] StartJob: envp = "PATH=/usr/lib/cups/filter:/bin:/usr/bin", [....]  
D [04/Aug/2001:23:15:12 +0100] StartJob: statusfds = 5, 6 
D [04/Aug/2001:23:15:12 +0100] StartJob: filterfds[1] = 7, -1 
D [04/Aug/2001:23:15:12 +0100] StartJob: filter = "/usr/lib/cups/filter/pstops" 
D [04/Aug/2001:23:15:12 +0100] StartJob: filterfds[0] = 8, 9 
D [04/Aug/2001:23:15:12 +0100] start_process("/usr/lib/cups/filter/pstops", [....]  
I [04/Aug/2001:23:15:12 +0100] Started filter /usr/lib/cups/filter/pstops (PID 18991) for job 214.  
D [04/Aug/2001:23:15:12 +0100] StartJob: backend = "/usr/lib/cups/backend/lpd" 
D [04/Aug/2001:23:15:12 +0100] StartJob: filterfds[1] = -1, 7 
D [04/Aug/2001:23:15:12 +0100] start_process("/usr/lib/cups/backend/lpd", [....]  
I [04/Aug/2001:23:15:12 +0100] Started backend /usr/lib/cups/backend/lpd (PID 18992) for job 214.
D [04/Aug/2001:23:15:12 +0100] Page = 595x842; 15,16 to 580,833 [....]  </computeroutput
></screen
> 

<para
>As linhas marcadas como <quote
>D</quote
> no início são mensagens do nível de depuração, enquanto que as <quote
>I</quote
> são do nível de registo <quote
>info</quote
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tamanho máximo do ficheiro de registo</guilabel
></term>
<listitem>

<para
>Controla o tamanho máximo de cada ficheiro de registo antes de serem 'rodados' (arquivados). O valor por omissão é 1048576 (1 Mb). Põe igual a 0 para desligares a rotação de registos.</para>

<informalexample>
<para
>Indica um tamanho em 'bytes', como por exemplo <userinput
>1048576</userinput
></para>
</informalexample>

</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="server-directories-configuration">
<title
>Configuração das Pastas do Servidor</title>

<para
>A janela para configurar o servidor do &CUPS;. Podem ser configuradas aqui as diferentes pastas. Normalmente, o utilizador não necessita de alterar nada nesta secção. Para o caso de lidar com tipos de letra bonitos (TrueType, &PostScript; ou outros) no seu sistema, este é o local para você configurar esses tipos de letra ao imprimir. A configuração das pastas do servidor inclui:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Executáveis</guilabel
>: onde encontrar os executáveis do servidor</para>
</listitem>
<listitem>
<para
><guilabel
>Configuração</guilabel
>: onde encontrar os ficheiros de configuração</para>
</listitem>
<listitem>
<para
><guilabel
>Dados</guilabel
>: onde encontrar os ficheiros de dados do servidor</para>
</listitem>
<listitem>
<para
><guilabel
>Ficheiros temporários</guilabel
>: onde colocar os ficheiros de impressão temporários </para>
</listitem>
<listitem>
<para
><guilabel
>Pedidos Temporários</guilabel
>: onde encontrar o servidor </para>
</listitem>
<listitem>
<para
><guilabel
>Localização dos Tipos de Letra</guilabel
>: onde encontrar os tipos de letra do servidor</para>
</listitem>
</itemizedlist>
<screenshot>
<screeninfo
>Janela de configuração do servidor do &CUPS;: configuração do &HTTP;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration4_directories.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para configurar o servidor do &CUPS;: configuração do &HTTP;</phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Executáveis</guilabel
></term>
<listitem>
<para
>A pasta de base para os executáveis do escalonador. Por omissão esta é a <filename class="directory"
>/usr/lib/cups</filename
> (ou a <filename class="directory"
>/usr/lib32/cups</filename
> no IRIX 6.5)</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Configuração</guilabel
></term>
<listitem>
<para
>A pasta base do escalonador. Por omissão é a <filename class="directory"
>/etc/cups</filename
>.</para>
<para
>No sistema SuSE do autor, esta é a <filename class="directory"
>/usr/share/doc/cups</filename
>. Contém toda a documentação <acronym
>HTML</acronym
> ou <acronym
>PDF</acronym
> do &CUPS; e está disponível através da interface Web em <ulink url="http://localhost:631/documentation.html"
> http://localhost:631/documentation.html</ulink
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Dados</guilabel
></term>
<listitem>
<para
>A pasta de base dos ficheiros de dados do &CUPS;. Por omissão é a <filename class="directory"
>/usr/share/cups</filename
></para>
<para
>Contém várias coisas como 'banners', codificações, dados, controladores, tipos de letra e modelos do <command
>pstoraster</command
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ficheiros temporários</guilabel
></term>
<listitem>
<para
>A pasta onde colocar ficheiros temporários. Esta pasta deve ter permissões de escrita para o utilizador definido no ecrã anterior. A pasta por omissão é <filename class="directory"
>/var/spool/cups/tmp</filename
> ou o valor da variável de ambiente <envar
>TMPDIR</envar
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Pedidos Temporários</guilabel
></term>
<listitem>
<para
>A pasta onde os ficheiros dos pedidos são guardados. Por omissão é a <filename class="directory"
>/var/spool/cups</filename
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Directoria de tipos de letra</guilabel
></term>
<listitem>
<para
>O local onde configurar os teus tipos de letra bonitos (TrueType ou &PostScript;). O &CUPS; irá procurar aqui pelos tipos de letra a incluir nos ficheiros de impressão. Isto só afecta de momento o filtro <command
>pstoraster</command
>, e o valor por omissão é o <filename class="directory"
>/usr/share/cups/fonts</filename
>.</para>

<para
>Para indicar mais do que uma pasta, liste-as com dois pontos como separador, como a forma seguinte:</para>

<informalexample>
<para
><userinput
>/local/da/primeira/directoria/:/local/da/segunda/directoria/:/local/da/terceira/directoria</userinput
></para>
</informalexample>

<para
>Para a directiva Font funcionar como o pretendido, a aplicação que quiser imprimir deve:</para>

<itemizedlist>
<listitem>
<para
>Referenciar correctamente os tipos de letra desejados no cabeçalho do &PostScript; gerado</para>
</listitem>
<listitem>
<para
>Ou inclui o tipo de letra no ficheiro &PostScript;.</para>
</listitem>
</itemizedlist>

<para
>A <emphasis
>referência</emphasis
> ao tipo de letra pelo seu nome é da responsabilidade do <acronym
>RIP</acronym
> e do dispositivo de impressão para que este o possa usar. O <acronym
>RIP</acronym
> ou a impressora <emphasis
>podem</emphasis
> usar o tipo de letra somente se estiver disponível no sistema.</para>

<para
>No caso de uma impressora &PostScript;, este deve ser um tipo de letra residente na impressora. Se as impressoras não tiverem este tipo de letra, irão tentar substituir por um tipo de letra equivalente.</para>

<para
>No caso de uma impressora não-&PostScript;, isto é feito pelo &CUPS; e pelo seu sistema de filtragem <acronym
>RIP</acronym
>. O &CUPS; irá usar a directiva da localização dos tipos de letra para obter o tipo de letra correcto ao converter o &PostScript; no filtro <command
>pstoraster</command
>. </para>

<para
>No caso de um dispositivo &PostScript;, o &CUPS; apenas escalona o ficheiro (de facto, pass-o através do filtro <command
>pstops</command
> para contabilizar as páginas ou para o processamento 'n-up'), não <quote
>mexendo</quote
> nele. Por isso, se imprimires para uma impressora &PostScript; é da responsabilidade exclusiva da impressora de usar o tipo de letra pedido. Não o conseguirá, se o tipo de letra não estiver carregado na impressora nem embebido no &PostScript;. </para>
</listitem>
</varlistentry>
</variablelist>

</sect1>
<sect1 id="server-configuration">
<title
>Configuração do Servidor <acronym
>HTTP</acronym
></title>

<para
>A janela para configurar as opções de &HTTP; do &CUPS; é mostrada aqui. </para>
<para
>A configuração de &HTTP; do servidor do &CUPS; tem as seguintes opções: </para>
<itemizedlist>
<listitem
><para
>a <guilabel
>Pasta de documentos</guilabel
></para
></listitem>
<listitem
><para
>a <guilabel
>Língua por Omissão</guilabel
></para
></listitem>
<listitem
><para
>a <guilabel
>Codificação por Omissão</guilabel
></para
></listitem>
</itemizedlist>

<screenshot>
<screeninfo
>Janela para configurar as opções de &HTTP; do servidor do &CUPS; </screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration5_HTTP.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela para configurar as opções de &HTTP; do servidor do &CUPS; </phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Pasta de documentos</guilabel
></term>
<listitem>
<para
>A pasta de base para os documentos de &HTTP; que são servidos. Esta é por omissão a <filename class="directory"
>/usr/share/cups/doc</filename
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Língua por Omissão</guilabel
></term>
<listitem>
<para
>A língua por omissão, se não for especificada pelo navegador. Se esta não estiver seleccionada, assume-se a localização actual.</para>
<informalexample>
<para
>Utiliza os códigos de localização de duas letras, como por exemplo <userinput
>en</userinput
> ou <userinput
>de</userinput
>.</para>
</informalexample>
<!-- available languages? -->
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Codificação por omissão</guilabel
></term>
<listitem>
<para
>O mapa de caracteres a usar por omissão. Se não for especificado, este é igual a UTF-8. Isto também pode ser alterado directamente nos documentos <acronym
>HTML</acronym
>.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="server-encryption-support-configuration">
<title
><guilabel
>Configuração do suporte de cifra do servidor</guilabel
></title>

<para
>Esta é a janela onde se configuram as opções relacionadas com a segurança do servidor do &CUPS;. As opções de suporte à cifra do servidor são: </para>

<itemizedlist>
<listitem
><para
><guilabel
>Certificado do servidor</guilabel
>: o ficheiro a ler que contém o certificado do servidor</para
></listitem
> 
<listitem
><para
>Chave do servidor: o ficheiro a ler que contém a chave do servidor</para
></listitem>
</itemizedlist>
<screenshot>
<screeninfo
>Janela de configuração do servidor do &CUPS;: introdução à segurança</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration6_encryption.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para a configuração de segurança do servidor do &CUPS;</phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Certificado do servidor</guilabel
></term>
<listitem>
<para
>O ficheiro a ler que contém o certificado do servidor. Por omissão é <filename
>/etc/cups/ssl/server.crt</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Chave do servidor</guilabel
></term>
<listitem>
<para
>O ficheiro a ler que contém a chave do servidor. É por omissão igual a <filename
>/etc/cups/ssl/server.key</filename
></para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="server-miscellaneous-configuration">
<title
>Configurações Diversas do Servidor</title>

<para
>A janela para configurar as opções diversas do servidor do &CUPS; é mostrada aqui. As seguintes opções do servidor são alteradas através deste ecrã:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Preservar histórico das tarefas</guilabel
>: se se deve preservar um histórico das tarefas para consultar posteriormente</para
></listitem>
<listitem
><para
><guilabel
>Preservar os ficheiros das tarefas</guilabel
>: se se deve preservar os ficheiros <acronym
>RIP</acronym
> das tarefas para reimprimir posteriormente</para
></listitem
>  
<listitem
><para
><guilabel
>Ficheiro 'printcap'</guilabel
>: alterar o nome e a localização do ficheiro 'printcap'</para
></listitem>
<listitem
><para
><guilabel
>'Cache' de RIP</guilabel
>: alterar o tamanho da 'cache' do <acronym
>RIP</acronym
> na memória</para
></listitem>
<listitem
><para
><guilabel
>Limite do Filtro</guilabel
>: definir um limite do filtro</para
></listitem>
</itemizedlist>

<screenshot>
<screeninfo
>Janela para configurar as opções diversas do servidor de &CUPS;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration7_miscellanious.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela para configurar as opções diversas do servidor de &CUPS;</phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Preservar o histórico das tarefas (depois de completas)</guilabel
></term>
<listitem>
<para
>Se deve ser preservado ou não o histórico das tarefas depois destas terem terminado, sido canceladas ou interrompidas. O valor por omissão é sim.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Preservar o ficheiro da tarefa (depois de completa)</guilabel
></term>
<listitem>
<para
>Se deve ser preservado ou não os ficheiros das tarefas depois destas terem terminado, sido canceladas ou interrompidas. O valor por omissão é não.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ficheiro 'printcap'</guilabel
></term>
<listitem>
<para
>O nome do ficheiro 'printcap'. O valor por omissão está em branco. Deixa isto em branco para evitares a geração do ficheiro 'printcap'.</para>
<para
>A configuração do 'printcap' só é necessária para satisfazer as aplicações mais antigas que necessitam desse ficheiro.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>'Cache' do RIP</guilabel
></term>
<listitem>
<para
>A quantidade de memória que cada <acronym
>RIP</acronym
> deve usar para 'cache' das imagens. O valor pode ser qualquer número real seguido de um <quote
>k</quote
> para quilobytes, <quote
>m</quote
> para megabytes, <quote
>g</quote
>para gigabytes, ou <quote
>t</quote
> para padrões, em que cada padrão tem 256 x 256 pixels. O valor por omissão é 8m.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Limite do filtro</guilabel
></term>
<listitem>
<para
>Define o custo máximo para todos os filtros de tarefas que podem ser executados ao mesmo tempo. Um limite igual a 0 significa a inexistência de limites. Uma tarefa típica pode necessitar de um limite de filtro de pelo menos 200. Os limites menores que o mínimo necessário para uma tarefa obrigam a que seja impressa uma única tarefa de cada vez. O valor por omissão é 0 (sem limite).</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="network-general-configuration">
<title
>Configuração Geral da Rede</title>

<para
>A janela para configurar as opções de rede do servidor do &CUPS; é mostrada aqui. Inclui:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Procurar o nome da máquina nos endereços IP</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Porto</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Tamanho máximo do pedido</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Tempo-limite</guilabel
></para
></listitem>
</itemizedlist>

<screenshot>
<screeninfo
>Janela para configurar as opções de rede do servidor do &CUPS;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration8_networkgeneral.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela para configurar as opções de rede do servidor do &CUPS;</phrase
></textobject>
</mediaobject>
</screenshot>
<variablelist>
<varlistentry>
<term
><guilabel
>Procurar o nome da máquina nos endereços IP</guilabel
></term>
<listitem>
<para
>Se deve ser efectuada ou não a pesquisa de endereços <acronym
>IP</acronym
> para obter um nome de máquina completo. Por omissão encontra-se desligado, por razões de performance.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Porto</guilabel
></term>
<listitem>
<para
>Indica aqui os portos e os endereços nos quais o servidor irá ficar à espera. O porto 631 está reservado por omissão para o Internet Printing Protocol, e é o que usamos aqui.</para>
<para
>Podes ter vários registos, para esperar em mais do que um porto ou endereço ou para restringir o acesso.</para>
<note>
<para
>Infelizmente a maioria dos navegadores Web não suportam o <acronym
>TLS</acronym
> ou as actualizações de &HTTP; para cifra. Se quiseres suportar cifra baseada na Web, terás provavelmente de atender pedidos no porto 443, o porto de <acronym
>HTTPS</acronym
>.</para>
</note>
<para
>Usa os botões <guibutton
>Adicionar</guibutton
> e <guibutton
>Remover</guibutton
> para adicionar e remover elementos da lista.</para>
<informalexample>
<para
>Podes indicar números de portos únicos, como por exemplo <userinput
>631</userinput
>, ou nomes máquinas com portos, como o <userinput
>estamaquina:80</userinput
> ou <userinput
>1.2.3.4:631</userinput
>.</para>
</informalexample>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tamanho máximo do pedido</guilabel
></term>
<listitem>
<para
>Controla o tamanho máximo dos pedidos e ficheiros de impressão de &HTTP;. O valor por omissão é 0, o que desactiva esta funcionalidade.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tempo-limite</guilabel
></term>
<listitem>
<para
>O tempo-limite (em segundos) antes dos pedidos expirarem. O valor por omissão é 300 segundos.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="network-clients-configuration">
<title
>Configuração dos Clientes da Rede</title>

<para
>A janela para configurar as opções do cliente de rede do &CUPS; é mostrada aqui. Inclui:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Aceitar pedidos de "Keep Alive"</guilabel
></para
></listitem>
<listitem
><para
>KeepAliveTimeout:</para
> </listitem>
<listitem
><para
>MaxClients: </para
></listitem>
</itemizedlist>
<screenshot>
<screeninfo
>janela para configurar as opções do cliente de rede do &CUPS;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration9_networkclients.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela para configurar as opções do cliente de rede do &CUPS;</phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Aceitar pedidos de "Keep Alive"</guilabel
></term>
<listitem>
<para
>Se se deve manter a ligação de pé ou não. O valor por omissão é 'sim'.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tempo-limite de 'keep-alive'</guilabel
></term>
<listitem>
<para
>O tempo-limite (em segundos) antes das ligações Keep-Alive serem fechadas automaticamente. O valor por omissão é 60 segundos.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Número máximo de clientes</guilabel
></term>
<listitem>
<para
>Controla o número máximo de clientes simultâneos a tratar. O valor por omissão é 100.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="browsing-general-configuration">
<title
>Configuração Geral da Navegação</title>

<para
>A janela para configurar as opções gerais de navegação do &CUPS; é mostrada aqui. Inclui: </para>

<itemizedlist>
<listitem
><para
><guilabel
>Activar a navegação</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Usar nomes curtos quando possível</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Usar classes implícitas</guilabel
></para
></listitem>
</itemizedlist>


<screenshot>
<screeninfo
>Janela para configurar as opções gerais de navegação do &CUPS;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration10_browsinggeneral.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela para configurar as opções gerais de navegação do &CUPS;</phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Activar a navegação</guilabel
></term>
<listitem>
<para
>Se se deve difundir a informação das impressoras para os outros servidor de &CUPS; ou não. Está activo por omissão.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Usar nomes curtos quando possível</guilabel
></term>
<listitem>
<para
>Se se deve usar ou não nomes <quote
>curtos</quote
> para as impressoras remotas sempre que possível (por exemplo, <systemitem class="resource"
>impressora</systemitem
> em vez de <systemitem class="resource"
>impressora@maquina</systemitem
>). Está activo por omissão.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Usar classes implícitas</guilabel
></term>
<listitem>
<para
>Se se deve usar ou não classes implícitas.</para>
<para
>As classes de impressoras podem ser especificadas explicitamente no ficheiro <filename
>classes.conf</filename
>, baseando-se implicitamente nas impressoras disponíveis na <acronym
>LAN</acronym
> ou em ambas.</para>
<para
>Quando as classes implícitas estão activas, as impressoras na <acronym
>LAN</acronym
> com o mesmo nome (por exemplo, <systemitem class="resource"
>Acme-LaserPrint-1000</systemitem
>) serão colocadas numa classe com o mesmo nome. Isto permite-te configurar várias filas redundantes numa <acronym
>LAN</acronym
> sem um conjunto de dificuldades administrativas. Se um utilizador enviar uma tarefa para a <systemitem class="resource"
>Acme-LaserPrint-1000</systemitem
>, a tarefa irá para a primeira fila disponível.</para>
<para
>Esta opção está activa por omissão.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>
<sect1 id="browsing-connection-configuration">
<title
>Configuração da Ligação de Navegação</title>

<para
>A janela para configurar a ligação de navegação do servidor do &CUPS; é mostrada aqui. As opções da ligação de navegação incluem:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Endereços de difusão</guilabel
>: O endereço de difusão (<acronym
>UDP</acronym
>) para onde transmitir as informações das impressoras</para
></listitem>
<listitem
><para
><guilabel
>Porto de Difusão</guilabel
>: O número de porto a usar para a difusão</para
></listitem
> 
<listitem
><para
><guilabel
>Endereços de pesquisa</guilabel
>: O(s) endereço(s) onde pesquisar por informações acerca dass impressoras nos servidores que podem não difundir (ou cujos pacote podem não atingir a tua <acronym
>LAN</acronym
> por causa de 'routers' pelo caminho).</para
></listitem>
</itemizedlist>

<screenshot>
<screeninfo
>Janela para configurar a ligação de navegação do servidor do &CUPS;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration11_browsingconnections.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela para configurar a ligação de navegação do servidor do &CUPS;</phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Endereços de difusão</guilabel
></term>
<listitem>
<para
>Depois de carregares no botão <guibutton
>Adicionar</guibutton
>, irás ver a janela seguinte para indicares um novo valor para os pacotes de navegação difundidos. É o mesmo tipo de janela que existe para adicionares outros endereços do servidor para pesquisar para informações.</para>

<screenshot>
<screeninfo
>A janela para indicar um novo valor para onde difundir os pacotes de navegação</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfig_browsingmasks_add_button.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para indicar um novo valor para onde difundir os pacotes de navegação</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Esta opção especifica um endereço de difusão a usar. Por omissão, a informação de navegação é difundida para todas as interfaces activas.</para>

<note>
<para
>O &HP-UX; 10.20 e anteriores não lidam convenientemente com a difusão a menos que tenhas uma máscara de rede Classe A, B, C ou D (isto é, não existe o suporte de <acronym
>CIDR</acronym
>).</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Porto de difusão</guilabel
></term>
<listitem>
<para
>O porto usado para as difusões por <acronym
>UDP</acronym
>. Por omissão este é o porto de <acronym
>IPP</acronym
>; se alterares isto, podes ter de o fazer em todos os servidores. Só é reconhecido um BrowsePort.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Endereços de pesquisa</guilabel
></term>
<listitem>
<para
>Pesquisar o(s) servidor(es) indicado(s) por impressoras.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>
<sect1 id="browsing-masks-configuration">
<title
>Configuração das Máscaras de Navegação</title>

<para
>A janela onde configurar os pacotes permitidos e/ou proibidos do servidor do &CUPS; de outros servidores aparece aqui. </para>

<itemizedlist>
<listitem
><para
><guilabel
>Permitir a navegação</guilabel
>: </para
></listitem>
<listitem
><para
><guilabel
>Proibir a navegação</guilabel
>: </para
></listitem>
<listitem
><para
><guilabel
>Ordem de navegação</guilabel
>: </para
></listitem>
</itemizedlist>

<screenshot>
<screeninfo
>A janela onde configurar os pacotes permitidos e/ou proibidos do servidor do &CUPS; de outros servidores</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration11_browsingmasks.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela onde configurar os pacotes permitidos e/ou proibidos do servidor do &CUPS; de outros servidores</phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
>A janela para <guilabel
>Adicionar Endereço de Navegação</guilabel
></term>
<listitem>
<para
>A janela onde se indica um novo valor para o endereço de outro servidor, de modo a aceitar dele pacotes de navegação, é mostrada aqui. É aberta ao carregar no botão <guibutton
>Adicionar...</guibutton
> ao lado do campo <guilabel
>Permitir a Navegação:</guilabel
>. É a mesma janela que aparece para adicionar os endereços <quote
>proibidos</quote
>.</para>

<para
>A janela para indicar um novo endereço de outro servidor de &CUPS;, de modo a aceitar os pacotes de navegação deste, é mostrada aqui.</para>

<screenshot>
<screeninfo
>A janela para indicar um novo endereço de outro servidor de &CUPS;, de modo a aceitar os pacotes de navegação deste</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfig_browsingmasks_add_button.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para indicar um novo endereço de outro servidor de &CUPS;, de modo a aceitar os pacotes de navegação deste</phrase
></textobject>
</mediaobject>
</screenshot>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Permitir a navegação</guilabel
> e <guilabel
>Proibir a navegação</guilabel
></term>
<listitem>
<para
>O <guilabel
>Permitir a navegação</guilabel
> especifica uma máscara de endereços para indicar as permissões para os pacotes de navegação recebidos. Por omissão, permitem-se pacotes de todos os endereços.</para>
<para
>O <guilabel
>Proibir a navegação</guilabel
> especifica uma máscara de endereços a proibir a recepção dos seus pacotes de navegação. Por omissão, não se proibe pacotes de nenhum endereço.</para>
<para
>Tanto o <guilabel
>Permitir a navegação</guilabel
> como o <guilabel
>Proibir a navegação</guilabel
> aceitam as seguintes notações de endereços:</para>

<informalexample>
<itemizedlist>
<listitem>
<para
><userinput
>Todos</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>Nenhum</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>*.dominio.com</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>.dominio.com</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>maquina.dominio.com</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.*</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.*</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.*</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.nnn</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.nnn/mmm</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm</userinput
></para>
</listitem>
</itemizedlist>
</informalexample>

<para
>As restrições por nome de máquina/domínio só funcionam se tiveres activado a pesquisa de nomes de máquinas!</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ordem de navegação</guilabel
></term>
<listitem>
<para
>Especifica a ordem das comparações de permissões/proibições.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="browsing-timeouts-configuration">
<title
>Configuração dos Tempos-Limite de Navegação</title>

<para
>A janela para configurar os tempos-limite de navegação do servidor do &CUPS; é mostrada aqui. Estas opções incluem:</para>
<itemizedlist>
<listitem
><para
><guilabel
>Intervalo de Navegação</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Tempo-Limite de Navegação</guilabel
></para
></listitem>
</itemizedlist>
<screenshot>
<screeninfo
>A janela para configurar os tempos-limite de navegação do servidor do &CUPS;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration12_browsingtimeouts.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela para configurar os tempos-limite de navegação do servidor do &CUPS;</phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Intervalo de navegação</guilabel
></term>
<listitem>
<para
>O tempo entre actualizações das navegações em segundos. O valor por omissão é 30 segundos.</para>
<para
>Repara que a informação de navegação é enviada sempre que o estado de uma impressora muda, por isso isto representa o tempo máximo entre actualizações.</para>
<para
>Configura isto como 0 para desactivares as difusões de modo a que as tuas impressoras não sejam anunciadas, embora possas ver à mesma as impressoras das outras máquinas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Tempos-limite de navegação</term>
<listitem>
<para
>O tempo-limite (em segundos) para as impressoras de rede - se não obtivermos uma actualização dentro deste tempo, a impressora será removida da lista.</para>
<para
>Este tempo não deve ser de modo algum inferior ao período de navegação por razões óbvias. O seu valor por omissão é 300 segundos.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>
<sect1 id="browsing-relay-configuration">
<title
>Configuração do Encaminhamento da Navegação</title>

<para
>A janela para configurar o servidor do &CUPS; como um reencaminhador de navegação é mostrada aqui. As opções de reencaminhamento de navegação incluem:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Reencaminhamento de pacotes do navegador</guilabel
></para
></listitem>
</itemizedlist>

<screenshot>
<screeninfo
>A janela para configurar o servidor do &CUPS; como um reencaminhador de navegação</screeninfo
> 
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration14_browsingrelay.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para configurar o servidor do &CUPS; como um reencaminhador de navegação</phrase
></textobject
> 
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
>Janela de Adicionar Reencaminhamento da Navegação</term>
<listitem>
<para
>A janela para indicar um novo par de endereços, de modo a definir um reencaminhamento de navegação entre um servidor do &CUPS; e uma rede é mostrada aqui.</para>

<screenshot>
<screeninfo
>A janela para indicar um novo par de endereços, de modo a definir um reencaminhamento de navegação entre um servidor do &CUPS;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfig_browse_relay_add_button.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para indicar um novo par de endereços, de modo a definir um reencaminhamento de navegação entre um servidor do &CUPS;</phrase
></textobject>
</mediaobject>
</screenshot>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Reencaminhamento de pacotes do navegador</guilabel
></term>
<listitem>
<para
>Reencaminhar os pacotes de navegação de um endereço ou rede para outro(a).</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="security-configuration">
<title
>Configuração da Segurança</title>

<para
>A janela para configurar as opções de segurança do servidor do &CUPS; para qualquer uma das localizações do servidor é mostrada aqui. Contém as seguintes opções, as quais podem ser definidas em separado para qualquer recurso válido (ou localização) do servidor do &CUPS;:</para>

<itemizedlist>
<listitem
><para
>Grupo do Sistema:</para
></listitem>
<listitem
><para
>Permissões de Acesso: </para
></listitem>
<listitem
><para
>Tipo de Autent.:</para
></listitem>
<listitem
><para
>Classe de Autent.:</para
></listitem>
<listitem
><para
>Nome do Grupo de Autent.:</para
></listitem>
<listitem
><para
>Cifra:</para
></listitem>
<listitem
><para
>Permitir:</para
></listitem>
<listitem
><para
>Proibir:</para
></listitem>
<listitem
><para
>Ordem:</para
></listitem>
</itemizedlist>

<para
>Os recursos (ou localizações) válidos do servidor do &CUPS; são:</para>

<itemizedlist>
<listitem
><para
>Localização da Raiz do Servidor: <systemitem class="resource"
>/</systemitem
> </para
></listitem
> 
<listitem
><para
>Localização da Administração do Servidor: <systemitem class="resource"
>/admin</systemitem
></para
></listitem>
<listitem
><para
>Todas as impressoras do servidor: <systemitem class="resource"
>/printers</systemitem
></para
></listitem>
<listitem
><para
>Qualquer impressora em particular do servidor: por exemplo <systemitem class="resource"
>/printers/infotec_P320</systemitem
></para
></listitem
> 
<listitem
><para
>Todas as classes de impressoras no servidor: <systemitem class="resource"
>/classes</systemitem
>:</para
></listitem
> 
<listitem
><para
>Uma classe em particular do servidor: por exemplo <systemitem class="resource"
>/classes/todas_as_infotecs_P320_ou_P450</systemitem
></para
></listitem
> 
</itemizedlist>

<screenshot>
<screeninfo
>A janela para configurares as opções de segurança do servidor do &CUPS; para qualquer das localizações do servidor</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration_securityoverview.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>a janela para configurares as opções de segurança do servidor do &CUPS; para qualquer das localizações do servidor</phrase
></textobject>

</mediaobject>
</screenshot>

<note>
<para
>Para todas as localizações que não estejam definidas em separado a opção da localização <quote
>acima</quote
> é válida.</para>

<para
>Por exemplo, o utilizador tem uma impressora chamada <systemitem class="resource"
>infotec_P450</systemitem
> sem opções de segurança definidas. Então a segurança da localização <systemitem class="resource"
>/printers</systemitem
> tomará a responsabilidade desta impressora dado que é uma sub-localização do <systemitem class="resource"
>/printers</systemitem
>. Se porventura não existir nenhuma configuração de segurança para o <systemitem class="resource"
>/printers</systemitem
>, então a segurança para o <systemitem class="resource"
>/</systemitem
> (a segurança geral) do servidor toma a responsabilidade. Ou você configura isto para o seu propósito ou o valor por omissão ao compilar é assumido.</para>
</note>

<variablelist>
<varlistentry>
<term
>SystemGroup</term>
<listitem>
<para
>O nome do grupo para o <systemitem class="groupname"
>Sistema</systemitem
> ou para o acesso de administração da impressora. Os valores por omissão dependem do sistema operativo, mas será <systemitem class="groupname"
>sys</systemitem
>, <systemitem class="groupname"
>system</systemitem
> ou <systemitem class="groupname"
>root</systemitem
> (verificando por esta ordem).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Permissões de Acesso</term>
<listitem>
<para
>As permissões de acesso para cada pasta servida pelo escalonador. As localizações são relativas à raiz do documento.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Tipo de Autorização</term>
<listitem>
<para
>A autorização a usar:</para>

<variablelist>
<varlistentry>
<term
>Nenhuma</term>
<listitem>
<para
>Sem efectuar autenticação.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Basic</term>
<listitem>
<para
>Efectua a autenticação usando o método BASIC do &HTTP;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>'Digest'</term>
<listitem>
<para
>Efectua a autenticação usando o método DIGEST do &HTTP;.</para>
</listitem>
</varlistentry>
</variablelist>

<note>
<para
>A autenticação local por certificados pode ser substituída pelo cliente para BASIC ou DIGEST, ao ligar-se à interface do 'localhost'.</para>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term
>Classe de Autorização</term>
<listitem>
<para
>A classe de autorização. De momento só são suportados o <quote
>Anónimo</quote
>, <quote
>Utilizador</quote
>, <quote
>Sistema</quote
> (um utilizador válido que pertence ao grupo do sistema) e <quote
>grupo</quote
> (um utilizador válido que pertence ao grupo indicado).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Nome do Grupo de Autorização</term>
<listitem>
<para
>O nome do grupo para a autorização de <quote
>Grupo</quote
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Cifra</term>
<listitem>
<para
>Se deve ser usada ou não cifra. Isto depende do facto de ter a biblioteca de <application
>OpenSSL</application
> compilada com a biblioteca e o escalonador do &CUPS;.</para>
<para
>Os valores possíveis são:</para>
<variablelist>
<varlistentry>
<term
>Sempre</term>
<listitem>
<para
>Usar sempre cifra (<acronym
>SSL</acronym
>)</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Nunca</term>
<listitem>
<para
>Nunca usar a cifra.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Necessária</term>
<listitem>
<para
>Usar a actualização da cifra <acronym
>TLS</acronym
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>IfRequested</term>
<listitem>
<para
>Usar a cifra se o servidor o pedir.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Allow</guilabel
></term>
<listitem>
<para
>Permite o acesso a partir da máquina, domínio, endereço <acronym
>IP</acronym
> ou rede indicados. Os valores possíveis são:</para>

<informalexample>
<itemizedlist>
<listitem>
<para
><userinput
>Todos</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>Nenhum</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>*.dominio.com</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>.dominio.com</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>maquina.dominio.com</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.*</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.*</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.*</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.nnn</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.nnn/mmm</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm</userinput
></para>
</listitem>
</itemizedlist>
</informalexample>

<para
>O endereço da máquina e do domínio necessitam que tu actives as pesquisas dos nomes de máquinas, tal como descrito acima.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Deny</guilabel
></term>
<listitem>
<para
>Proíbe o acesso a partir da máquina, domínio, endereço <acronym
>IP</acronym
> ou rede indicados. Os valores possíveis são:</para>
<informalexample>
<itemizedlist>
<listitem>
<para
><userinput
>Todos</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>Nenhum</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>*.dominio.com</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>.dominio.com</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>maquina.dominio.com</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.*</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.*</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.*</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.nnn</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.nnn/mmm</userinput
></para>
</listitem>
<listitem>
<para
><userinput
>nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm</userinput
></para>
</listitem>
</itemizedlist>
</informalexample>
<para
>O endereço da máquina e do domínio necessitam que tu actives as pesquisas dos nomes de máquinas, tal como descrito acima.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Order</term>
<listitem>
<para
>A ordem do processamento das permissões ou proibições.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="example-how-define-security-for-all-printers">
<title
>Exemplo: Como Definir a Segurança para Todas as Impressoras</title>

<para
>A janela para configurar as opções de segurança do servidor do &CUPS; é discutida aqui. Usamos o exemplo para adicionar as definições de segurança adicionais para o recurso <systemitem class="resource"
>todas as impressoras</systemitem
>. Para o servidor Web do &CUPS;, esta é a localização à qual acedes através de <ulink url="http://localhost:631/printers/"
> http://localhost:631/printers/</ulink
> ou (remotamente) através de <ulink url="http://cups.server.name:631/printers/"
> http://nome.servidor.cups:631/printers/</ulink
></para>

<para
>A primeira imagem mostra a localização geral para esta opção. <guilabel
>Selecciona</guilabel
> <guibutton
>Adicionar</guibutton
> ou <guibutton
>Modificar</guibutton
> de um recurso para o qual queiras decidir as suas opções de segurança.</para>

<screenshot>
<screeninfo
>A janela para configurar as opções de segurança do servidor do &CUPS;</screeninfo
><mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration15a_resourceallprinters_defineaccess.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para configurar as opções de segurança do servidor do &CUPS;</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Esta janela adiciona um novo recurso. É semelhante à que aparece quando queres modificar um recurso já existente. Aqui estão as opções gerais:</para>

<screenshot>
<screeninfo
>A janela para adicionar um novo recurso.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration15b_resourceallprinters_defineaccess.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para adicionar um novo recurso.</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Esta é a segunda parte da janela de adição de um novo recurso. Esta é semelhante se quiseres modificar um recurso já existente. Aqui defines as máscaras actuais de acesso ao recurso em questão. </para>

<screenshot>
<screeninfo
>A janela para adicionar um novo recurso.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration15c_resourceallprinters_defineaccess.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>A janela para adicionar um novo recurso.</phrase
></textobject>
</mediaobject>
</screenshot>
<screenshot>
<screeninfo
>Janela do recurso</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration_resourceadminaccessmasks.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela do recurso</phrase
></textobject>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Janela do recurso</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration_resourceadminaddprinters.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela do recurso</phrase
></textobject>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Janela do recurso</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration_resourceadminaddprinters_defineaccess.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela do recurso</phrase
></textobject>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Janela do recurso</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="cupsserverconfiguration_resourceadminauthorization.png"
format="PNG"/></imageobject>
<textobject>
<phrase
>Janela do recurso</phrase
></textobject>
</mediaobject>
</screenshot>

</sect1>

</chapter>
