Scroll to navigation

ipptool(1) OpenPrinting ipptool(1)

NOME

ipptool - executa pedidos de protocolo de impressão de internet

RESUMO

ipptool [ --help ] [ --ippserver filename ] [ --stop-after-include-error ] [ --version ] [ -4 ] [ -6 ] [ -C ] [ -E ] [ -I ] [ -L ] [ -P filename.plist ] [ -S ] [ -T seconds ] [ -V version ] [ -X ] [ -c ] [ -d name=value ] [ -f filename ] [ -h ] [ -i seconds ] [ -j ] [ -n repeat-count ] [ -q ] [ -t ] [ -v ] printer-uri testfile [ ... testfile ]

DESCRIÇÃO

ipptool envia pedidos IPP para o printer-uri especificado e testa e/ou mostra os resultados. Cada testfile nomeado define um ou mais pedidos, incluindo o estado de resposta esperado, atributos, e valores. O resultado é um relatório ou em texto simples, texto formatado, CSV, ou XML na saída standard, com um estado de saída não-zero a indicar que um ou mais testes falharam. O formato de testfile está descrito em ipptoolfile(5).

OPÇÕES

As seguintes opções são reconhecidas pelo ipptool:

Mostra ajuda do programa.
Especifica que os resultados de teste devem ser escritos no ficheiro de atributos do ippserver nomeado.
Diz ao ipptool para parar se ocorrer um erro num ficheiro incluído. Normalmente o ipptool irá continuar com testes subsequentes após a directiva INCLUDE.
Mostra a versão do ipptool a ser usado.
-4
Especifica que o ipptool deve ligar à impressora ou servidor usando IPv4.
-6
Especifica que o ipptool deve ligar à impressora ou servidor usando IPv6.
Especifica que os pedidos devem ser enviados usando o cabeçalho HTTP/1.1 "Transfer-Encoding: chunked", o qual é necessário para conformidade por todas as versões de IPP. A predefinição é usar "Transfer-Encoding: chunked" para pedidos com ficheiros anexados e "Content-Length:" para pedidos sem ficheiros anexados.
Força encriptação TLS ao ligar ao servidor usando o cabeçalho HTTP "Upgrade".
Especifica que o ipptool irá continuar após erros.
Especifica que os pedidos devem ser enviados usando o cabeçalho HTTP/1.0 "Content-Length:", o qual é necessário para conformidade por todas as versões de IPP. A predefinição é usar "Transfer-Encoding: chunked" para pedidos com ficheiros anexados e "Content-Length:" para pedidos sem ficheiros anexados.
Especifica que os resultados de teste devem ser escritos no ficheiro XML nomeado (Apple plist) adicionalmente ao relatório de teste regular (-t). Esta opção é incompatível com as opções -i (intervalo) e -n (contagem-de-repetição).
Força encriptação TLS (dedicada) ao ligar ao servidor.
Especifica o tempo limite para pedidos IPP em segundos-
Especifica a versão IPP predefinida a usar: 1.0, 1.1, 2.0, 2.1, ou 2.2. Se não for especificada, é usada a versão 1.1.
Especifica que é desejado resultado em XML (Apple plist)em vez de relatório em texto simples. Esta opção é incompatível com as opções -i (intervalo) e -n (contagem-de-repetição).
Especifica que é desejado resultado em CSV (valores separados-por-vírgula) em vez de resultado em texto simples.
Define a variável nomeada.
Define o nome de ficheiro de pedido predefinido para testes.
Valida cabeçalhos de resposta HTTP.
Especifica que o (último) testfile deve ser repetido no intervalo especificado. Esta opção é incompatível com a opção -X (resultado em XML plist).
Especifica que o ipptool irá produzir resultados JSON.
Especifica que é desejado resultados em texto simples.
Especifica que o (último) testfile deve ser repetido o número de vezes especificado Esta opção é incompatível com a opção -X (resultado em XML plist).
Fica calado e não produz nenhuma saída.
Especifica que é desejado resultado de teste do CUPS em vez de resultado em texto simples.
Especifica que todos os atributos de pedido e resposta devem estar em saída de modo de teste do CUPS (-t). Esta é a predefinição para saída XML.

ESTADO DE SAÍDA

O programa ipptool retorna 0 se todos os testes tiverem sucesso e 1 caso contrário.

FICHEIROS

Os seguintes ficheiros standard estão disponíveis:


color.jpg
create-printer-subscription.test
document-a4.pdf
document-a4.ps
document-letter.pdf
document-letter.ps
get-completed-jobs.test
get-jobs.test
get-notifications.test
get-printer-attributes.test
get-subscriptions.test
gray.jpg
ipp-1.1.test
ipp-2.0.test
ipp-2.1.test
ipp-2.2.test
ipp-everywhere.test
onepage-a4.pdf
onepage-a4.ps
onepage-letter.pdf
onepage-letter.ps
print-job.test
print-job-deflate.test
print-job-gzip.test
testfile.jpg
testfile.pcl
testfile.pdf
testfile.ps
testfile.txt
validate-job.test

DE ACORDO COM

O programa ipptool é único do CUPS e está em conformidade com Internet Printing Protocol até à versão 2.2.

EXEMPLOS

Obter uma lista de trabalhos completados para "myprinter":


ipptool ipp://localhost/printers/myprinter get-completed-jobs.test

Enviar notificações por email para "user@example.com" quando "myprinter" mudar:


ipptool -d recipient=mailto:user@example.com \
ipp://localhost/printers/myprinter create-printer-subscription.test

VEJA TAMBÉM

ipptoolfile(5), IANA IPP Registry (https://www.iana.org/assignments/ipp-registrations), PWG Internet Printing Protocol Workgroup (https://www.pwg.org/ipp) RFC 8011 (https://datatracker.ietf.org/doc/html/rfc8011),

COPYRIGHT

Copyright © 2021-2022 de OpenPrinting.

CUPS 2021-10-20