Linux Manpages Online - man.cx manual pages

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.

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.

Manpages

NOME

DESCRIÇÃO

NOTAS

VEJA TAMBÉM

COPYRIGHT