ippeveprinter - uma aplicação de impressão em-torno de ipp
para cups
ippeveprinter [
--help ] [
--no-web-forms ] [
--pam-service service ] [
--version ] [
-2 ] [
-A ] [
-D device-uri ] [
-F
output-type/subtype ] [
-K keypath ] [
-M
manufacturer ] [
-P filename.ppd ] [
-V
ipp-version ] [
-a filename.conf ] [
-c
command ] [
-d spool-directory ] [
-f
type/subtype[,...] ] [
-i iconfile.png ] [
-k ] [
-l location ] [
-m model ] [
-n
hostname ] [
-p port ] [
-r
subtype[,subtype] ] [
-s speed[,color-speed] ] [
-v[vvv] ]
service-name
ippeveprinter é 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.
As seguintes opções são reconhecidas pelo
ippeveprinte:
- --help
- Mostra a utilização do programa.
- --no-web-forms
- Desactiva os formulários da interface web usados
para actualizar a média e níveis de suplementos.
-
--pam-service service
- Define o nome do serviço PAM. O serviço
predefinido é "cups".
- --version
- Mostra a versão do CUPS.
- -2
- Reporta suporte para impressão de dois-lados
(duplex).
- -A
- Activa autenticação para a impressora criada.
ippeveprinter usa PAM para autenticar credenciais HTTP Basic.
-
-D device-uri
- 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 ippeveprinter irá criar
um ficheiro de saída usando o ID e nome do trabalho.
-
-F output-type/subtype[,...]
- Especifica o tipo de média MIME de saída. A
predefinição é "application/postscript"
quando a opção -P é especificada.
-
-M manufacturer
- Define o fabricante da impressora. A
predefinição é "Example".
-
-P filename.ppd
- Carrega atributos de impressora a partir do ficheiro PPD
especificado. Esta opção é usada tipicamente um
conjunto com o comando de impressão ippeveps(7) ("-c
ippeveps").
- -V 1.1
- -V 2.0
- Especifica a versão IPP máxima a reportar. A
predefinição é 2.0.
-
-c command
- Corre o comando especificado para cada documento que
é imprimido. Se "command" não for um caminho
absoluto ("/caminho/para/comando"), o ippeveprinter
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
cups-config(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 cups(1) para mais
detalhes.
-
-d spool-directory
- 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.
-
-f type/subtype[,...]
- Especifica uma lista de tipos de média MIME que o
servidor irá aceitar. A predefinição depende do tipo
de impressora criada.
-
-i iconfile.png
- 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.
- -k
- Mantém os documentos imprimidos no directório
spool em vez de os apagar.
-
-l location
- Especifica a string de localização
humanamente-legível que é reportada pelo servidor. A
predefinição é uma string vazia.
-
-m model
- Especifica o nome de modelo da impressora. A
predefinição é "Printer".
-
-n hostname
- Especifica o nome-de-máquina que é reportado
pelo servidor. A predefinição é o nome retornado pelo
comando hostname(1).
-
-p port
- Especifica o número de porto a escutar. A
predefinição é um número
específico-de-utilizador de 8000 até 8999.
- -r off
- Desliga totalmente as propagandas do serviço
DNS-SD.
-
-r subtype[,subtype]
- Especifica os sub-tipo(s) de DNS-SD a publicitar. Separe os
vários sub-tipos com uma vírgula. A
predefinição é "_print".
-
-s speed[,color-speed]
- 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".
- -v[vvv]
- Fica (muito) detalhado quando regista atividade no erro
standard.
O programa
ippeveprinter 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
ippeveprinter irá correr continuamente
até que termine.
O programa
ippeveprinter é único do CUPS e está em
conformidade com a especificação IPP Everywhere (PWG 5100.14).
ippeveprinter 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.
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".
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".
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".
A menos que comuniquem directamente com uma impressora, os comandos de
impressão enviam dados-prontos-para-impressora para a saída
standard.
OS comandos de impressão podem enviar mensagens de volta ao
ippeveprinter no erro standard com um dos seguintes prefixos:
-
ATTR: attribute=value[ attribute=value]
- 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.
-
DEBUG: Debugging message
- Regista uma mensagem de depuração se pelo
menos dois -v's foram especificados.
-
ERROR: Error message
- Regista uma mensagem de erro e copia a mensagem para o
atributo "job-state-message".
-
INFO: Informational message
- 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.
-
STATE: keyword[,keyword,...]
- Define o atributo "printer-state-reasons" da
impressora para as palavras chave listadas.
-
STATE: -keyword[,keyword,...]
- Remove as palavras chave listadas do atributo
"printer-state-reasons" da impressora.
-
STATE: +keyword[,keyword,...]
- Adiciona as palavras chave listadas ao atributo
"printer-state-reasons" da impressora.
Correr
ippeveprinter com um nome de serviço de My Cool Printer:
ippeveprinter "My Cool Printer"
Correr o comando
file(1) sempre que um trabalho é enviado para o
servidor:
ippeveprinter -c /usr/bin/file "My Cool Printer"
ippevepcl(7),
ippeveps(7), PWG Internet Printing Protocol
Workgroup (
http://www.pwg.org/ipp)
Copyright © 2021-2022 de OpenPrinting.