.\" .\" cupsd-logs man page for CUPS. .\" .\" Copyright © 2021-2023 by OpenPrinting. .\" Copyright © 2007-2019 by Apple Inc. .\" Copyright © 1997-2006 by Easy Software Products. .\" .\" Licensed under Apache License v2.0. See the file "LICENSE" for more .\" information. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH cupsd\-logs 5 CUPS 2021\-02\-28 OpenPrinting .SH NOME cupsd\-logs \- ficheiros log do cupsd (access_log, error_log, e page_log) .SH DESCRIÇÃO O \fBcupsd\fP(8) normalmente mantém três ficheiros de registo: \fIaccess_log\fP para seguir pedidos que são submetidos ao agendador, \fIerror_log\fP para seguir o progresso e erros, e \fIpage_log\fP para seguir as páginas que são imprimidas. As directivas de configuração em \fBcupsd.conf\fP(5) e \fBcups\-files.conf\fP(5) controla o que informação é registada e onde é armazenada. .SS "FORMATO DE FICHEIRO DE RELATÓRIO ACCESS" O ficheiro \fIaccess_log\fP lista cada recurso HTTP que é acedido por um navegador web ou cliente. Cada linha é uma versão extensa do chamado "Formato de Log Comum" usado por muitos servidores web e ferramentas de reportar em web. .nf \fIhost group user date\-time \fP"\fImethod resource version\fP" \fIstatus bytes ipp\-operation ipp\-status\fP .fi Por exemplo: .nf 10.0.1.2 \- \- [01/Dec/2005:21:50:28 +0000] "POST / HTTP/1.1" 200 317 CUPS\-Get\-Printers successful\-ok\-ignored\-or\-substituted\-attributes localhost \- \- [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1" 200 0 \- \- localhost \- \- [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1" 200 157 CUPS\-Get\-Printers successful\-ok\-ignored\-or\-substituted\-attributes localhost \- \- [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1" 200 1411 CUPS\-Get\-Devices \- localhost \- \- [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1" 200 6667 \- \- .fi O campo \fIhost\fP irá normalmente ser apenas um endereço IP a menos que você tenha activado a directiva HostNameLookups no ficheiro \fIcupsd.conf\fP ou se o endereço IP corresponder à sua máquina local. .LP O campo \fIgroup\fP contém sempre "\-". .LP O campo \fIuser\fP é o nome de utilizador autenticado do utilizador que requisita. Se não for fornecido nenhum nome de utilizador e palavra passe para o pedido, então este campo contém "\-". .LP O campo \fIdate\-time\fP é a data e hora do pedido em hora local e está no formato "[DD/MES/AAAA:HH:MM:SS +ZZZZ]". .LP O campo \fImethod\fP é o método HTTP usado: "GET", "HEAD", "OPTIONS", "POST", ou "PUT". Os pedidos "GET" são usados para obter ficheiros do servidor, ambos para a interface web e para obter ficheiros de configuração e de registo. Os pedidos "HEAD" são usados para obter informação acerca dum recurso antes de um "GET". Os pedidos "OPTIONS" são usados para melhorar ligações para encriptação TLS. Os pedidos "POST" são usados para formulários da interface web e pedidos IPP. OS pedidos "PUT" são usados para enviar ficheiros de configuração. .LP O campo \fIresource\fP é o nome de ficheiro do recurso requisitado. .LP O campo \fIversion\fP é a versão de especificação HTTP usada pelo cliente. Para clientes do CUPS isto será sempre "HTTP/1.1". .LP O campo \fIstatus\fP contém o estado de resultado HTTP do pedido, como se segue: .RS 5 .TP 5 200 Operação com sucesso. .TP 5 201 Ficheiro criado/modificado com sucesso. .TP 5 304 O ficheiro requerido não alterou. .TP 5 400 Mau pedido HTTP; tipicamente isto significa que você tem um programa malicioso a tentar aceder ao seu servidor. .TP 5 401 Não autorizado, é requerido autenticação (nome de utilizador + palavra passe). .TP 5 403 Acesso é proibido; tipicamente isto significa que um cliente tentou aceder a um ficheiro ou recurso ao qual não tinha permissão para aceder. .TP 5 404 O ficheiro ou recurso não existe. .TP 5 405 Método de acesso a URL não suportado; tipicamente isto significa que você tem um navegador web a usar o seu servidor como um proxy. .TP 5 413 Pedido muito grande; tipicamente isto significa que um cliente tentou imprimir um ficheiro maior que o permitido por MaxRequestSize. .TP 5 426 Actualizando para ligação encriptada\-TLS .TP 5 500 Erro do servidor; tipicamente isto acontece quando o servidor é incapaz de abrir/criar um ficheiro \- consulte o ficheiro error_log para detalhes. .TP 5 501 O cliente requereu encriptação mas o suporte a encriptação não está activo/compilado. .TP 5 505 Número de versão HTTP não suportado; tipicamente isto significa que você tem um programa malicioso a tentar aceder ao seu servidor. .RE .LP O campo \fIbytes\fP contém o número de bytes no pedido. Para pedidos POST o campo bytes contém o número de bytes de dados não\-IPP que é recebido do cliente. .LP O campo \fIipp\-operation\fP contém ou "\-" para pedidos não\-IPP ou o nome da operação IPP para pedidos POST que contém um pedido IPP. .LP O campo \fIipp\-status\fP contém ou "\-" para pedidos não\-IPP ou o nome de código do estado IPP para pedidos POST que contém uma resposta IPP. .SS "FORMATO DE FICHEIRO DE RELATÓRIO DE ERROS" O ficheiro \fIerror_log\fP lista mensagens do agendador \- erros, avisos, etc. A directiva LogLevel no ficheiro \fBcupsd.conf\fP(5) controla quais mensagens são registadas. .nf level date\-time message .fi Por exemplo: .nf I [20/May/1999:19:18:28 +0000] [Job 1] Queued on 'DeskJet' by 'mike'. D [20/May/1999:19:18:28 +0000] [Job 1] argv[0]="DeskJet" D [20/May/1999:19:18:28 +0000] [Job 1] argv[1]="1" D [20/May/1999:19:18:28 +0000] [Job 1] argv[2]="mike" D [20/May/1999:19:18:28 +0000] [Job 1] argv[3]="myjob" D [20/May/1999:19:18:28 +0000] [Job 1] argv[4]="1" D [20/May/1999:19:18:28 +0000] [Job 1] argv[5]="media= na_letter_8.5x11in sides=one\-sided" D [20/May/1999:19:18:28 +0000] [Job 1] argv[6]="/var/spool/cups/ d000001\-001" I [20/May/1999:19:21:02 +0000] [Job 2] Queued on 'DeskJet' by 'mike'. I [20/May/1999:19:22:24 +0000] [Job 2] Canceled by 'mike'. .fi O campo \fIlevel\fP contém o tipo de mensagem: .TP 5 A Mensagem de alerta (LogLevel alert) .TP 5 C Mensagem de erro crítico (LogLevel crit) .TP 5 D Mensagem de depuração (LogLevel debug) .TP 5 d Mensagem de depuração detalhada (LogLevel debug2) .TP 5 E Mensagem de erro normal (LogLevel error) .TP 5 I Mensagem de informação (LogLevel info) .TP 5 N Mensagem de notificação (LogLevel notice) .TP 5 W Mensagem de aviso (LogLevel warn) .TP 5 X Mensagem de erro de emergência (LogLevel emerg) .LP O campo \fIdate\-time\fP contém a data e hora de quando a página começou a ser imprimida. O formato deste campo é idêntico ao do campo data\-hora no ficheiro \fIaccess_log\fP. .LP O campo \fImessage\fP contém uma mensagem textual de formato livre. As mensagens de filtros de trabalhos são prefixadas com "[Job NNN]" onde "NNN" é o ID do trabalho. .SS "FORMATO DE FICHEIRO DE RELATÓRIO DE PÁGINA" O ficheiro \fIpage_log\fP lista o número total de páginas (folhas) que são imprimidas. Por predefinição, cada linha contém a seguinte informação: .nf \fIprinter user job\-id date\-time \fP\fBtotal \fP\fInum\-sheets job\-billing job\-originating\-host\-name job\-name media sides\fP .fi Por exemplo a entrada para um trabalho de duas páginas chamado "myjob" poderá se parecer com isto: .nf DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme\-123 localhost myjob na_letter_8.5x11in one\-sided .fi A directiva PageLogFormat no ficheiro \fBcupsd.conf\fP(5) pode ser usada para modificar esta informação. .LP O campo \fIprinter\fP contém o nome da impressora que imprimiu a página. Se você enviar um trabalho para uma classe de impressoras, este campo irá conter o nome da impressora a que foi atribuído o trabalho. .LP O campo \fIuser\fP contém o nome do utilizador (o atributo nome\-utilizador do pedido IPP) que submeteu este ficheiro para impressão. .LP O campo \fIjob\-id\fP contém o número de trabalho da página a ser imprimida. .LP O campo \fIdate\-time\fP contém a data e hora de quando a página começou a ser imprimida. O formato deste campo é idêntico ao do campo data\-hora no ficheiro \fIaccess_log\fP. .LP O campo \fInum\-sheets\fP fornece o número total de páginas (folhas) que foram impressas para o trabalho. .LP O campo \fIjob\-billing\fP contém uma cópia dos atributos job\-billing ou job\-account\-id fornecidos com os pedidos IPP Create\-Job ou Print\-Job ou "\-" se nenhum foi fornecido. .LP O campo \fIjob\-originating\-host\-name\fP contém o nome de máquina ou o endereço IP do cliente que imprimiu o trabalho. .LP O campo \fIjob\-name\fP contém uma cópia do atributo job\-name fornecido com os pedidos IPP Create\-Job ou Print\-Job ou "\-" se nenhum foi fornecido. .LP O campo \fImedia\fP contém uma cópia dos atributos media ou media\-col/media\-size fornecido com os pedidos IPP Create\-Job ou Print\-Job ou "\-" se nenhum foi fornecido. .LP O campo \fIsides\fP contém uma cópia do atributo sides fornecido com os pedidos IPP Create\-Job ou Print\-Job ou "\-" se nenhum foi fornecido. .SH "VEJA TAMBÉM" \fBcupsd\fP(8), \fBcupsd.conf\fP(5), \fBcups\-files.conf\fP(5), Ajuda Online do CUPS (http://localhost:631/help) .SH COPYRIGHT Copyright \[co] 2021\-2023 by OpenPrinting.