cups-files.conf(5)

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.

    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.