.\"
.\" mime.types man page for CUPS.
.\"
.\" Copyright © 2021-2022 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 mime.types 5 CUPS 2021\-02\-28 OpenPrinting
.SH NOME
mime.types \- ficheiro de descrição de tipos mime para o cups
.SH DESCRIÇÃO
O ficheiro \fBmime.types\fP define os tipos de ficheiros reconhecidos.
.LP
Tipos de ficheiros adicionais são especificados em ficheiros com a extensão
\&\fI.types\fP no directório de configuração do CUPS.
.LP
Cada linha no ficheiro \fBmime.types\fP é um comentário, uma linha vazia, ou
uma linha de regra. As linhas comentários começam com o caractere #. As
linhas de regras começam com o tipo de media MIME e são seguidas
opcionalmente por uma série de regras de reconhecimento de ficheiros:
.nf

    \fImime/type \fP[ \fIrule \fP... \fIrule \fP]

.fi
As regras podem ser estendidas por várias linhas usando o caractere de barra
invertida (\e):
.nf

    \fImime/type \fP[ \fIreally\-really\-really\-long\-rule \fP... \fB\e       \fP\fIrule \fP]

.fi
Os tipos de media MIME especificados pelo campo \fImime/type\fP são sensíveis a
maiúsculas/minúsculas e estão ordenados por ordem alfanumérica ascendente
para os objectivos de corresponderem. Veja a secção "CORRESPONDÊNCIA E
PRIORIDADE DE TIPO" para ,mais informação.
.LP
As regras podem ser agrupadas usando parênteses, juntas usando "+" para um
AND lógico, juntas usando "," ou espaço em branco para um OR lógico, e
negadas usando "!".
.SS REGRAS
Regras toma duas formas \- uma extensão de nome de ficheiro por si própria e
funções com valores de teste dentro de parênteses. As seguintes funções
estão disponíveis:
.TP  5
\fBmatch("\fP\fIpattern\fP\fB")\fP
Verdadeira se o nome de ficheiro corresponder à wildcard de shell \fIpattern\fP
dada.
.TP  5
\fBascii(\fP\fIoffset\fP\fB,\fP\fIlength\fP\fB)\fP
Verdadeira se os bytes de \fIlength\fP começando em \fIoffset\fP forem ASCII
válidos imprimíveis (CR, NL, TAB, BS, 32\-126).
.TP  5
\fBprintable(\fP\fIoffset\fP\fB,\fP\fIlength\fP\fB)\fP
Verdadeira se os bytes de \fIlength\fP começando em \fIoffset\fP forem caracteres
de 8\-bit imprimíveis (CR, NL, TAB, BS, 32\-126, 128\-254).
.TP  5
\fBpriority(\fP\fInumber\fP\fB)\fP
Especifica a prioridade relativa deste tipo de média MIME. A prioridade
predefinida é 100. Valores maiores têm prioridade mais alta enquanto valores
menores têm prioridade mais baixa.
.TP  5
\fBstring(\fP\fIoffset\fP\fB,"\fP\fIstring\fP\fB")\fP
Verdadeira se os bytes que começam em \fIoffset\fP são idênticos a \fIstring\fP.
.TP  5
\fBistring(\fP\fIoffset\fP\fB,"\fP\fIstring\fP\fB")\fP
Verdadeira se os bytes que começam em \fIoffset\fP correspondem a \fIstring\fP sem
respeitar as maiúsculas/minúsculas.
.TP  5
\fBchar(\fP\fIoffset\fP\fB,\fP\fIvalue\fP\fB)\fP
Verdadeira se o byte em \fIoffset\fP é idêntico a \fIvalue\fP.
.TP  5
\fBshort(\fP\fIoffset\fP\fB,\fP\fIvalue\fP\fB)\fP
Verdadeira se o inteiro 16\-bit big\-endian em \fIoffset\fP é idêntico a
\fIvalue\fP.
.TP  5
\fBint(\fP\fIoffset\fP\fB,\fP\fIvalue\fP\fB)\fP
Verdadeira se o inteiro 32\-bit big\-endian em \fIoffset\fP é idêntico a
\fIvalue\fP.
.TP  5
\fBlocale("\fP\fIstring\fP\fB")\fP
Verdadeira se o locale actual corresponder a \fIstring\fP.
.TP  5
\fBcontains(\fP\fIoffset\fP\fB,\fP\fIrange\fP\fB,"\fP\fIstring\fP\fB")\fP
Verdadeira se os bytes que começam em \fIoffset\fP para bytes \fIrange\fP conterem
\fIstring\fP.
.SS "CONSTANTES DE STRING"
As constantes de string podem ser especificadas dentro de aspas ("") para
strings que contêm espaços em branco e colchetes angulares (<>) para
strings hexadecimais.
.SS "CORRESPONDÊNCIA E PRIORIDADE DOS TIPOS"
Quando o CUPS precisa de determinar o tipo de média MIME de um determinado
ficheiros, verifica cada tipo de média MIME definido nos ficheiros
\&\fI.types\fP. Quando dois ou mais tipos correspondem a um determinado ficheiro,
o tipo escolhido irá depender do nome e prioridade do tipo, com os tipos de
maior prioridade a serem usados sobre os de menor prioridade. Se os tipos
tiverem a mesma prioridade, os nomes de tipos são ordenados em ordem
ascendente alfanumérica e o primeiro tipo é o escolhido.
.LP
Por exemplo, se dois tipos "text/bar" e "text/foo" estiverem definidos como
correspondência da extensão "doc", normalmente o tipo "text/bar" será o
escolhido pois o nome é alfa\-numericamente menor que "text/foo". No entanto,
se "text/foo" também definir uma prioridade maior que "text/bar", então será
escolhido "text/foo".
.SH FICHEIROS
\fI/etc/cups\fP \- Directório típico de configuração do CUPS.
.SH EXEMPLOS
Definir dois tipos de média MIME para dados raster, com um a ser um
sub\-conjunto com maior prioridade:
.nf

    application/vnd.cups\-raster  string(0,"RaSt") string(0,"tSaR") \e
                                  string(0,"RaS2") string(0,"2SaR") \e
                                  string(0,"RaS3") string(0,"3SaR")

    image/pwg\-raster              string(0,"RaS2") + \e
                                  string(4,PwgRaster<00>) priority(150)
.fi
.SH "VEJA TAMBÉM"
\fBcups\-files.conf\fP(5), \fBcupsd.conf\fP(5), \fBcupsd\fP(8), \fBcupsfilter\fP(8),
\fBmime.convs\fP(5), Ajuda Online do CUPS (http://localhost:631/help)
.SH COPYRIGHT
Copyright \[co] 2021\-2022 de OpenPrinting.