.\"
.\" cupsd.conf man page for CUPS.
.\"
.\" Copyright © 2020-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.conf 5 CUPS 2021\-10\-01 OpenPrinting
.SH NOME
cupsd.conf \- ficheiro de configuração de servidor para cups
.SH DESCRIÇÃO
O ficheiro \fIcupsd.conf\fP configura o agendador do CUPS, \fBcupsd\fP(8). Está
normalmente localizado no directory \fI/etc/cups\fP. Cada linha no ficheiro
pode ser uma directiva configurável, uma linha em branco, ou um
comentário. As directivas de configuração consistem tipicamente de um nome e
zero ou mais valores separados por espaços em branco. O nome e valores da
directiva de configuração são sensíveis a maiúsculas/minúsculas. As linhas
de comentários começam com o caractere #.
.SS "DIRECTIVAS DE NÍVEL DE TOPO"
.\"#AccessLogLevel
As seguintes directivas de nível\-de\-topo são compreendidas pelo \fBcupsd\fP(8):
.TP 5
\fBAccessLogLevel config\fP
.TP 5
\fBAccessLogLevel actions\fP
.TP 5
\fBAccessLogLevel all\fP
.\"#AutoPurgeJobs
Especifica o nível de relatório para o ficheiro AccessLog. O nível "config"
regista quando impressoras e classes são adicionadas, apagadas, ou
modificadas e quando os ficheiros de configuração são acedidos ou
actualizados. O nível "actions" regista quando trabalhos de impressão são
submetidos, segurados, lançados, modificados ou cancelados, e qualquer das
condições para "config". O nível "all" regista todos os pedidos. O nível de
relatório predefinido é "actions".
.TP 5
\fBAutoPurgeJobs Yes\fP
.TP 5
\fBAutoPurgeJobs No\fP
.br
.\"#BrowseDNSSDSubTypes
Especifica se se deve purgar os dados de histórico de trabalhos
automaticamente quando já não é requerido para cotas. A predefinição é "No".
.TP 5
\fBBrowseDNSSDSubTypes\fP\fI_subtype[,...]\fP
.\"#BrowseLocalProtocols
Especifica uma lista de sub\-tipos Bonjour para publicitar cada impressora
partilhada. Por exemplo, "BrowseDNSSDSubTypes _cups,_print" irá dizer aos
clientes da rede que ambos partilha CUPS e IPP Everywhere são suportados. A
predefinição é "_cups" o que é necessário para que a partilha de impressoras
funcionem entre sistemas que usam CUPS.
.TP 5
\fBBrowseLocalProtocols all\fP
.TP 5
\fBBrowseLocalProtocols dnssd\fP
.TP 5
\fBBrowseLocalProtocols none\fP
.\"#BrowseWebIF
Especifica quais protocolos a usar para partilha de impressora local. A
predefinição é "dnssd" em sistemas que suportem Bonjour e "none" em caso
contrário.
.TP 5
\fBBrowseWebIF Yes\fP
.TP 5
\fBBrowseWebIF No\fP
.br
.\"#Browsing
Especifica se a interface web do CUPS é publicitada. A predefinição é "No".
.TP 5
\fBBrowsing Yes\fP
.TP 5
\fBBrowsing No\fP
.br
.\"#DefaultAuthType
Especifica se as impressoras partilhadas são publicitadas. A predefinição é
"No".
.TP 5
\fBDefaultAuthType Basic\fP
.br
.\"#DefaultEncryption
Especifica o tipo predefinido de autenticação a usar. a predefinição é
"Basic".
.TP 5
\fBDefaultEncryption Never\fP
.TP 5
\fBDefaultEncryption IfRequested\fP
.TP 5
\fBDefaultEncryption Required\fP
.\"#DefaultLanguage
Especifica se deve ser usada encriptação para pedidos de autenticação. A
predefinição é "Required".
.TP 5
\fBDefaultLanguage \fP\fIlocale\fP
.\"#DefaultPaperSize
Especifica a linguagem predefinida a usar para texto e conteúdo web. A
predefinição é "en".
.TP 5
\fBDefaultPaperSize Auto\fP
.TP 5
\fBDefaultPaperSize None\fP
.TP 5
\fBDefaultPaperSize \fP\fIsizename\fP
.\"#DefaultPolicy
Especifica o tamanho de papel predefinido para novas filas de
impressão. "Auto" usa uma predefinição específica da localização, enquanto
"None" especifica que não há tamanho de papel predefinido. Nomes de tamanhos
específicos são tipicamente "Letter" ou "A4". A predefinição é "Auto". Nota:
O tamanho de papel predefinido tem de usar um nome de tamanho a partir do
ficheiro PPD e não um nome de tamanho de média auto\-descritível PWG.
.TP 5
\fBDefaultPolicy \fP\fIpolicy\-name\fP
.\"#DefaultShared
Especifica a política de acesso predefinida a usar. A política de acesso
predefinida é "default".
.TP 5
\fBDefaultShared Yes\fP
.TP 5
\fBDefaultShared No\fP
.\"#DirtyCleanInterval
Especifica se as impressoras locais são partilhadas por predefinição. A
predefinição é "Yes".
.TP 5
\fBDirtyCleanInterval \fP\fIseconds\fP
.\"#DNSSDHostName
Especifica o atraso para a actualização de ficheiros de estado e
configuração. Um valor 0 irá fazer com que a actualização ocorra o quando
antes possível, tipicamente dentro de alguns milissegundos. O valor
predefinido é "30".
.TP 5
\fBDNSSDHostName\fP\fIhostname.example.com\fP
.\"#ErrorPolicy
Especifica o nome de domínio totalmente qualificado para o servidor que é
usado para partilhas Bonjour. A predefinição é tipicamente o nome de maquina
".local" do servidor.
.TP 5
\fBErrorPolicy abort\-job\fP
Especifica que um trabalho de impressão falhado deve ser abortado
(descartado) a menos que caso contrário especificado para a impressora.
.TP 5
\fBErrorPolicy retry\-current\-job\fP
Especifica que um trabalho de impressão falhado deve ser re\-tentado
imediatamente a menos que caso contrário especificado para a impressora.
.TP 5
\fBErrorPolicy retry\-job\fP
Especifica que um trabalho de impressão falhado deve ser re\-tentado mais
tarde a menos que caso contrário especificado para a impressora.
.TP 5
\fBErrorPolicy stop\-printer\fP
.\"#FilterLimit
Especifica que um trabalho de impressão falhado deve parar a impressora a
menos que caso contrário especificado para a impressora. A política de erro
\&'stop\-printer' é a predefinida.
.TP 5
\fBFilterLimit \fP\fIlimit\fP
.\"#FilterNice
Especifica o custo máximo de filtros que são corridos em simultâneo, que
podem ser usados para minimizar problemas de recursos de disco, memória, e
CPU. Um limite de 0 desactiva o limite de filtros. Uma impressão média para
uma impressora não\-PostScript precisa dum limite de filtro de cerca de
200. Uma impressora PostScript precisa de cerca de metade (100). Definir o
limite abaixo destes limiares irá efectivamente limitar o agendamento a
imprimir um único trabalho de cada vez. O limite predefinido é "0".
.TP 5
\fBFilterNice \fP\fInice\-value\fP
Especifica a prioridade do agendamento (valor \fBnice\fP(8)) dos filtros que
são corridos para imprimir um trabalho. O valor nice vai de 0, a prioridade
mais alta, até 19, a prioridade mais baixa. A predefinição é 0.
.TP 5
.\"#HostNameLookups
\fBHostNameLookups On\fP
.TP 5
\fBHostNameLookups Off\fP
.TP 5
\fBHostNameLookups Double\fP
.\"#IdleExitTimeout
Especifica se se deve fazer pesquisas reversas em clientes a ligar. A
definição "Double" faz com que o \fBcupsd\fP(8) verifique se o nome\-de\-máquina
resolvido a partir do endereço corresponde a um dos dos endereços retornados
para esse nome\-de\-máquina. As pesquisas duplas também previnem clientes com
endereços não registados de se ligarem ao servidor. A predefinição é "Off"
para evitar problemas potenciais de performance do servidor com pesquisas ao
nome\-de\-máquina. Apenas defina esta opção para "On" ou "Double" se
absolutamente necessário.
.TP 5
\fBIdleExitTimeout \fP\fIseconds\fP
.\"#JobKillDelay
Especifica a quantidade de tempo a esperar antes de desligar devido a
inactividade. A predefinição é "60" segundos. Nota: Apenas aplicável quando
\fBcupsd\fP(8) corre sob demanda (ex. com \fB\-l\fP).
.TP 5
\fBJobKillDelay \fP\fIseconds\fP
.\"#JobRetryInterval
Especifica o número de segundos a esperar antes de matar os filtros e
backend associados com um cancelamento ou retenção de trabalho. A
predefinição é "30".
.TP 5
\fBJobRetryInterval \fP\fIseconds\fP
.\"#JobRetryLimit
Especifica o intervalo entre re\-tentativas de trabalhos em segundos. Isto é
usado tipicamente para filas de fax mas também pode ser usado em filas de
impressão normais cuja política de erro é "retry\-job" ou
"retry\-current\-job". A predefinição é "30".
.TP 5
\fBJobRetryLimit \fP\fIcount\fP
.\"#KeepAlive
Especifica o número de re\-tentativas feitas para cada trabalho. Isto é usado
tipicamente para filas de fax mas também pode ser usado com filas de
impressão normais cuja política de erro é "retry\-job" ou
"retry\-current\-job". A predefinição é "5".
.TP 5
\fBKeepAlive Yes\fP
.TP 5
\fBKeepAlive No\fP
.\"#LimitIPP
Especifica se se deve suportar ligações HTTP keep\-alive. A predefinição é
"Yes".
.TP 5
\fB \fP... \fB\fP
.\"#Limit
Especifica as operações IPP que estão a ser limitadas dentro de uma secção
Policy. Os nomes de operação IPP estão listados em baixo na secção "NOMES DE
OPERAÇÃO IPP".
.TP 5
\fB \fP... \fB\fP
.\"#LimitExcept
.TP 5
\fB \fP... \fB\fP
.\"#LimitRequestBody
Especifica os métodos HTTP que estão a ser limitadas dentro de uma secção
Location. Os nomes de métodos HTTP estão listados em baixo na secção "NOMES
DE MÉTODOS HTTP".
.TP 5
\fBLimitRequestBody \fP\fIsize\fP
.\"#Listen
Especifica o tamanho máximo de ficheiros de impressão, pedidos IPP, e dados
em formato HTML. A predefinição é "0" o que desactiva a verificação do
limite.
.TP 5
\fBListen \fP\fIipv4\-address\fP\fB:\fP\fIport\fP
.TP 5
\fBListen [\fP\fIipv6\-address\fP\fB]:\fP\fIport\fP
.TP 5
\fBListen *:\fP\fIport\fP
.TP 5
\fBListen \fP\fI/path/to/domain/socket\fP
.\"#Location
Escuta no endereço e porto especificado ou caminho de socket de domínio por
ligações. Várias directivas Listen podem ser fornecidas para escutar em
múltiplos endereços. A directiva Listen é semelhante à directiva Port mas
permite\-lhe restringir acesso a interfaces ou redes específicas. Nota:
"Listen *:\fIport\fP" e "Port \fIport\fP" efectivamente escutam em todos os
endereços IP, assim você não pode combina\-los com directivas Listen para
endereços IPv4 ou IPv6 específicos no mesmo porto.
.TP 5
\fB \fP... \fB\fP
.\"#LogDebugHistory
Especifica controlo de acesso para a localização nomeada. Os caminhos estão
documentados em baixo na secção "CAMINHOS DE LOCALIZAÇÃO".
.TP 5
\fBLogDebugHistory \fP\fInumber\fP
.\"#LogLevel
Especifica o número de mensagens de depuração que são retidas para registo
se acorrer um erro num trabalho de impressão. As mensagens de depuração são
registadas independentemente da definição de LogLevel.
.TP 5
\fBLogLevel \fPnone
.TP 5
\fBLogLevel \fPemerg
.TP 5
\fBLogLevel \fPalert
.TP 5
\fBLogLevel \fPcrit
.TP 5
\fBLogLevel \fPerror
.TP 5
\fBLogLevel \fPwarn
.TP 5
\fBLogLevel \fPnotice
.TP 5
\fBLogLevel \fPinfo
.TP 5
\fBLogLevel \fPdebug
.TP 5
\fBLogLevel \fPdebug2
.\"#LogTimeFormat
Especifica o nível de registo para o ficheiro ErrorLog. O valor "none" pára
todos os registos enquanto "debug2" regista tudo. A predefinição é "warn".
.TP 5
\fBLogTimeFormat \fPstandard
.TP 5
\fBLogTimeFormat \fPusecs
.\"#MaxClients
Especifica o formato de data e hora nos ficheiros de registo. O valor
"standard" é o predefinido e regista segundos inteiros enquanto "usecs"
regista micro\-segundos.
.TP 5
\fBMaxClients \fP\fInumber\fP
.\"#MaxClientPerHost
Especifica o número máximo de clientes simultâneos que são permitidos pelo
agendamento. A predefinição é "100".
.TP 5
\fBMaxClientsPerHost \fP\fInumber\fP
.\"#MaxCopies
Especifica o número máximo de clientes simultâneos que são permitidos a
partir de um único endereço. A predefinição é o valor MaxClients.
.TP 5
\fBMaxCopies \fP\fInumber\fP
.\"#MaxHoldTime
Especifica o número máximo de cópias que um utilizador pode imprimir de cada
trabalho. A predefinição é "9999".
.TP 5
\fBMaxHoldTime \fP\fIseconds\fP
.\"#MaxJobs
Especifica o tempo máximo em que um trabalho pode permanecer no estado de
espera "indefinida" antes de ser cancelado. A predefinição é "0" o que
desactiva o cancelar de trabalhos retidos.
.TP 5
\fBMaxJobs \fP\fInumber\fP
.\"#MaxJobsPerPrinter
Especifica o número máximo de trabalhos simultâneos permitidos. Defina para
"0" para permitir um número de trabalhos ilimitado. A predefinição é "500".
.TP 5
\fBMaxJobsPerPrinter \fP\fInumber\fP
.\"#MaxJobsPerUser
Especifica o número máximo de trabalhos simultâneos permitidos por
impressora. A predefinição é "0" o que permite trabalhos até MaxJobs por
impressora.
.TP 5
\fBMaxJobsPerUser \fP\fInumber\fP
.\"#MaxJobTime
Especifica o número máximo de trabalhos simultâneos permitidos por
utilizador A predefinição é "0" o que permite trabalhos até MaxJobs por
utilizador.
.TP 5
\fBMaxJobTime \fP\fIseconds\fP
.\"#MaxLogSize
Especifica o tempo máximo que um trabalho pode levar a imprimir antes de ser
cancelado. Defina para "0" para desactivar o cancelamento de trabalhos
"presos". A predefinição é "10800" (3 horas).
.TP 5
\fBMaxLogSize \fP\fIsize\fP
.\"#MaxSubscriptions
Especifica o tamanho máximo dos ficheiros (log) de registo antes de serem
rodados. O valor "0" desactiva a rotação de registos. A predefinição é
"1048576" (1MB).
.TP 5
\fBMaxSubscriptions \fP\fInumber\fP
.\"#MaxSubscriptionsPerJob
Especifica o número máximo de subscrições de eventos simultâneos
permitidos. Defina para "0" para permitir um número de subscrições
ilimitado. A predefinição é "100".
.TP 5
\fBMaxSubscriptionsPerJob \fP\fInumber\fP
.\"#MaxSubscriptionsPerPrinter
Especifica o número máximo de subscrições de eventos simultâneos permitidos
por trabalho. A predefinição é "0" o que permite trabalhos até
MaxSubscriptions de subscrições por trabalho.
.TP 5
\fBMaxSubscriptionsPerPrinter \fP\fInumber\fP
.\"#MaxSubscriptionsPerUser
Especifica o número máximo de subscrições de eventos simultâneos permitidos
por impressora. A predefinição é "0" o que permite trabalhos até
MaxSubscriptions de subscrições por impressora.
.TP 5
\fBMaxSubscriptionsPerUser \fP\fInumber\fP
.\"#MultipleOperationTimeout
Especifica o número máximo de subscrições de eventos simultâneos permitidos
por utilizador. A predefinição é "0" o que permite trabalhos até
MaxSubscriptions de subscrições por utilizador.
.TP 5
\fBMultipleOperationTimeout \fP\fIseconds\fP
.\"#Policy
Especifica a quantidade máxima de tempo a permitir entre ficheiros num
trabalho de impressão de múltiplos ficheiros. A predefinição é "900" (15
minutos).
.TP 5
\fB \fP... \fB\fP
.\"#Port
Especifica controlo de acesso para a política nomeada.
.TP 5
\fBPort \fP\fInumber\fP
.\"#PreserveJobFiles
Escuta no número de porto especificado por ligações.
.TP 5
\fBPreserveJobFiles Yes\fP
.TP 5
\fBPreserveJobFiles No\fP
.TP 5
\fBPreserveJobFiles \fP\fIseconds\fP
.\"#PreserveJobHistory
Especifica se os ficheiros de trabalho (documentos) são preservados após um
trabalho ser imprimido. Se for especificado um valor numérico, os ficheiros
de trabalho são preservados durante o número indicado de segundos após a
impressão. A predefinição é "86400" (preserva 1 day).
.TP 5
\fBPreserveJobHistory Yes\fP
.TP 5
\fBPreserveJobHistory No\fP
.TP 5
\fBPreserveJobHistory \fP\fIseconds\fP
.\"#ReadyPaperSizes
Especifica se o histórico do trabalho é preservado após um trabalho ser
imprimido. Se for especificado um valor numérico, o histórico do trabalho é
preservado pelo número indicado de segundos após impressão. Se "Yes", o
histórico do trabalho é preservado até que o limite MaxJobs seja
alcançado. A predefinição é "Yes".
.TP 5
\fBReadyPaperSizes \fP\fIsizename[,...]\fP
.\"#ReloadTimeout
Especifica uma lista de potenciais tamanhos de papel que são reportados como
"ready" (carregado). A lista real apenas contém os tamanhos que cada
impressora suporta. A predefinição é "Letter,Legal,Tabloid,4x6,Env10" quando
o tamanho de papel predefinido é "Letter" e "A3,A4,A5,A6,EnvDL" em caso
contrário. Nota: Os tamanhos de papel têm de usar nomes a partir do ficheiro
PPD e não nomes de tamanho de média auto\-descritível PWG.
.TP 5
\fBReloadTimeout \fP\fIseconds\fP
.\"#ServerAdmin
Especifica a quantidade de tempo a esperar pela conclusão do trabalho antes
de reiniciar o agendamento. A predefinição é "30".
.TP 5
\fBServerAdmin \fP\fIemail\-address\fP
.\"#ServerAlias
Especifica o endereço de email do administrador do servidor. O valor
predefinido é "root@ServerName".
.TP 5
\fBServerAlias \fP\fIhostname \fP[ ... \fIhostname \fP]
.TP 5
\fBServerAlias *\fP
.\"#ServerName
A directiva ServerAlias é usada para validação do cabeçalho HTTP Host quando
os clientes se ligam ao agendador a partir de interfaces externas. Usar o
nome especial "*" pode expor o seu sistema a ataques conhecidos de
re\-ligação DNS baseados no browser, mesmo quando acedendo a sites através
duma firewall. Se a auto\-descoberta ou os nomes alternativos não
funcionarem, nós recomendamos listar cada nome alternativo com a directiva
ServerAlias em vez de usar "*".
.TP 5
\fBServerName \fP\fIhostname\fP
.\"#ServerTokens
Especifica o nome\-de\-máquina totalmente\-qualificado do servidor. A
predefinição é o valor reportado pelo comando \fBhostname\fP(1).
.TP 5
\fBServerTokens None\fP
.TP 5
\fBServerTokens ProductOnly\fP
.TP 5
\fBServerTokens Major\fP
.TP 5
\fBServerTokens Minor\fP
.TP 5
\fBServerTokens Minimal\fP
.TP 5
\fBServerTokens OS\fP
.TP 5
\fBServerTokens Full\fP
.\"#SSLListen
Especifica que informação está incluída no cabeçalho Server das respostas
HTTP "None" desactiva o cabeçalho Server. "ProductOnly" reporta "CUPS".
"Major" reporta "CUPS/major IPP/2". "Minor" reporta "CUPS/major.minor
IPP/2.1". "Minimal" reporta "CUPS/major.minor.patch IPP/2.1". "OS" reporta
"CUPS/major.minor.path (osname osversion) IPP/2.1". "Full" reporta
"CUPS/major.minor.path (osname osversion; architecture) IPP/2.1". A
predefinição é "Minimal".
.TP 5
\fBSSLListen \fP\fIipv4\-address\fP\fB:\fP\fIport\fP
.TP 5
\fBSSLListen [\fP\fIipv6\-address\fP\fB]:\fP\fIport\fP
.TP 5
\fBSSLListen *:\fP\fIport\fP
.\"#SSLOptions
Escuta no endereço e porto especificados por ligações encriptadas.
.TP 5
.TP 5
\fBSSLOptions \fP[\fIAllowDH\fP] [\fIAllowRC4\fP] [\fIAllowSSL3\fP] [\fIDenyCBC\fP] [\fIDenyTLS1.0\fP] [\fIMaxTLS1.0\fP] [\fIMaxTLS1.1\fP] [\fIMaxTLS1.2\fP] [\fIMaxTLS1.3\fP] [\fIMinTLS1.0\fP] [\fIMinTLS1.1\fP] [\fIMinTLS1.2\fP] [\fIMinTLS1.3\fP]
.TP 5
\fBSSLOptions None\fP
.\"#SSLPort
Define opções de encriptação (apenas em /etc/cups/client.conf). Por
predefinição, o CUPS apenas suporta encriptação usando TLS v1.0 ou superior
usando suites de cifra conhecidas seguras. A segurança é reduzida são usadas
opções \fIAllow\fP. A segurança é melhorada quando são usadas opções \fIDeny\fP. A
opção \fIAllowDH\fP activa suites de cifra que usam negociação de chaves
Diffie\-Hellman simples (não suportado em sistemas que usem TLS GNU). A
opção \fIAllowRC4\fP activa as suites de cifra RC4 de 128\-bit, as quais são
requeridas para alguns clientes antigos. A opção \fIAllowSSL3\fP activa SSL
v3.0, o que é requerido por alguns clientes antigos que não suportam TLS
v1.0. A opção \fIDenyCBC\fP desactiva toda as suites de cifra CBC. A opção
\fIDenyTLS1.0\fP desactiva suporte a TLS v1.0 \- isto define a versão mínima de
protocolo para TLS v1.1. As opções \fIMinTLS\fP definem a versão TLS mínima a
suportar. As opções \fIMaxTLS\fP definem a versão TLS máxima a suportar. Nem
todos os sistemas operativos suportam TLS 1.3 nesta altura.
.TP 5
\fBSSLPort \fP\fIport\fP
.\"#StrictConformance
Escuta no porto especificado por ligações encriptadas.
.TP 5
\fBStrictConformance Yes\fP
.TP 5
\fBStrictConformance No\fP
.\"#Timeout
Especifica se o agendamento requer que os clientes adiram estritamente às
especificações do IPP. A predefinição é er requires clients to strictly
adhere to the IPP specifications. The default is "No".
.TP 5
\fBTimeout \fP\fIseconds\fP
.\"#WebInterface
Especifica o tempo limite de pedido HTTP. A predefinição é "900" (15
minutos).
.TP 5
\fBWebInterface yes\fP
.TP 5
\fBWebInterface no\fP
Especifica se a interface web é activada. A predefinição é "No".
.SS "NOMES DE MÉTODOS HTTP"
Os seguintes métodos HTTP são suportados pelo \fBcupsd\fP(8):
.TP 5
GET
Usado por um cliente para descarregar ícones e outros recursos de impressão
e para aceder à interface web do CUPS.
.TP 5
HEAD
Usado por um cliente para obter o tipo, tamanho e data de modificação dos
recursos.
.TP 5
OPÇÕES
Usado por um cliente para estabelecer uma ligação segura (SSL/TLS).
.TP 5
POST
Usado por um cliente para submeter pedidos IPP e formulários HTTP a partir
da interface web do CUPS.
.TP 5
PUT
Usado por um cliente para enviar ficheiros de configuração.
.SS "NOMES DE OPERAÇÃO IPP"
As seguintes operações IPP são suportadas pelo \fBcupsd\fP(8):
.TP 5
CUPS\-Accept\-Jobs
Permite a uma impressora aceitar novos trabalhos.
.TP 5
CUPS\-Add\-Modify\-Class
Adiciona ou modifica uma classe de impressora.
.TP 5
CUPS\-Add\-Modify\-Printer
Adiciona ou modifica uma impressora.
.TP 5
CUPS\-Authenticate\-Job
Liberta um trabalho que está retido para autenticação.
.TP 5
CUPS\-Delete\-Class
Apaga uma classe de impressora.
.TP 5
CUPS\-Delete\-Printer
Apaga uma impressora.
.TP 5
CUPS\-Get\-Classes
Obtém uma lista de classes de impressoras.
.TP 5
CUPS\-Get\-Default
Obtém a impressora ou classe de impressora predefinida do servidor.
.TP 5
CUPS\-Get\-Devices
Obtém uma listas dos dispositivos que estão actualmente disponíveis.
.TP 5
CUPS\-Get\-Document
Obtém um ficheiro de documento para um trabalho.
.TP 5
CUPS\-Get\-PPD
Obtém um ficheiro PPD.
.TP 5
CUPS\-Get\-PPDs
Obtém uma lista de ficheiros PPD instalados.
.TP 5
CUPS\-Get\-Printers
Obtém uma lista de impressoras.
.TP 5
CUPS\-Move\-Job
Move um trabalho.
.TP 5
CUPS\-Reject\-Jobs
Previne uma impressora de aceitar novos trabalhos.
.TP 5
CUPS\-Set\-Default
Define a impressora ou classe de impressoras predefinida do servidor.
.TP 5
Cancel\-Job
Cancela um trabalho.
.TP 5
Cancel\-Jobs
Cancela um ou mais trabalhos.
.TP 5
Cancel\-My\-Jobs
Cancela um ou mais trabalhos criados por um utilizador.
.TP 5
Cancel\-Subscription
Cancela uma subscrição.
.TP 5
Close\-Job
Fecha um trabalho que está à espera de mais documentos.
.TP 5
Create\-Job
Cria um novo trabalho sem documentos.
.TP 5
Create\-Job\-Subscriptions
Cria uma subscrição para eventos de trabalho.
.TP 5
Create\-Printer\-Subscriptions
Cria uma subscrição para eventos de impressora.
.TP 5
Get\-Job\-Attributes
Obtém informação acerca de um trabalho.
.TP 5
Get\-Jobs
Obtém uma lista de trabalhos.
.TP 5
Get\-Notifications
Obtém uma lista de notificações de eventos para uma subscrição.
.TP 5
Get\-Printer\-Attributes
Obtém informação sobre uma impressora ou classe de impressora.
.TP 5
Get\-Subscription\-Attributes
Obtém informação acerca de uma subscrição.
.TP 5
Get\-Subscriptions
Obtém uma lista de subscrições.
.TP 5
Hold\-Job
Retém um trabalho para impressão.
.TP 5
Hold\-New\-Jobs
Retém todos os novos trabalhos para impressão.
.TP 5
Pause\-Printer
Pára o processamento de trabalhos por uma impressora ou classe de
impressora.
.TP 5
Pause\-Printer\-After\-Current\-Job
Pára o processamento de trabalhos por uma impressora ou classe de impressora
após o trabalho actual ser concluído.
.TP 5
Print\-Job
Cria um novo trabalho com um único documento.
.TP 5
Purge\-Jobs
Cancela um ou mais trabalhos e apaga o histórico de trabalho.
.TP 5
Release\-Held\-New\-Jobs
Permite que trabalhos retidos anteriormente sejam imprimidos.
.TP 5
Release\-Job
Permite um trabalho para imprimir.
.TP 5
Renew\-Subscription
Renova uma subscrição.
.TP 5
Restart\-Job
Re\-imprime um trabalho, se possível.
.TP 5
Send\-Document
Adiciona um documento a um trabalho.
.TP 5
Set\-Job\-Attributes
Modifica informação de trabalho.
.TP 5
Set\-Printer\-Attributes
Modifica informação de impressora ou classe de impressora.
.TP 5
Validate\-Job
Valida opções para um novo trabalho.
.SS "CAMINHOS DE LOCALIZAÇÕES"
Os seguintes caminhos são usados normalmente quando se configura o
\fBcupsd\fP(8):
.TP 5
/
O caminho para todas as operações de obter (obter impressoras, obter
trabalhos, etc.)
.TP 5
/admin
O caminho para todas as operações de administração (adicionar impressora,
apagar impressora, iniciar impressora, etc.)
.TP 5
/admin/conf
O caminho para acesso aos ficheiros de configuração do CUPS (cupsd.conf,
client.conf, etc.)
.TP 5
/admin/log
O caminho para acesso aos ficheiros de registo do CUPS (access_log,
error_log, page_log)
.TP 5
/classes
O caminho para todas as classes de impressora.
.TP 5
/classes/name
O recurso para a classe de impressora nomeada.
.TP 5
/jobs
O caminho para todos os trabalhos (hold\-job, release\-job, etc.)
.TP 5
/jobs/id
O caminho para o trabalho especificado.
.TP 5
/printers
O caminho para todas as impressoras.
.TP 5
/printers/name
O caminho para a impressora nomeada.
.TP 5
/printers/name.png
O caminho do ficheiro de ícone para a impressora nomeada.
.TP 5
/printers/name.ppd
O caminho do ficheiro PPD para a impressora nomeada.
.SS "DIRECTIVAS VÁLIDAS DENTRO DE SECÇÕES DE LOCALIZAÇÃO E LIMITE"
As seguintes directivas podem ser colocadas dentro das secções Location e
Limit no ficheiro \fBcupsd.conf\fP:
.TP 5
\fBAllow all\fP
.TP 5
\fBAllow none\fP
.TP 5
\fBAllow \fP\fIhost.domain.com\fP
.TP 5
\fBAllow *.\fP\fIdomain.com\fP
.TP 5
\fBAllow \fP\fIipv4\-address\fP
.TP 5
\fBAllow \fP\fIipv4\-address\fP\fB/\fP\fInetmask\fP
.TP 5
\fBAllow \fP\fIipv4\-address\fP\fB/\fP\fImm\fP
.TP 5
\fBAllow [\fP\fIipv6\-address\fP\fB]\fP
.TP 5
\fBAllow [\fP\fIipv6\-address\fP\fB]/\fP\fImm\fP
.TP 5
\fBAllow @IF(\fP\fIname\fP\fB)\fP
.TP 5
\fBAllow @LOCAL\fP
Permite acesso a partir das máquinas, domínios, endereços, ou interfaces
nomeadas. A forma @IF(name) usa as sub\-redes configuradas actualmente para a
interface nomeada. A forma @LOCAL usa as sub\-redes configuradas actualmente
para todas as interfaces que não são ponto\-por\-ponto, por exemplo,
interfaces Ethernet e Wi\-Fi são usadas mas interfaces DSL e VPN não são. A
directiva Order controla se as linhas Allow são avaliadas antes ou depois
das linhas Deny.
.TP 5
\fBAuthType None\fP
.TP 5
\fBAuthType Basic\fP
.TP 5
\fBAuthType Default\fP
Especifica o tipo de autenticação requerido. O valor "Default" corresponde
ao valor DefaultAuthType.
.TP 5
\fBDeny all\fP
.TP 5
\fBDeny none\fP
.TP 5
\fBDeny \fP\fIhost.domain.com\fP
.TP 5
\fBDeny *.\fP\fIdomain.com\fP
.TP 5
\fBDeny \fP\fIipv4\-address\fP
.TP 5
\fBDeny \fP\fIipv4\-address\fP\fB/\fP\fInetmask\fP
.TP 5
\fBDeny \fP\fIipv4\-address\fP\fB/\fP\fImm\fP
.TP 5
\fBDeny [\fP\fIipv6\-address\fP\fB]\fP
.TP 5
\fBDeny [\fP\fIipv6\-address\fP\fB]/\fP\fImm\fP
.TP 5
\fBDeny @IF(\fP\fIname\fP\fB)\fP
.TP 5
\fBDeny @LOCAL\fP
Nega acesso a partir das máquinas, domínios, endereços, ou interfaces
nomeadas. A forma @IF(name) usa as sub\-redes configuradas actualmente para a
interface nomeada. A forma @LOCAL usa as sub\-redes configuradas actualmente
para todas as interfaces que não são ponto\-por\-ponto, por exemplo,
interfaces Ethernet e Wi\-Fi são usadas mas interfaces DSL e VPN não são. A
directiva Order controla se as linhas Deny são avaliadas antes ou depois das
linhas Allow.
.TP 5
\fBEncryption IfRequested\fP
.TP 5
\fBEncryption Never\fP
.TP 5
\fBEncryption Required\fP
Especifica o nível de encriptação que é requerido para uma localização
particular. O valor predefinido é "IfRequested".
.TP 5
\fBOrder allow,deny\fP
Especifica que o acesso é negado por predefinição. As linhas Allow são
depois processadas seguindo\-se as linhas Deny para determinar se um cliente
pode aceder a um recurso particular.
.TP 5
\fBOrder deny,allow\fP
Especifica que o acesso é permitido por predefinição. As linhas Deny são
depois processadas seguindo\-se as linhas Allow para determinar se um cliente
pode aceder a um recurso particular.
.TP 5
\fBRequire group \fP\fIgroup\-name \fP[ \fIgroup\-name \fP... ]
Especifica que um utilizador autenticado tem de ser um membro de um dos
grupos nomeados.
.TP 5
\fBRequire user {\fP\fIuser\-name\fP|\fB@\fP\fIgroup\-name\fP} ...
Especifica que um utilizador autenticado tem de corresponder a um dos
utilizadores nomeados ou ser membro de um dos grupos nomeados. O nome de
grupo "@SYSTEM" corresponde à lista de grupos definida pela directiva
SystemGroup no ficheiro \fBcups\-files.conf\fP(5). O nome de grupo "@OWNER"
corresponde ao dono do recurso, por exemplo, a pessoa que submeteu um
trabalho de impressão. Nota: O utilizador 'root' não é especial e tem de ter
privilégios como qualquer outra conta de utilizador.
.TP 5
\fBRequire valid\-user\fP
Especifica que qualquer utilizador autenticado é aceitável.
.TP 5
\fBSatisfy all\fP
Especifica que todas as condições Allow, AuthType, Deny, Order, e Require
têm de ser satisfeitas para permitir acesso.
.TP 5
\fBSatisfy any\fP
Especifica que qualquer cliente pode aceder a um recurso se uma das
condições de autenticação (AuthType/Require) ou de endereço
(Allow/Deny/Order) forem satisfeitas. Por exemplo, isto pode ser usado para
requerer autenticação apenas para acessos remotos.
.SS "DIRECTIVAS VÁLIDAS DENTRO DE SECÇÕES DE POLÍTICAS"
As seguintes directivas podem ser colocadas dentro das secções Policy no
ficheiro \fBcupsd.conf\fP:
.TP 5
\fBJobPrivateAccess all\fP
.TP 5
\fBJobPrivateAccess default\fP
.TP 5
\fBJobPrivateAccess \fP{\fIuser\fP|\fB@\fP\fIgroup\fP|\fB@ACL\fP|\fB@OWNER\fP|\fB@SYSTEM\fP} ...
Especifica uma lista de acesso para valores privados de trabalhos. A lista
de acesso "default" é "@OWNER @SYSTEM". Mapeia "@ACL" para os valores
requesting\-user\-name\-allowed ou requesting\-user\-name\-denied values da
impressora. Mapeia "@OWNER" para o dono do trabalho. Mapeia "@SYSTEM" para
os grupos listados para a directiva SystemGroup no ficheiro
\fBcups\-files.conf\fP(5).
.TP 5
\fBJobPrivateValues all\fP
.TP 5
\fBJobPrivateValues default\fP
.TP 5
\fBJobPrivateValues none\fP
.TP 5
\fBJobPrivateValues \fP\fIattribute\-name \fP[ ... \fIattribute\-name \fP]
Especifica a lista de valores de trabalho a tornar privado. Os valores
"default" são "job\-name", "job\-originating\-host\-name",
"job\-originating\-user\-name", e "phone".
.TP 5
\fBSubscriptionPrivateAccess all\fP
.TP 5
\fBSubscriptionPrivateAccess default\fP
.TP 5
\fBSubscriptionPrivateAccess \fP{\fIuser\fP|\fB@\fP\fIgroup\fP|\fB@ACL\fP|\fB@OWNER\fP|\fB@SYSTEM\fP} ...
Especifica uma lista de acesso para valores privados de subscrições. A lista
de acesso "default" é "@OWNER @SYSTEM". Mapeia "@ACL" para os valores
requesting\-user\-name\-allowed ou requesting\-user\-name\-denied values da
impressora. Mapeia "@OWNER" para o dono do trabalho. Mapeia "@SYSTEM" para
os grupos listados para a directiva SystemGroup no ficheiro
\fBcups\-files.conf\fP(5).
.TP 5
\fBSubscriptionPrivateValues all\fP
.TP 5
\fBSubscriptionPrivateValues default\fP
.TP 5
\fBSubscriptionPrivateValues none\fP
.TP 5
\fBSubscriptionPrivateValues \fP\fIattribute\-name \fP[ ... \fIattribute\-name \fP]
Especifica uma lista de valores de subscrição a tornar privados. Os valores
"default" são "notify\-events", "notify\-pull\-method", "notify\-recipient\-uri",
"notify\-subscriber\-user\-name", e "notify\-user\-data".
.SS "DIRECTIVAS DESCONTINUADAS"
As seguintes directivas estão descontinuadas e serão removidas num
lançamento futuro do CUPS.
.TP 5
\fBAuthType Negotiate\fP
.\"#Classification
Especifica que a autenticação Kerberos é requerida.
.TP 5
\fBClassification \fP\fIbanner\fP
.br
.\"#ClassifyOverride
Especifica a classificação de segurança do servidor. Qualquer nome de banner
válido pode ser usado, incluindo "classified", "confidential", "secret",
"topsecret", e "unclassified", ou o banner pode ser omitido para desactivar
funções de impressão seguras. A predefinição é nenhum banner de
classificação.
.TP 5
\fBClassifyOverride Yes\fP
.TP 5
\fBClassifyOverride No\fP
.br
Especifica se os utilizador podem sobrepor a classificação (página de capa)
dos trabalhos de impressão individuais usando a opção "job\-sheets". A
predefinição é "No".
.TP 5
\fBDefaultAuthType Negotiate\fP
.\"#GSSServiceName
Especifica que a autenticação Kerberos é requerida por predefinição.
.TP 5
\fBGSSServiceName \fP\fIname\fP
.\"#PageLogFormat
Especifica o nome do serviço quando se usa autenticação Kerberos. O nome
predefinido do serviço é "http."
.TP 5
\fBPageLogFormat \fP\fIformat\-string\fP
Especifica o formato das linhas PageLog. As sequências que começam com o
caractere de percentagem (%) são substituídas pela informação
correspondente, enquanto todos os outros caracteres são copiados
literalmente. As seguintes sequências de percentagem são reconhecidas:
.nf
"%%" inserts a single percent character.
"%{name}" inserts the value of the specified IPP attribute.
"%C" inserts the number of copies for the current page.
"%P" inserts the current page number.
"%T" inserts the current date and time in common log format.
"%j" inserts the job ID.
"%p" inserts the printer name.
"%u" inserts the username.
.fi
A predefinição é a string vazia, a qual desactiva o registar de páginas. A
string "%p %u %j %T %P %C %{job\-billing} %{job\-originating\-host\-name}
%{job\-name} %{media} %{sides}" cria um registo de página com os itens
standard. Use "%{job\-impressions\-completed}" para inserir o número de
páginas (lados) que foram imprimidos, ou "%{job\-media\-sheets\-completed}"
para inserir o número de folhas que foram impressas.
.SH NOTAS
As directivas de ficheiro, directório e configuração de utilizador que
costumavam ser permitidas no ficheiro \fBcupsd.conf\fP são agora em vez disso
guardadas no ficheiro \fBcups\-files.conf\fP(5) para prevenir certos tipos de
ataques de escalada de privilégios.
.PP
O agendador TEM de ser reiniciado manualmente após se fazer alterações no
ficheiro \fBcupsd.conf\fP. Em Linux isto é feito tipicamente usando o comando
\fBsystemctl\fP(8), enquanto no macOS é usado o comando \fBlaunchctl\fP(8).
.PP
O nome de macro @LOCAL pode criar confusão pois o sistema que corre o
\fBcupsd\fP geralmente pertence a um conjunto de sub\-redes diferentes dos seus
clientes.
.SH "DE ACORDO COM"
O formato do ficheiro \fBcupsd.conf\fP é baseado no formato de configuração do
Servidor de HTTP Apache.
.SH EXEMPLOS
Registar tudo com um tamanho de ficheiro log máximo de 32 megabytes:
.nf
AccessLogLevel all
LogLevel debug2
MaxLogSize 32m
.fi
Requerer autenticação para acesso a partir de fora da rede 10. :
.nf
Order allow,deny
Allow from 10./8
AuthType Basic
Require valid\-user
Satisfy any
.fi
.SH "VEJA TAMBÉM"
\fBclasses.conf\fP(5), \fBcups\-files.conf\fP(5), \fBcupsd\fP(8), \fBmime.convs\fP(5),
\fBmime.types\fP(5), \fBprinters.conf\fP(5), \fBsubscriptions.conf\fP(5), Ajuda
Online do CUPS (http://localhost:631/help)
.SH COPYRIGHT
Copyright \[co] 2020\-2023 by OpenPrinting.