cups-files.conf - ficheiro de configuração de ficheiro e
directório para cups
O ficheiro
cups-files.conf configura os ficheiro e directórios
usados pelo agendador do CUPS,
cupsd(8). Fica normalmente localizado no
directório
/etc/cups.
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 #.
As seguintes directivas são compreendidas pelo
cupsd(8):
- AccessLog
-
AccessLog filename
- AccessLog stderr
- AccessLog syslog
- Define o nome de ficheiro do registo de acesso. Especificar
um nome de ficheiro vazio desactiva a geração de registos de
acesso. O valor "stderr" faz com que as entradas no registo
sejam enviadas para o ficheiro de erro standard quando o agendador corre
em primeiro plano, ou para o daemon de log do sistema quando corre em
plano de fundo. O valor "syslog" faz com que as entradas no
registo sejam enviadas para o daemon de log do sistema. O nome do servidor
pode ser incluído nos nomes de ficheiros usando a string
"%s", por exemplo:
AccessLog /var/log/cups/%s-access_log
A predefinição é
"/var/log/cups/access_log".
-
CacheDir directory
- Especifica o directório a usar para ficheiros
temporários de longa-vida (cache). A predefinição
é "/var/spool/cups/cache" ou "/var/cache/cups"
dependendo da plataforma.
-
ConfigFilePerm mode
- Especifica as permissões para todos os ficheiros de
configuração que o agendador escreve. A
predefinição é "0644" no macOS e
"0640" em todos os outros sistemas operativos.
Nota: As permissões para o ficheiro
printers.conf
são actualmente mascaradas para apenas permitir acesso a partir do
utilizador agendador (tipicamente o root). isto é feito porque os URIs
de dispositivos de impressoras por vezes contêm
informação de autenticação sensível que
geralmente não deve ser conhecida no sistema. Não existe modo de
desactivar esta característica de segurança.
- CreateSelfSignedCerts yes
- CreateSelfSignedCerts no
- Especifica se o agendador cria automaticamente certificados
auto-assinados para ligações de clientes usando TLS. A
predefinição é sim (yes).
-
DataDir path
- Especifica o directório onde os ficheiros de dados
podem ser encontrados. A predefinição é geralmente
"/usr/share/cups".
-
DocumentRoot directory
- Especifica o directório raiz para o conteúdo
da interface web do CUPS. A predefinição é geralmente
"/usr/share/doc/cups".
- ErrorLog
-
ErrorLog filename
- ErrorLog stderr
- ErrorLog syslog
- Define o nome de ficheiro do registo de erros. Especificar
um nome de ficheiro vazio desactiva a geração de registos de
erros. O valor "stderr" faz com que as entradas no registo sejam
enviadas para o ficheiro de erro standard quando o agendador corre em
primeiro plano, ou para o daemon de log do sistema quando corre em plano
de fundo. O valor "syslog" faz com que as entradas no registo
sejam enviadas para o daemon de log do sistema. O nome do servidor pode
ser incluído nos nomes de ficheiros usando a string "%s",
por exemplo:
ErrorLog /var/log/cups/%s-error_log
A predefinição é
"/var/log/cups/error_log".
- FatalErrors none
-
FatalErrors all -kind [ ... -kind
]
-
FatalErrors kind [ ... kind ]
- Especifica quais erros são fatais, fazendo o
agendador terminar. A predefinição é
"config". As strings kind são:
- none
- Nenhum erro é fatal.
- all
- Todos os erros em baixo são fatais.
- browse
- Erros de inicialização do
navegação são fatais, por exemplo,
ligações falhadas ao daemon DNS-SD.
- config
- Erros de sintaxe do ficheiro de configuração
são fatais.
- listen
- Erros de escuta em Porto são fatais, excepto para
falhas de IPv6 nos endereços loopback ou "any".
- log
- A criação do ficheiro de registo ou erros de
escrita são fatais.
- permissions
- Permissões de ficheiros erradas no arranque
são fatais, por exemplo, certificados TLS partilhados e ficheiros
chave com permissões de leitura para todo o mundo.
-
Group group-name-or-number
- Especifica o nome ou ID do grupo que irá ser usado
quando se executa programas externos. O grupo predefinido é
específico do sistema operativo mas é geralmente
"lp" ou "nobody".
-
LogFileGroup group-name-or-number
- Especifica o nome ou ID do grupo que irá ser usado
para ficheiros de registo. O grupo predefinido é específico
do sistema operativo mas é geralmente "lp" ou
"nobody".
-
LogFilePerm mode
- Especifica as permissões para todos os ficheiros de
registo que o agendador cria. A predefinição é
"0644".
-
PageLog [ filename ]
- PageLog stderr
- PageLog syslog
- Define o nome de ficheiro do registo de páginas. O
valor "stderr" faz com que as entradas no registo sejam enviadas
para o ficheiro de erro standard quando o agendador corre em primeiro
plano, ou para o daemon de log do sistema quando corre em plano de fundo.
O valor "syslog" faz com que as entradas no registo sejam
enviadas para o daemon de log do sistema. Especificar um nome de ficheiro
vazio desactiva a geração de registo de páginas. O
nome do servidor pode ser incluído nos nomes de ficheiros usando a
string "%s", por exemplo:
PageLog /var/log/cups/%s-page_log
A predefinição é
"/var/log/cups/page_log".
-
PassEnv variable [ ... variable ]
- Passa as variável(is) de ambiente especificadas para
os processos filho. Nota: As variáveis de filtro CUPS standard e
ambiente de backend não podem ser sobrepostas usando esta
directiva.
-
RemoteRoot username
- Especifica o nome de utilizador que é associado a
acessos autenticados por cliente que afirmam ser o utilizador root. A
predefinição é "remroot".
-
RequestRoot directory
- Especifica o directório que contém trabalhos
de impressão e outros dados de pedidos HTTP. A
predefinição é "/var/spool/cups".
- Sandboxing relaxed
- Sandboxing strict
- Especifica o nível de segurança de sandbox
que é aplicado a filtros de impressão, backends, e outros
processos filho do agendador. A predefinição é
"strict". Actualmente esta directiva é apenas utilizada
no macOS.
-
ServerBin directory
- Especifica o directório que contém os
backends, programas CGI, filtros, programas de ajuda, notificadores, e
monitores de porto. A predefinição é
"/usr/lib/cups" ou "/usr/libexec/cups" dependendo da
plataforma.
-
ServerKeychain path
- Especifica a localização de certificados TLS
e chaves privadas. A predefinição é
"/Library/Keychains/System.keychain" no macOS e
"/etc/cups/ssl" em todos os outros sistemas operativos. O macOS
usa a sua base de dados keychain para guardar os certificados e chaves
enquanto as outras plataformas usam ficheiros separados no
directório especificado, *.crt para certificados codificados em PEM
e *.key para chaves privadas codificadas em PEM.
-
ServerRoot directory
- Especifica o directório que contém os
ficheiros de configuração do servidor. A
predefinição é "/etc/cups".
-
SetEnv variable value
- Define a variável de ambiente especificada a ser
passada a processos filho. Nota: As variáveis de filtro CUPS
standard e ambiente de backend não podem ser sobrepostas usando
esta directiva.
-
StateDir directory
- Especifica o directório a usar para ficheiros de
certificados PID e locais. A predefinição é
"/var/run/cups" ou "/etc/cups" dependendo da
plataforma.
- SyncOnClose Yes
- SyncOnClose No
- Especifica se o agendador chama fsync(2) após
escrever ficheiros de configuração ou estado.
-
SystemGroup group-name [ ...
group-name ]
- Especifica os grupo(s) a usar para
autenticação do grupo @SYSTEM. A
predefinição contém "admin",
"lpadmin", "root", "sys", e/ou
"system".
-
TempDir directory
- Especifica o directório onde os ficheiros
temporários de curto prazo são guardados. A
predefinição é "/var/spool/cups/tmp".
-
User username
- Especifica o nome de utilizador ou ID que é usado
quando se correm programas externos. A predefinição é
"lp".
As seguintes directivas estão descontinuadas e serão removidas
numa futura versão do CUPS.
- FileDevice Yes
- FileDevice No
- Especifica se o pseudo-dispositivo ficheiro pode ser usado
para novas filas de impressão. O URI "file:///dev/null"
é sempre permitido. Dispositivos ficheiro não podem ser
usados com filas de impressão "raw" - é requerido
um ficheiro PPD. O ficheiro especificado é sobrescrito para cada
trabalho de impressão. Escrever para directórios não
é suportado.
-
Printcap filename
- Especifica um ficheiro que é preenchido com uma
lista de filas de impressão locais.
- PrintcapFormat bsd
- PrintcapFormat plist
- PrintcapFormat solaris
- Especifica o formato a usar para o ficheiro Printcap.
"bsd" é o formato histórico de ficheiro printcap
LPD. "plist" é o formato de ficheiro plist da Apple.
"solaris" é o formato histórico de ficheiro
printcap LPD.
O agendador TEM de ser reiniciado manualmente após se fazer
alterações no ficheiro
cups-files.conf. Em Linux isto
é feito tipicamente usando o comando
systemctl(8), enquanto no
macOS é usado o comando
launchctl(8).
classes.conf(5),
cups(1),
cupsd(8),
cupsd.conf(5),
mime.convs(5),
mime.types(5),
printers.conf(5),
subscriptions.conf(5), Ajuda Online do CUPS (http://localhost:631/help)
Copyright © 2020-2022 de OpenPrinting.