Provided by: cups-daemon_2.4.12-0ubuntu1_amd64 
NOME
cups-files.conf - ficheiro de configuração de ficheiro e directório para cups
DESCRIÇÃO
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 #.
DIRECTIVAS
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.
ipUserDomain Yes
ipUserDomain No
Specifies whether to remove domain from user name during local user authentication (e.g.,
"user@example.com" –> "user"). This practice can be beneficial for maintaining compatibility with
older versions of Kerberos. However, enabling this option can have negative consequences. It may
result in confusion between domain and local users with identical names, potentially leading to
incorrect assignment of user permissions and unintentional permission escalation, thus creating a
security risk. Therefore, it is advisable to avoid using this option in most cases.
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".
DIRECTIVAS DESCONTINUADAS
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.
NOTAS
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).
VEJA TAMBÉM
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
Copyright © 2020-2024 by OpenPrinting.
2021-03-06 CUPS cups-files.conf(5)