.\"
.\" cupsfilter man page for CUPS.
.\"
.\" Copyright © 2021-2023 by OpenPrinting.
.\" Copyright © 2007-2019 by Apple Inc.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
.\" information.
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH cupsfilter 8 CUPS 2021\-02\-28 OpenPrinting
.SH NOME
cupsfilter \- converte um ficheiro para outro formato usando os filtros do
cups (descontinuado)
.SH RESUMO
\fBcupsfilter\fP [ \fB\-\-list\-filters\fP ] [ \fB\-D\fP ] [ \fB\-U\fP \fIuser\fP ] [ \fB\-c\fP
\fIconfig\-file\fP ] [ \fB\-d\fP \fIprinter\fP ] [ \fB\-e\fP ] [ \fB\-i\fP \fImime/type\fP ] [
\fB\-j\fP \fIjob\-id[,N]\fP ] [ \fB\-m\fP \fImime/type\fP ] [ \fB\-n\fP \fIcopies\fP ] [ \fB\-o\fP
\fIname=value\fP ] [ \fB\-p\fP \fIfilename.ppd\fP ] [ \fB\-t\fP \fItitle\fP ] [ \fB\-u\fP ]
\fIfilename\fP
.SH DESCRIÇÃO
\fBcupsfilter\fP é um front\-end para o subsistema de filtros do CUPS o qual
permite\-lhe converter um ficheiro para um formato específico, como se você
tivesse imprimido o ficheiro através do CUPS. Por predefinição, o
\fBcupsfilter\fP gera um ficheiro PDF. O ficheiro convertido é enviado para a
saída standard.
.SH OPÇÕES
.TP  5
\fB\-\-list\-filters\fP
Não corre realmente os filtros, apenas escreve os filtros usados no stdout.
.TP  5
\fB\-D\fP
Apaga o ficheiro de entrada após conversão.
.TP  5
\fB\-U \fP\fIuser\fP
Especifica o nome de utilizador a passar aos filtros. A predefinição é o
utilizador actual.
.TP  5
\fB\-c \fP\fIconfig\-file\fP
Usa o ficheiro de configuração cups\-files.conf nomeado.
.TP  5
\fB\-d \fP\fIprinter\fP
Usa informação da impressora nomeada.
.TP  5
\fB\-e\fP
Usa todos os filtros do ficheiro PPD.
.TP  5
\fB\-i \fP\fImime/type\fP
Especifica o tipo de ficheiro fonte. O tipo de ficheiro predefinido é
adivinhado usando o nome de ficheiro e o conteúdo do ficheiro.
.TP  5
\fB\-j \fP\fIjob\-id[,N]\fP
Converte documento N de um trabalho especificado. Se N for omitido, é
convertido o documento 1.
.TP  5
\fB\-m \fP\fImime/type\fP
Especifica o tipo de ficheiro de destino. O tipo de ficheiro predefinido é
application/pdf. Use printer/foo para converter para o formato da impressora
definido pelos filtros no ficheiro PPD.
.TP  5
\fB\-n \fP\fIcopies\fP
Especifica o número de cópias a gerar.
.TP  5
\fB\-o \fP\fIname=value\fP
Especifica as opções a passar aos filtros do CUPS.
.TP  5
\fB\-p \fP\fIfilename.ppd\fP
Especifica o ficheiro PPD a usar.
.TP  5
\fB\-t \fP\fItitle\fP
Especifica o título do documento.
.TP  5
\fB\-u\fP
Apaga o ficheiro PPD após conversão.
.SH "ESTADO DE SAÍDA"
\fBcupsfilter\fP retorna estado não\-zero se saída em qualquer erro.
.SH AMBIENTE
Todas as variáveis de ambiente standard do \fBcups\fP(1) afectam a operação do
\fBcupsfilter\fP.
.SH FICHEIROS
.nf
/etc/cups/cups\-files.conf
/etc/cups/*.convs
/etc/cups/*.types
/usr/share/cups/mime/*.convs
/usr/share/cups/mime/*.types
.SH NOTAS
Drivers de impressoras, filtros e backends do CUPS estão descontinuados e
não irão ser mais suportados num futuro lançamento do CUPS. Impressoras que
não suportem IPP podem ser suportadas usando aplicações como a
\fBippeveprinter\fP(1).
.LP
Ao contrário de quando se imprime, os filtros que correm usando o comando
\fBcupsfilter\fP usam o utilizador actual e sessão de segurança. Isto pode
resultar numa saída diferente ou comportamento inesperado.
.SH EXEMPLO
O seguinte comando irá gerar uma antevisão em PDF do trabalho 42 para uma
impressora chamada "myprinter" e irá salva\-lo num ficheiro chamado
"preview.pdf":
.nf

    cupsfilter \-m application/pdf \-d myprinter \-j 42 >preview.pdf
.fi
.SH "VEJA TAMBÉM"
\fBcups\fP(1), \fBcupsd.conf\fP(5), \fBfilter(7),\fP \fBmime.convs\fP(7),
\fBmime.types\fP(7), Ajuda Online do CUPS (http://localhost:631/help)
.SH COPYRIGHT
Copyright \[co] 2021\-2023 by OpenPrinting.