.\" .\" ipptoolfile man page. .\" .\" Copyright © 2021-2023 by OpenPrinting. .\" Copyright © 2010-2021 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 ipptoolfile 5 CUPS 2021\-09\-20 OpenPrinting .SH NOME ipptoolfile \- formato de ficheiro do ipptool .SH DESCRIÇÃO O programa \fBipptool\fP(1) aceita ficheiros de texto simples de formato livre que descrevem um ou mais pedidos IPP. Os comentários começam com o caractere "#" e continuam até ao fim da linha. Cada pedido fica rodeado por chavetas, por exemplo: .nf # This is a comment { # The name of the test NAME "Print PDF File" # The request to send OPERATION Print\-Job GROUP operation\-attributes\-tag ATTR charset attributes\-charset utf\-8 ATTR language attributes\-natural\-language en ATTR uri printer\-uri $uri ATTR name requesting\-user\-name $user ATTR mimeMediaType document\-format application/pdf GROUP job\-attributes\-tag ATTR collection media\-col { # US Letter plain paper from the "main" tray MEMBER collection media\-size { MEMBER integer x\-dimension 21590 MEMBER integer y\-dimension 27940 } MEMBER integer media\-top\-margin 423 MEMBER integer media\-bottom\-margin 423 MEMBER integer media\-left\-margin 423 MEMBER integer media\-right\-margin 423 MEMBER keyword media\-source "main" MEMBER keyword media\-type "stationery" } FILE testfile.pdf # The response to expect STATUS successful\-ok EXPECT job\-id OF\-TYPE integer WITH\-VALUE >0 EXPECT job\-uri OF\-TYPE uri } { # The name of the test NAME "Wait for Job to Complete" # The request to send OPERATION Get\-Job\-Attributes GROUP operation\-attributes\-tag ATTR charset attributes\-charset utf\-8 ATTR language attributes\-natural\-language en ATTR uri printer\-uri $uri ATTR integer job\-id $job\-id ATTR name requesting\-user\-name $user # The response to expect STATUS successful\-ok EXPECT job\-id OF\-TYPE integer WITH\-VALUE $job\-id EXPECT job\-uri OF\-TYPE uri EXPECT job\-state OF\-TYPE enum WITH\-VALUE >5 REPEAT\-NO\-MATCH EXPECT job\-originating\-user\-name OF\-TYPE name WITH\-VALUE "$user" # Show the job state until completed... DISPLAY job\-state DISPLAY job\-state\-reasons } .fi .SS "DIRECTIVAS DE NÍVEL DE TOPO" As seguintes directivas podem ser usadas fora de um \fItest\fP: .TP 5 \fB{ \fP\fItest \fP\fB}\fP Define um teste. .TP 5 \fBDEFINE \fP\fIvariable\-name value\fP Define a variável nomeada para o valor fornecido. Isto é o equivalente a especificar \fI\-d variable\-name=value\fP na linha de comandos do \fBipptool\fP(8). .TP 5 \fBDEFINE\-DEFAULT \fP\fIvariable\-name value\fP Define a variável nomeada para o valor fornecido se esta não tiver já um valor. .TP 5 \fBFILE\-ID "\fP\fIidentifier\fP\fB"\fP Especifica uma string identificadora para o ficheiro actual. .TP 5 \fBIGNORE\-ERRORS yes\fP .TP 5 \fBIGNORE\-ERRORS no\fP Especifica se, por predefinição o \fBipptool\fP(8) irá ignorar os errors e continuar com os testes subsequentes.. .TP 5 \fBINCLUDE "\fP\fIfilename\fP\fB"\fP .TP 5 \fBINCLUDE <\fP\fIfilename\fP\fB>\fP Inclui outro ficheiro de teste. A primeira forma inclui um ficheiro relativo ao ficheiro de teste actual, enquanto a segunda forma inclui um ficheiro do directório de inclusão do \fBipptool\fP(8). .TP 5 \fBINCLUDE\-IF\-DEFINED \fP\fIname \fP\fB"\fP\fIfilename\fP\fB"\fP .TP 5 \fBINCLUDE\-IF\-DEFINED \fP\fIname \fP\fB<\fP\fIfilename\fP\fB>\fP Inclui outro ficheiro de teste se a variável nomeada estiver definida. A primeira forma inclui um ficheiro relativo ao ficheiro de teste actual, enquanto a segunda forma inclui um ficheiro do directório de inclusão do \fBipptool\fP(8). .TP 5 \fBINCLUDE\-IF\-NOT\-DEFINED \fP\fIname \fP\fB"\fP\fIfilename\fP\fB"\fP .TP 5 \fBINCLUDE\-IF\-NOT\-DEFINED \fP\fIname \fP\fB<\fP\fIfilename\fP\fB>\fP Inclui outro ficheiro de teste se a variável nomeada não estiver definida. A primeira forma inclui um ficheiro relativo ao ficheiro de teste actual, enquanto a segunda forma inclui um ficheiro do directório de inclusão do \fBipptool\fP(8). .TP 5 \fBSKIP\-IF\-DEFINED \fP\fIvariable\-name\fP .TP 5 \fBSKIP\-IF\-NOT\-DEFINED \fP\fIvariable\-name\fP Especifica que o lembrete do ficheiro de teste deve ser saltado quando a variável está ou não está definida. .TP 5 \fBSTOP\-AFTER\-INCLUDE\-ERROR no\fP .TP 5 \fBSTOP\-AFTER\-INCLUDE\-ERROR yes\fP especifica se os testes devem ser parados após um erro num ficheiro incluído. .TP 5 \fBTRANSFER auto\fP Especifica que os teste irão, por predefinição, usar "Transfer\-Encoding: chunked" para pedidos com ficheiro anexados e "Content\-Length:" para pedidos sem ficheiros anexados. .TP 5 \fBTRANSFER chunked\fP Especifica que os teste irão, por predefinição, usar o cabeçalho "Transfer\-Encoding: chunked" de HTTP/1.1. Esta é a predefinição e é equivalente a especificar \fI\-c\fP na linha de comandos do \fBipptool\fP(8). O suporte para pedidos chunked é necessário para conformidade com todas as versões de IPP. .TP 5 \fBTRANSFER length\fP Especifica que os teste irão, por predefinição, usar o cabeçalho "Content\-Length:" de HTTP/1.0. Isto é equivalente a especificar \fI\-l\fP na linha de comandos do \fBipptool\fP(8). O suporte para pedidos content length é necessário para conformidade com todas as versões de IPP. .TP 5 \fBVERSION 1.0\fP .TP 5 \fBVERSION 1.1\fP .TP 5 \fBVERSION 2.0\fP .TP 5 \fBVERSION 2.1\fP .TP 5 \fBVERSION 2.2\fP Especifica o número de versão IPP predefinido a usar para os testes que se seguem: .SS "DIRECTIVAS DE TESTE" As seguintes directivas são compreendidas dentro de um \fItest\fP: .TP 5 \fBATTR \fP\fIout\-of\-band\-tag attribute\-name\fP .TP 5 \fBATTR \fP\fItag attribute\-name value(s)\fP Adiciona um atributo ao pedido de teste. Etiquetas fora\-de\-banda (admin\-define, delete\-attribute, no\-value, not\-settable, unknown, unsupported) não têm valor. Os valores para outras etiquetas são delimitados pelo caractere vírgula (",") \- vírgulas escapadas usando o caractere "\e". Atributos e valores comuns estão listados no registro IANA IPP \- veja referências em baixo. .TP 5 \fBATTR collection \fP\fIattribute\-name \fP\fB{ MEMBER \fP\fItag member\-name value(s) ... \fP\fB}\fP [ \fI... \fP\fB,{ \fP\fI... \fP\fB} \fP] Adiciona um atributo de coleção ao pedido de teste. Atributos de membro seguem a mesma sintaxe que os atributos regulares e podem eles próprios serem coleções aninhadas. Podem ser fornecidos quando necessário múltiplos valores de coleção separados por vírgulas. .TP 5 \fBCOMPRESSION deflate\fP .TP 5 \fBCOMPRESSION gzip\fP .TP 5 \fBCOMPRESSION none\fP Usa a compressão especificada nos dados do documento seguindo os atributos num pedido Print\-Job ou Send\-Document. .TP 5 \fBDELAY \fP\fIseconds\fP[\fI,repeat\-seconds\fP] Specifies a delay in seconds before this test will be run. If two values are specified, the second value is used as the delay between repeated tests. A default repeat interval of 5 seconds is used if this directive is not provided. .TP 5 \fBDISPLAY \fP\fIattribute\-name\fP Especifica que o valor do atributo nomeado deve fazer parte do resultado do relatório de teste. .TP 5 \fBEXPECT \fP\fIattribute\-name \fP[ \fIpredicate(s) \fP] .TP 5 \fBEXPECT ?\fP\fIattribute\-name predicate(s)\fP .TP 5 \fBEXPECT !\fP\fIattribute\-name\fP Especifica que a resposta deve/pode/deve não inclui o atributo nomeado. Requerimentos adicionais podem ser adicionados como predicados \- veja a secção "PREDICADOS DE EXPECT" para mais informação sobre predicados. Os nomes de atributos podem especificar atributos membros ao separar os nomes de atributo e membro com a barra inclinada para frente, por exemplo "media\-col/media\-size/x\-dimension". .TP 5 \fBEXPECT\-ALL \fP\fIattribute\-name \fP[ \fIpredicate(s) \fP] .TP 5 \fBEXPECT\-ALL ?\fP\fIattribute\-name predicate(s)\fP Especifica que a resposta deve/pode incluir o atributo nomeado e que todas as ocorrências desse atributo têm de corresponder aos predicados fornecidos. .TP 5 \fBFILE filename\fP Especifica um ficheiro a incluir no final do pedido. Isto é usado tipicamente quando se envia um ficheiro de impressão de teste. .TP 5 \fBGROUP tag\fP Especifica a etiqueta de grupo para atributos subsequentes no pedido. .TP 5 \fBIGNORE\-ERRORS yes\fP .TP 5 \fBIGNORE\-ERRORS no\fP Especifica se o \fBipptool\fP(8) irá ignorar erros e continuar com os testes subsequentes. .TP 5 \fBMONITOR\-PRINTER\-STATE \fP[ \fIprinter\-uri \fP] \fB{ EXPECT \fP\fIattribute\-name \fP[ \fIpredicate(s) \fP] \fB}\fP Especifica os testes de monitorização do estado da impressora a a correr em paralelo com a operação de teste. Os testes de monitorização irão correr até que todas as condições \fBEXPECT\fP estejam satisfeitas ou que a operação de teste principal seja completa, o que ocorrer primeiro. .TP 5 \fBNAME "\fP\fIliteral string\fP\fB"\fP Especifica o nome humanamente\-legível do teste. .TP 5 \fBOPERATION \fP\fIoperation\-code\fP Especifica a operação a ser executada. .TP 5 \fBPASS\-IF\-DEFINED \fP\fIvariable\-name\fP .TP 5 \fBPASS\-IF\-NOT\-DEFINED \fP\fIvariable\-name\fP Especifica que o teste actual deve ser passado automaticamente quando a variável está ou não está definida. .TP 5 \fBPAUSE "\fP\fImessage\fP\fB"\fP Mostra a mensagem fornecida e espera que o utilizador carregue numa tecla para continuar. .TP 5 \fBREQUEST\-ID \fP\fInumber\fP .TP 5 \fBREQUEST\-ID random\fP Especifica o valor request\-id a usar no pedido, seja um número inteiro ou a palavra "random" para usar um valor gerado aleatoriamente (a predefinição). .TP 5 \fBRESOURCE \fP\fIpath\fP Especifica um caminho de recurso alternativo que é usado para o pedido HTTP POST. A predefinição é o recurso do URI fornecido ao programa \fBipptool\fP(8). .TP 5 \fBSKIP\-IF\-DEFINED \fP\fIvariable\-name\fP .TP 5 \fBSKIP\-IF\-NOT\-DEFINED \fP\fIvariable\-name\fP Especifica que o teste actual deve ser saltado quando a variável está ou não está definida. .TP 5 \fBSKIP\-PREVIOUS\-ERROR yes\fP .TP 5 \fBSKIP\-PREVIOUS\-ERROR no\fP Especifica se o \fBipptool\fP(8) irá saltar o teste actual se o teste anterior resultou em erro/falha. .TP 5 \fBSTATUS \fP\fIstatus\-code \fP[ \fIpredicate\fP ] Especifica um valor de código\-de\-estado da resposta esperada. Requerimentos adicionais podem ser adicionados como predicados \- veja a secção "PREDICADOS DE ESTADO" para mais informação sobre predicados. .TP 5 \fBTEST\-ID "\fP\fIidentifier\fP" Especifica uma string de identificação para o teste actual. .TP 5 \fBTRANSFER auto\fP Especifica que este teste irá usar "Transfer\-Encoding: chunked" se tiver um ficheiro anexado ou "Content\-Length:" caso contrário. .TP 5 \fBTRANSFER chunked\fP Especifica que este teste irá usar o cabeçalho HTTP/1.1 "Transfer\-Encoding: chunked". .TP 5 \fBTRANSFER length\fP Especifica que este teste irá usar o cabeçalho HTTP/1.0 "Content\-Length:". .TP 5 \fBVERSION 1.0\fP .TP 5 \fBVERSION 1.1\fP .TP 5 \fBVERSION 2.0\fP .TP 5 \fBVERSION 2.1\fP .TP 5 \fBVERSION 2.2\fP Especifica o número de versão IPP a usar para este teste. .SS "PREDICADOS DE EXPECT" Os seguintes predicados são compreendidos pela directiva de teste \fBEXPECT\fP: .TP 5 \fBCOUNT \fP\fInumber\fP Requer que o atributo \fBEXPECT\fP tenha um número especificado de valores. .TP 5 \fBDEFINE\-MATCH \fP\fIvariable\-name\fP Define a variável para "1" quando a condição \fBEXPECT\fP corresponde. Um efeito secundário deste predicado é que \fBEXPECT\fP nunca irá falhar um teste. .TP 5 \fBDEFINE\-NO\-MATCH \fP\fIvariable\-name\fP Define a variável para "1" quando a condição \fBEXPECT\fP não corresponde. Um efeito secundário deste predicado é que \fBEXPECT\fP nunca irá falhar um teste. .TP 5 \fBDEFINE\-VALUE \fP\fIvariable\-name\fP Define a variável para o valor do atributo quando a condição \fBEXPECT\fP corresponde. Um efeito secundário deste predicado é que \fBEXPECT\fP nunca irá falhar um teste. .TP 5 \fBDISPLAY\-MATCH \fP\fI"message"\fP Mostra a mensagem especificada quando a condição \fBEXPECT\fP corresponde. .TP 5 \fBIF\-DEFINED \fP\fIvariable\-name\fP Faz com que as condições \fBEXPECT\fP sejam aplicadas apenas se a variável especificada esteja definida. .TP 5 \fBIF\-NOT\-DEFINED \fP\fIvariable\-name\fP Faz com que as condições \fBEXPECT\fP sejam aplicadas apenas se a variável especificada não esteja definida. .TP 5 \fBIN\-GROUP \fP\fItag\fP Requer que o atributo \fBEXPECT\fP esteja na etiqueta do grupo especificado. .TP 5 \fBOF\-TYPE \fP\fItag[(limits)|tag|...]\fP Requer que o atributo \fBEXPECT\fP use uma das etiquetas de valor especificadas. A maioria das etiquetas de valor também suportam a especificação de limites em parênteses, por exemplo "name(42)" iria permitir strings nameWith/WithoutLanguage até 42 octetos em comprimento, "name(4:MAX)" iria permitir strings nameWith/WithoutLanguage entre 4 e 255 octetos em comprimento, e "integer(\-273:MAX)" iria permitir inteiros entre \-273 e 2147483647. .TP 5 \fBREPEAT\-LIMIT \fP\fInumber\fP .br Especifica o número máximo de vezes a repetir se o predicado \fBREPEAT\-MATCH\fP ou \fBREPEAT\-NO\-MATCH\fP for especificado. O valor predefinido é 1000. .TP 5 \fBREPEAT\-MATCH\fP .TP 5 \fBREPEAT\-NO\-MATCH\fP Especifica que o teste actual deve ser repetido quando a condição \fBEXPECT\fP corresponda ou não corresponda. .TP 5 \fBSAME\-COUNT\-AS \fP\fIattribute\-name\fP Requer que o atributo \fBEXPECT\fP tenha o mesmo número de valores que o atributo paralelo especificado. .TP 5 \fBWITH\-ALL\-HOSTNAMES "\fP\fIliteral string\fP\fB"\fP .TP 5 \fBWITH\-ALL\-HOSTNAMES "/\fP\fIregular expression\fP\fB/"\fP Requer que todos os valores URI contenham um nome\-de\-máquina correspondente. .TP 5 \fBWITH\-ALL\-RESOURCES "\fP\fIliteral string\fP\fB"\fP .TP 5 \fBWITH\-ALL\-RESOURCES "/\fP\fIregular expression\fP\fB/"\fP Requer que todos os valores URI contenham um recurso correspondente (incluindo / inicial). .TP 5 \fBWITH\-ALL\-SCHEMES "\fP\fIliteral string\fP\fB"\fP .TP 5 \fBWITH\-ALL\-SCHEMES "/\fP\fIregular expression\fP\fB/"\fP Requer que todos os valores URI contenham um esquema correspondente. .TP 5 \fBWITH\-ALL\-VALUES "\fP\fIliteral string\fP\fB"\fP Requer que todos os valores do atributo \fBEXPECT\fP correspondam literalmente à string. As comparações são sensíveis a maiúsculas/minúsculas. .TP 5 \fBWITH\-ALL\-VALUES <\fP\fInumber\fP .TP 5 \fBWITH\-ALL\-VALUES =\fP\fInumber\fP .TP 5 \fBWITH\-ALL\-VALUES >\fP\fInumber\fP .TP 5 \fBWITH\-ALL\-VALUES \fP\fInumber\fP[\fI,...,number\fP] Requer que todos os valores do atributo \fBEXPECT\fP correspondam aos número(s) ou comparação numérica. Ao comparar valores rangeOfInteger, os operadores "<" e ">" apenas verificam o limite superior do alcance. .TP 5 \fBWITH\-ALL\-VALUES "false"\fP .TP 5 \fBWITH\-ALL\-VALUES "true"\fP Requer que todos os valores do atributo \fBEXPECT\fP correspondam ao valor booleano dado. .TP 5 \fBWITH\-ALL\-VALUES "/\fP\fIregular expression\fP\fB/"\fP Requer que todos os valores do atributo \fBEXPECT\fP correspondam à expressão regular, a qual tem de estar em conformidade com a sintaxe de expressões regulares do POSIX. As comparações são sensíveis a maiúsculas/minúsculas. .TP 5 \fBWITH\-DISTINCT\-VALUES\fP Requer que todos os valores do atributo \fBEXPECT\fP sejam únicos. As comparações são sensíveis a maiúsculas/minúsculas. Apenas os atributos charset, collection, enum, integer, keyword, mimeMediaType, naturalLanguage, rangeOfInteger, resolution, uriScheme suportam este predicado. .TP 5 \fBWITH\-HOSTNAME "\fP\fIliteral string\fP\fB"\fP .TP 5 \fBWITH\-HOSTNAME "/\fP\fIregular expression\fP\fB/"\fP Requer que pelo menos um dos valores URI contenha um nome\-de\-máquina correspondente. .TP 5 \fBWITH\-RESOURCE "\fP\fIliteral string\fP\fB"\fP .TP 5 \fBWITH\-RESOURCE "/\fP\fIregular expression\fP\fB/"\fP Requer que pelo menos um dos valores URI contenha um recurso correspondente (incluindo / inicial). .TP 5 \fBWITH\-SCHEME "\fP\fIliteral string\fP\fB"\fP .TP 5 \fBWITH\-SCHEME "/\fP\fIregular expression\fP\fB/"\fP Requer que pelo menos um dos valores URI contenha um esquema correspondente. .TP 5 \fBWITH\-VALUE "\fP\fIliteral string\fP\fB"\fP Requer que pelo menos um dos valores do atributo \fBEXPECT\fP corresponda literalmente à string. As comparações são sensíveis a maiúsculas/minúsculas. .TP 5 \fBWITH\-VALUE <\fP\fInumber\fP .TP 5 \fBWITH\-VALUE =\fP\fInumber\fP .TP 5 \fBWITH\-VALUE >\fP\fInumber\fP .TP 5 \fBWITH\-VALUE \fP\fInumber\fP[\fI,...,number\fP] Requer que pelo menos um valor do atributo \fBEXPECT\fP corresponda aos número(s) ou comparação numérica. Ao comparar valores rangeOfInteger, os operadores "<" e ">" apenas verificam o limite superior do alcance. .TP 5 \fBWITH\-VALUE "false"\fP .TP 5 \fBWITH\-VALUE "true"\fP Requer que pelo menos um dos valores do atributo \fBEXPECT\fP corresponda ao valor booleano dado. .TP 5 \fBWITH\-VALUE "/\fP\fIregular expression\fP\fB/"\fP Requer que pelo menos um dos valores do atributo \fBEXPECT\fP corresponda à expressão regular, a qual tem de estar em conformidade com a sintaxe de expressões regulares do POSIX. As comparações são sensíveis a maiúsculas/minúsculas. .TP 5 \fBWITH\-VALUE\-FROM \fP\fIattribute\-name\fP Requer que os valor(es) do atributo \fBEXPECT\fP correspondam aos valor(es) no atributo especificado. Por exemplo, "EXPECT job\-sheets WITH\-VALUE\-FROM job\-sheets\-supported" requer que o valor "job\-sheets" esteja listado como um valor do atributo "job\-sheets\-supported". .SS "PREDICADOS DE ESTADOS" Os seguintes predicados são compreendidos pela directiva de teste \fBSTATUS\fP: .TP 5 \fBDEFINE\-MATCH \fP\fIvariable\-name\fP Define a variável para "1" quando \fBSTATUS\fP corresponde. Um efeito secundário deste predicado é que este \fBSTATUS\fP nunca irá falhar um teste. .TP 5 \fBDEFINE\-NO\-MATCH \fP\fIvariable\-name\fP Define a variável para "1" quando \fBSTATUS\fP não corresponde. Um efeito secundário deste predicado é que este \fBSTATUS\fP nunca irá falhar um teste. .TP 5 \fBIF\-DEFINED \fP\fIvariable\-name\fP Faz com que \fBSTATUS\fP seja aplicado apenas se a variável especificada estiver definida. .TP 5 \fBIF\-NOT\-DEFINED \fP\fIvariable\-name\fP Faz com que \fBSTATUS\fP seja aplicado apenas se a variável especificada não estiver definida. .TP 5 \fBREPEAT\-LIMIT \fP\fInumber\fP .br Especifica o número máximo de vezes a repetir. O valor predefinido é 1000. .TP 5 \fBREPEAT\-MATCH\fP .TP 5 \fBREPEAT\-NO\-MATCH\fP Especifica que o teste actual deve ser repetido quando a resposta do código de estado corresponde ou não corresponde ao valor especificado pela directiva STATUS. .SS "CÓDIGOS DE OPERAÇÃO" Códigos de operação correspondem aos números hexadecimais (0xHHHH) e nomes de RFC 8011 e outras especificações da extensão IPP. Aqui está uma lista completa dos nomes suportados pelo \fBipptool\fP(8): .nf Acknowledge\-Document Acknowledge\-Identify\-Printer Acknowledge\-Job Activate\-Printer Add\-Document\-Images Allocate\-Printer\-Resources Cancel\-Current\-Job Cancel\-Job Cancel\-Jobs Cancel\-My\-Jobs Cancel\-Resource Cancel\-Subscription Close\-Job Create\-Job Create\-Job\-Subscriptions Create\-Printer Create\-Printer\-Subscriptions Create\-Resource Create\-Resource\-Subscriptions Create\-System\-Subscriptions CUPS\-Accept\-Jobs CUPS\-Accept\-Jobs CUPS\-Add\-Modify\-Class CUPS\-Add\-Modify\-Printer CUPS\-Authenticate\-Job CUPS\-Create\-Local\-Printer CUPS\-Delete\-Class CUPS\-Delete\-Printer CUPS\-Get\-Classes CUPS\-Get\-Default CUPS\-Get\-Devices CUPS\-Get\-Document CUPS\-Get\-PPD CUPS\-Get\-PPDs CUPS\-Get\-Printers CUPS\-Move\-Job CUPS\-Reject\-Jobs CUPS\-Set\-Default Deactivate\-Printer Deallocate\-Printer\-Resources Delete\-Printer Deregister\-Output\-Device Disable\-All\-Printers Disable\-Printer Enable\-All\-Printers Enable\-Printer Fetch\-Document Fetch\-Job Get\-Job\-Attributes Get\-Jobs Get\-Next\-Document\-Data Get\-Notifications Get\-Output\-Device\-Attributes Get\-Printer\-Attributes Get\-Printer\-Support\-Files Get\-Printer\-Supported\-Values Get\-Printers Get\-Subscription\-Attributes Get\-Subscriptions Get\-System\-Attributes Get\-System\-Supported\-Values Hold\-Job Hold\-New\-Jobs Identify\-Printer Install\-Resource Pause\-All\-Printers Pause\-All\-Printers\-After\-Current\-Job Pause\-Printer Pause\-Printer\-After\-Current\-Job Print\-Job Print\-URI Promote\-Job Purge\-Jobs Register\-Output\-Device Release\-Held\-New\-Jobs Release\-Job Renew\-Subscription Reprocess\-Job Restart\-Job Restart\-Printer Restart\-System Resubmit\-Job Resume\-All\-Printers Resume\-Job Resume\-Printer Schedule\-Job\-After Send\-Document Send\-Hardcopy\-Document Send\-Notifications Send\-Resource\-Data Send\-URI Set\-Job\-Attributes Set\-Printer\-Attributes Set\-Resource\-Attributes Set\-System\-Attributes Shutdown\-All\-Printers Shutdown\-One\-Printer Shutdown\-Printer Startup\-All\-Printers Startup\-One\-Printer Startup\-Printer Suspend\-Current\-Job Update\-Active\-Jobs Update\-Document\-Status Update\-Job\-Status Update\-Output\-Device\-Attributes Validate\-Document Validate\-Job .fi .SS "CÓDIGOS DE ESTADO" Códigos de estado correspondem aos números hexadecimais (0xHHHH) e nomes de RFC 8011 e outras especificações da extensão IPP. Aqui está uma lista completa dos nomes suportados pelo \fBipptool\fP(8): .nf client\-error\-account\-authorization\-failed client\-error\-account\-closed client\-error\-account\-info\-needed client\-error\-account\-limit\-reached client\-error\-attributes\-not\-settable client\-error\-attributes\-or\-values\-not\-supported client\-error\-bad\-request client\-error\-charset\-not\-supported client\-error\-compression\-error client\-error\-compression\-not\-supported client\-error\-conflicting\-attributes client\-error\-document\-access\-error client\-error\-document\-format\-error client\-error\-document\-format\-not\-supported client\-error\-document\-password\-error client\-error\-document\-permission\-error client\-error\-document\-security\-error client\-error\-document\-unprintable\-error client\-error\-forbidden client\-error\-gone client\-error\-ignored\-all\-notifications client\-error\-ignored\-all\-subscriptions client\-error\-not\-authenticated client\-error\-not\-authorized client\-error\-not\-fetchable client\-error\-not\-found client\-error\-not\-possible client\-error\-print\-support\-file\-not\-found client\-error\-request\-entity\-too\-large client\-error\-request\-value\-too\-long client\-error\-timeout client\-error\-too\-many\-subscriptions client\-error\-uri\-scheme\-not\-supported cups\-error\-account\-authorization\-failed cups\-error\-account\-closed cups\-error\-account\-info\-needed cups\-error\-account\-limit\-reached cups\-see\-other redirection\-other\-site server\-error\-busy server\-error\-device\-error server\-error\-internal\-error server\-error\-job\-canceled server\-error\-multiple\-document\-jobs\-not\-supported server\-error\-not\-accepting\-jobs server\-error\-operation\-not\-supported server\-error\-printer\-is\-deactivated server\-error\-service\-unavailable server\-error\-temporary\-error server\-error\-version\-not\-supported successful\-ok successful\-ok\-but\-cancel\-subscription successful\-ok\-conflicting\-attributes successful\-ok\-events\-complete successful\-ok\-ignored\-notifications successful\-ok\-ignored\-or\-substituted\-attributes successful\-ok\-ignored\-subscriptions successful\-ok\-too\-many\-events .fi .SS ETIQUETAS Etiquetas de valor e grupo correspondem aos nomes de RFC 8011 e outras especificações da extensão IPP. Aqui estão as etiquetas de grupo: .nf document\-attributes\-tag event\-notification\-attributes\-tag job | job\-attributes\-tag operation | operation\-attributes\-tag printer | printer\-attributes\-tag resource\-attributes\-tag subscription\-attributes\-tag system\-attributes\-tag unsupported\-attributes\-tag .fi .LP Aqui estão as etiquetas de valor: .nf admin\-define boolean charset collection | begCollection dateTime default delete\-attribute enum integer keyword language | naturalLanguage mimetype | mimeMediaType name | nameWithLanguage | nameWithoutLanguage no\-value not\-settable octetString rangeOfInteger resolution text | textWithLanguage | textWithoutLanguage unknown unsupported uri uriScheme .fi .SS VARIÁVEIS O programa \fBipptool\fP(8) mantém uma lista de variáveis que podem ser usadas em qualquer string literal ou valor de atributo ao especificar "\fI$variable\-name\fP". à parte das variáveis definidas usando a opção \fI\-d\fP ou a directiva \fBDEFINE\fP, as seguintes variáveis pré\-definidas estão disponíveis: .TP 5 \fB$$\fP Insere um único caractere "$". .TP 5 \fB$ENV[\fP\fIname\fP\fB]\fP Insere o valor da variável de ambiente nomeada, ou uma string vazia se a variável de ambiente não estiver definida. .TP 5 \fB$date\-current\fP Insere a data e hora actuais usando o formato ISO\-8601 ("yyyy\-mm\-ddThh:mm:ssZ"). .TP 5 \fB$date\-start\fP Insere a data e hora iniciais usando o formato ISO\-8601 ("yyyy\-mm\-ddThh:mm:ssZ"). .TP 5 \fB$filename\fP Insere o nome de ficheiro fornecido ao \fBipptool\fP(8) com a opção \fI\-f\fP. .TP 5 \fB$filetype\fP Insere o tipo de media MIME para o nome de ficheiro fornecido ao \fBipptool\fP(8) com a opção \fI\-f\fP. .TP 5 \fB$hostname\fP Insere o nome\-de\-máquina a partir do URI fornecido ao \fBipptool\fP(8). .TP 5 \fB$job\-id\fP Insere último valor do atributo "job\-id" retornado numa resposta de teste ou 0 se nenhum atributo "job\-id" foi visto. .TP 5 \fB$job\-uri\fP Insere último valor do atributo "job\-uri" retornado numa resposta de teste ou uma string vazia se nenhum atributo "job\-uri" foi visto. .TP 5 \fB$notify\-subscription\-id\fP Insere último valor do atributo "notify\-subscription\-id" retornado numa resposta de teste ou 0 se nenhum atributo "notify\-subscription\-id" foi visto. .TP 5 \fB$port\fP Insere o número de porto a partir do URI fornecido ao \fBipptool\fP(8). .TP 5 \fB$resource\fP Inserts the resource path from the URI provided to \fBipptool\fP(8). .TP 5 \fB$scheme\fP Insere o esquema a partir do URI fornecido ao \fBipptool\fP(8). .TP 5 \fB$uri\fP Insere o URI fornecido para \fBipptool\fP(8). .TP 5 \fB$uriuser\fP Insere o nome\-de\-utilizador a partir do URI fornecido ao \fBipptool\fP(8). Se algum. .TP 5 \fB$user\fP Insere o nome de login do utilizador actual. .SH "VEJA TAMBÉM" \fBipptool\fP(1), 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.