.\" .\" ippeveprinter man page for CUPS. .\" .\" Copyright © 2021-2023 by OpenPrinting. .\" Copyright © 2014-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 ippeveprinter 1 CUPS 2021\-02\-28 OpenPrinting .SH NOME ippeveprinter \- uma aplicação de impressão em\-torno de ipp para cups .SH RESUMO \fBippeveprinter\fP [ \fB\-\-help\fP ] [ \fB\-\-no\-web\-forms\fP ] [ \fB\-\-pam\-service\fP \fIservice\fP ] [ \fB\-\-version\fP ] [ \fB\-2\fP ] [ \fB\-A\fP ] [ \fB\-D\fP \fIdevice\-uri\fP ] [ \fB\-F\fP \fIoutput\-type/subtype\fP ] [ \fB\-K\fP \fIkeypath\fP ] [ \fB\-M\fP \fImanufacturer\fP ] [ \fB\-P\fP \fIfilename.ppd\fP ] [ \fB\-V\fP \fIipp\-version\fP ] [ \fB\-a\fP \fIfilename.conf\fP ] [ \fB\-c\fP \fIcommand\fP ] [ \fB\-d\fP \fIspool\-directory\fP ] [ \fB\-f\fP \fItype/subtype[,...]\fP ] [ \fB\-i\fP \fIiconfile.png\fP ] [ \fB\-k\fP ] [ \fB\-l\fP \fIlocation\fP ] [ \fB\-m\fP \fImodel\fP ] [ \fB\-n\fP \fIhostname\fP ] [ \fB\-p\fP \fIport\fP ] [ \fB\-r\fP \fIsubtype[,subtype]\fP ] [ \fB\-s\fP \fIspeed[,color\-speed]\fP ] [ \fB\-v[vvv]\fP ] \fIservice\-name\fP .SH DESCRIÇÃO \fBippeveprinter\fP é um servidor simples de Internet Printing Protocol (IPP) em conformidade com a especificação IPP Everywhere (PWG 5100.14). Pode ser usado para testar software cliente ou actuar como um servidor de impressão muito básico que corre um comando para cada trabalho que é imprimido. .SH OPÇÕES As seguintes opções são reconhecidas pelo \fBippeveprinte:\fP .TP 5 \fB\-\-help\fP Mostra a utilização do programa. .TP 5 \fB\-\-no\-web\-forms\fP Desactiva os formulários da interface web usados para actualizar a média e níveis de suplementos. .TP 5 \fB\-\-pam\-service \fP\fIservice\fP Define o nome do serviço PAM. O serviço predefinido é "cups". .TP 5 \fB\-\-version\fP Mostra a versão do CUPS. .TP 5 \fB\-2\fP Reporta suporte para impressão de dois\-lados (duplex). .TP 5 \fB\-A\fP Activa autenticação para a impressora criada. \fBippeveprinter\fP usa PAM para autenticar credenciais HTTP Basic. .TP 5 \fB\-D \fP\fIdevice\-uri\fP Define o URI de dispositivo para saída de impressão. O URI pode ser um nome de ficheiro, directório, ou um URI de socket de rede do formato "socket://ADDRESS[:PORT]" (onde o número de porto predefinido é 9100). Ao se especificar um directório, o \fBippeveprinter\fP irá criar um ficheiro de saída usando o ID e nome do trabalho. .TP 5 \fB\-F \fP\fIoutput\-type/subtype[,...]\fP Especifica o tipo de média MIME de saída. A predefinição é "application/postscript" quando a opção \fB\-P\fP é especificada. .TP 5 \fB\-M \fP\fImanufacturer\fP Define o fabricante da impressora. A predefinição é "Example". .TP 5 \fB\-P \fP\fIfilename.ppd\fP Carrega atributos de impressora a partir do ficheiro PPD especificado. Esta opção é usada tipicamente um conjunto com o comando de impressão \fBippeveps\fP(7) ("\-c ippeveps"). .TP 5 \fB\-V 1.1\fP .TP 5 \fB\-V 2.0\fP Especifica a versão IPP máxima a reportar. A predefinição é 2.0. .TP 5 \fB\-c \fP\fIcommand\fP Corre o comando especificado para cada documento que é imprimido. Se "command" não for um caminho absoluto ("/caminho/para/comando"), o \fBippeveprinter\fP procura o comando no sub\-directório "command" do directório binário do CUPS, tipicamente /usr/lib/cups/command ou /usr/libexec/cups/command. O comando \fBcups\-config\fP(1) pode ser usado para descobrir o directório binário correto ("cups\-config \-\-serverbin"). Adicionalmente, a variável de ambiente CUPS_SERVERBIN pode ser usada para sobrepor a localização predefinida deste directório \- veja o manual do \fBcups\fP(1) para mais detalhes. .TP 5 \fB\-d \fP\fIspool\-directory\fP Especifica o directório que irá manter os ficheiros de impressão. A predefinição é um directório sob o directório temporário actual do utilizador. .TP 5 \fB\-f \fP\fItype/subtype[,...]\fP Especifica uma lista de tipos de média MIME que o servidor irá aceitar. A predefinição depende do tipo de impressora criada. .TP 5 \fB\-i \fP\fIiconfile.png\fP Especifica o ficheiro de ícone da impressora para o servidor. O ficheiro tem de ser uma imagem de formato PNG. A predefinição é uma imagem PNG fornecida internamente. .TP 5 \fB\-k\fP Mantém os documentos imprimidos no directório spool em vez de os apagar. .TP 5 \fB\-l \fP\fIlocation\fP Especifica a string de localização humanamente\-legível que é reportada pelo servidor. A predefinição é uma string vazia. .TP 5 \fB\-m \fP\fImodel\fP Especifica o nome de modelo da impressora. A predefinição é "Printer". .TP 5 \fB\-n \fP\fIhostname\fP Especifica o nome\-de\-máquina que é reportado pelo servidor. A predefinição é o nome retornado pelo comando \fBhostname\fP(1). .TP 5 \fB\-p \fP\fIport\fP Especifica o número de porto a escutar. A predefinição é um número específico\-de\-utilizador de 8000 até 8999. .TP 5 \fB\-r off\fP Desliga totalmente as propagandas do serviço DNS\-SD. .TP 5 \fB\-r \fP\fIsubtype[,subtype]\fP Especifica os sub\-tipo(s) de DNS\-SD a publicitar. Separe os vários sub\-tipos com uma vírgula. A predefinição é "_print". .TP 5 \fB\-s \fP\fIspeed[,color\-speed]\fP Especifica a velocidade da impressora em páginas por minuto. Se forem especificados dois números e o segundo número for maior que zero, o servidor irá reportar o suporte para impressão a cores. A predefinição é "10,0". .TP 5 \fB\-v[vvv]\fP Fica (muito) detalhado quando regista atividade no erro standard. .SH "ESTADO DE SAÍDA" O programa \fBippeveprinter\fP retorna 1 se não for capaz de processar os argumentos de linha de comandos ou registar o serviço IPP. Caso contrário o \fBippeveprinter\fP irá correr continuamente até que termine. .SH "DE ACORDO COM" O programa \fBippeveprinter\fP é único do CUPS e está em conformidade com a especificação IPP Everywhere (PWG 5100.14). .SH AMBIENTE \fBippeveprinter\fP adiciona variáveis de ambiente que começam com "IPP_" para todos os atributos de trabalho IPP no pedido de impressão. Por exemplo, quando executa um comando para um trabalho IPP que contém o atributo Job Template "media", a variável de ambiente "IPP_MEDIA" será definida para o valor desse atributo. .LP Adicionalmente, todos os atributos IPP "xxx\-default" e "pwg\-xxx" Printer Description são adicionados ao ambiente. Por exemplo, a variável de ambiente "IPP_MEDIA_DEFAULT" será definida para o valor predefinido para o atributo Job Template "media". .LP Valores numerados são convertidos para suas palavras chave equivalentes. Por exemplo, um atributo Job Template "print\-quality" com um valor numérico de 3 irá tornar\-se na variável de ambiente "IPP_PRINT_QUALITY" com o valor de "draft". Esta conversão de strings apenas acontece para atributos Job Template standard, actualmente "finishings", "orientation\-requested", e "print\-quality". .LP Finalmente, a variável de ambiente "CONTENT_TYPE" contém o tipo de média MIME do documento a ser imprimido, a variável de ambiente "DEVICE_URI" contém o URI do dispositivo como especificado com a opção "\-D", a variável de ambiente "OUTPUT_FORMAT" contém o tipo de média MIME de saída e a variável de ambiente "PPD" contém o nome do ficheiro PPD como especificado com a opção "\-P". .SH "RESULTADO DO COMANDO" A menos que comuniquem directamente com uma impressora, os comandos de impressão enviam dados\-prontos\-para\-impressora para a saída standard. .LP OS comandos de impressão podem enviar mensagens de volta ao \fBippeveprinter\fP no erro standard com um dos seguintes prefixos: .TP 5 \fBATTR: \fP\fIattribute=value[ attribute=value]\fP Define os atributos(s) para os valores fornecidos. Actualmente apenas os atributos Job Status "job\-impressions" e "job\-impressions\-completed" e os atributos Printer Status "marker\-xxx", "printer\-alert", "printer\-alert\-description", "printer\-supply", e "printer\-supply\-description" podem ser definidos. .TP 5 \fBDEBUG: \fP\fIDebugging message\fP Regista uma mensagem de depuração se pelo menos dois \-v's foram especificados. .TP 5 \fBERROR: \fP\fIError message\fP Regista uma mensagem de erro e copia a mensagem para o atributo "job\-state\-message". .TP 5 \fBINFO: \fP\fIInformational message\fP Regista uma mensagem de informação/progresso se \-v foi especificado e copia a mensagem para o atributo "job\-state\-message" a menos que um erro tenha sido reportado. .TP 5 \fBSTATE: \fP\fIkeyword[,keyword,...]\fP Define o atributo "printer\-state\-reasons" da impressora para as palavras chave listadas. .TP 5 \fBSTATE: \-\fP\fIkeyword[,keyword,...]\fP Remove as palavras chave listadas do atributo "printer\-state\-reasons" da impressora. .TP 5 \fBSTATE: +\fP\fIkeyword[,keyword,...]\fP Adiciona as palavras chave listadas ao atributo "printer\-state\-reasons" da impressora. .SH EXEMPLOS Correr \fBippeveprinter\fP com um nome de serviço de My Cool Printer: .nf ippeveprinter "My Cool Printer" .fi .LP Correr o comando \fBfile\fP(1) sempre que um trabalho é enviado para o servidor: .nf ippeveprinter \-c /usr/bin/file "My Cool Printer" .fi .SH "VEJA TAMBÉM" \fBippevepcl\fP(7), \fBippeveps\fP(7), PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp) .SH COPYRIGHT Copyright \[co] 2021\-2023 by OpenPrinting.