.\" .\" ipptool man page. .\" .\" Copyright © 2021-2023 by OpenPrinting. .\" Copyright © 2010-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 ipptool 1 CUPS 2021\-10\-20 OpenPrinting .SH NOME ipptool \- executa pedidos de protocolo de impressão de internet .SH RESUMO \fBipptool\fP [ \fB\-\-help\fP ] [ \fB\-\-ippserver\fP \fIfilename\fP ] [ \fB\-\-stop\-after\-include\-error\fP ] [ \fB\-\-version\fP ] [ \fB\-4\fP ] [ \fB\-6\fP ] [ \fB\-C\fP ] [ \fB\-E\fP ] [ \fB\-I\fP ] [ \fB\-L\fP ] [ \fB\-P\fP \fIfilename.plist\fP ] [ \fB\-S\fP ] [ \fB\-T\fP \fIseconds\fP ] [ \fB\-V\fP \fIversion\fP ] [ \fB\-X\fP ] [ \fB\-c\fP ] [ \fB\-d\fP \fIname=value\fP ] [ \fB\-f\fP \fIfilename\fP ] [ \fB\-h\fP ] [ \fB\-i\fP \fIseconds\fP ] [ \fB\-j\fP ] [ \fB\-n\fP \fIrepeat\-count\fP ] [ \fB\-q\fP ] [ \fB\-t\fP ] [ \fB\-v ]\fP \fIprinter\-uri\fP \fItestfile\fP [ ... \fItestfile\fP ] .SH DESCRIÇÃO \fBipptool\fP envia pedidos IPP para o \fIprinter\-uri\fP especificado e testa e/ou mostra os resultados. Cada \fItestfile\fP 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 \fItestfile\fP está descrito em \fBipptoolfile\fP(5). .SH OPÇÕES As seguintes opções são reconhecidas pelo \fBipptool:\fP .TP 5 \fB\-\-help\fP Mostra ajuda do programa. .TP 5 \fB\-\-ippserver \fP\fIfilename\fP Especifica que os resultados de teste devem ser escritos no ficheiro de atributos do \fBippserver\fP nomeado. .TP 5 \fB\-\-stop\-after\-include\-error\fP Diz ao \fBipptool\fP para parar se ocorrer um erro num ficheiro incluído. Normalmente o \fBipptool\fP irá continuar com testes subsequentes após a directiva INCLUDE. .TP 5 \fB\-\-version\fP Mostra a versão do \fBipptool\fP a ser usado. .TP 5 \fB\-4\fP Especifica que o \fBipptool\fP deve ligar à impressora ou servidor usando IPv4. .TP 5 \fB\-6\fP Especifica que o \fBipptool\fP deve ligar à impressora ou servidor usando IPv6. .TP 5 \fB\-C\fP 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. .TP 5 \fB\-E\fP Força encriptação TLS ao ligar ao servidor usando o cabeçalho HTTP "Upgrade". .TP 5 \fB\-I\fP Especifica que o \fBipptool\fP irá continuar após erros. .TP 5 \fB\-L\fP 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. .TP 5 \fB\-P\fP\fI\ filename.plist\fP Especifica que os resultados de teste devem ser escritos no ficheiro XML nomeado (Apple plist) adicionalmente ao relatório de teste regular (\fB\-t\fP). Esta opção é incompatível com as opções \fB\-i\fP (intervalo) e \fB\-n\fP (contagem\-de\-repetição). .TP 5 \fB\-S\fP Força encriptação TLS (dedicada) ao ligar ao servidor. .TP 5 \fB\-T\fP\fI\ seconds\fP Especifica o tempo limite para pedidos IPP em segundos\- .TP 5 \fB\-V\fP\fI\ version\fP 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. .TP 5 \fB\-X\fP 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 \fB\-i\fP (intervalo) e \fB\-n\fP (contagem\-de\-repetição). .TP 5 \fB\-c\fP Especifica que é desejado resultado em CSV (valores separados\-por\-vírgula) em vez de resultado em texto simples. .TP 5 \fB\-d\fP\fI\ name=value\fP Define a variável nomeada. .TP 5 \fB\-f\fP\fI\ filename\fP Define o nome de ficheiro de pedido predefinido para testes. .TP 5 \fB\-h\fP Valida cabeçalhos de resposta HTTP. .TP 5 \fB\-i\fP\fI\ seconds\fP Especifica que o (último) \fItestfile\fP deve ser repetido no intervalo especificado. Esta opção é incompatível com a opção \fB\-X\fP (resultado em XML plist). .TP 5 \fB\-j\fP Especifica que o \fBipptool\fP irá produzir resultados JSON. .TP 5 \fB\-l\fP Especifica que é desejado resultados em texto simples. .TP 5 \fB\-n\fP\fI\ repeat\-count\fP Especifica que o (último) \fItestfile\fP deve ser repetido o número de vezes especificado Esta opção é incompatível com a opção \fI\-X\fP (resultado em XML plist). .TP 5 \fB\-q\fP Fica calado e não produz nenhuma saída. .TP 5 \fB\-t\fP Especifica que é desejado resultado de teste do CUPS em vez de resultado em texto simples. .TP 5 \fB\-v\fP Especifica que todos os atributos de pedido e resposta devem estar em saída de modo de teste do CUPS (\fB\-t\fP). Esta é a predefinição para saída XML. .SH "ESTADO DE SAÍDA" O programa \fBipptool\fP retorna 0 se todos os testes tiverem sucesso e 1 caso contrário. .SH FICHEIROS Os seguintes ficheiros standard estão disponíveis: .nf 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 .fi .SH "DE ACORDO COM" O programa \fBipptool\fP é único do CUPS e está em conformidade com Internet Printing Protocol até à versão 2.2. .SH EXEMPLOS Obter uma lista de trabalhos completados para "myprinter": .nf ipptool ipp://localhost/printers/myprinter get\-completed\-jobs.test .fi .LP Enviar notificações por email para "user@example.com" quando "myprinter" mudar: .nf ipptool \-d recipient=mailto:user@example.com \e ipp://localhost/printers/myprinter create\-printer\-subscription.test .fi .SH "VEJA TAMBÉM" \fBipptoolfile\fP(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), .SH COPYRIGHT Copyright \[co] 2021\-2023 by OpenPrinting.