Man page - ipptoolfile(5)
Packages contains this manual
apt-get install cups-ipp-utils
Available languages:
en fr pt deManual
ipptoolfile
NOMDESCRIPTION
DIRECTIVES PRINCIPALES
DIRECTIVES DE TEST
PRĂDICATS EXPECT
PRĂDICATS STATUS
CODES DâOPĂRATION
CODES DâĂTAT
ĂTIQUETTES
VARIABLES
VOIR AUSSI
COPYRIGHT
NOM
ipptoolfile - Format de fichier ipptool
DESCRIPTION
Le programme ipptool (1) accepte les fichiers, sans format particulier en texte pur, qui dĂ©crivent une ou plusieurs requĂȘtes IPP. Les commentaires commencent par le caractĂšre « # » et se terminent Ă la fin de la ligne. Chaque requĂȘte est entourĂ©e par des accolades, par exemple :
# Ceci est un
commentaire
{
# Le nom du test
NAME « Fichier dâimpression
PDF »
# La
requĂȘte Ă envoyer
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 {
# papier ordinaire US Letter Ă partir du bac
« principal »
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
# La
réponse à attendre
STATUS successful-ok
EXPECT job-id OF-TYPE integer WITH-VALUE >0
EXPECT job-uri OF-TYPE uri
}
{
# Le nom du test
NAME "Attente de lâachĂšvement du
travail"
# La
requĂȘte Ă envoyer
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
# La
réponse à attendre
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 3,4,5,6,7,8,9
EXPECT job-originating-user-name OF-TYPE name WITH-VALUE
"$user"
# Afficher
lâĂ©tat du travail en attendant son
achĂšvement...
DISPLAY job-state
DISPLAY job-state-reasons
}
DIRECTIVES PRINCIPALES
Les directives
suivantes peuvent ĂȘtre utilisĂ©es en dehors
dâun
test
:
{
test
}
Définir un test.
DEFINE nom_variable valeur
Définir la variable dénommée à la valeur donnée. Cela est équivalent à indiquer « -d nom_variable = valeur » sur la ligne de commande de ipptool(8) .
DEFINE-DEFAULT nom_variable valeur
DĂ©finir la variable nommĂ©e Ă la valeur donnĂ©e si elle nâa pas dĂ©jĂ une valeur.
FILE-ID " identificateur "
DĂ©finir la chaĂźne dâidentificateur pour le fichier actuel.
IGNORE-ERRORS
yes
IGNORE-ERRORS
no
Indiquer si, par défaut, ipptool (8) ignorera les erreurs et poursuivra avec les tests suivants.
INCLUDE
"
nom_fichier
"
INCLUDE <
nom_fichier
>
Inclure un autre fichier de test. La premiÚre façon inclut un fichier relatif au fichier de test actuel, tandis que la seconde inclut un fichier du répertoire inclus de ipptool (8).
INCLUDE-IF-DEFINED
nom
"
nom_fichier
"
INCLUDE-IF-DEFINED
nom
<
nom_fichier
>
Inclure un autre fichier de test si la variable nommĂ©e est dĂ©finie. La premiĂšre façon inclut un fichier relatif Ă lâactuel fichier de test, tandis que la seconde inclut un fichier du rĂ©pertoire inclus de ipptool (8).
INCLUDE-IF-NOT-DEFINED
nom
"
nom_fichier
"
INCLUDE-IF-NOT-DEFINED
nom
<
nom_fichier
>
Inclure un autre fichier de test si la variable nommĂ©e nâest pas dĂ©finie. La premiĂšre façon inclut un fichier relatif Ă lâactuel fichier de test, tandis que la seconde inclut un fichier du rĂ©pertoire inclus de ipptool (8).
SKIP-IF-DEFINED
nom_variable
SKIP-IF-NOT-DEFINED
nom_variable
Indiquer que le reste du fichier de test devra ĂȘtre ignorĂ© si la variable est ou nâest pas dĂ©finie.
STOP-AFTER-INCLUDE-ERROR
no
STOP-AFTER-INCLUDE-ERROR
yes
Indiquer si les tests seront arrĂȘtĂ©s aprĂšs une erreur dans un fichier inclus
TRANSFER auto
Indiquer que ces tests utiliseront, par dĂ©faut, « Transfer-Encoding: chunked » lors de requĂȘtes avec fichiers joints et « Content-Length: » pour celles sans fichier joint.
TRANSFER chunked
Indiquer que ces tests utiliseront, par dĂ©faut, lâen-tĂȘte de HTTP/1.1 « Transfer-Encoding: chunked ». Câest le comportement par dĂ©faut et Ă©quivalent Ă indiquer -c sur la ligne de commande de ipptool (8). La prise en charge pour les requĂȘtes partielles est exigĂ©e pour conformitĂ© avec toutes les versions dâIPP.
TRANSFER taille
Indiquer que ces tests utiliseront, par dĂ©faut, lâen-tĂȘte de HTTP/1.0 « Content-Length: ». Câest Ă©quivalent Ă indiquer « -l » sur la ligne de commande de ipptool (8). La prise en charge pour les requĂȘtes sur la taille de contenu est exigĂ©e pour conformitĂ© avec toutes les versions dâIPP.
VERSION 1.0
VERSION 1.1
VERSION 2.0
VERSION 2.1
VERSION 2.2
Indiquer le numĂ©ro de version dâIPP Ă utiliser par dĂ©faut pour les tests ci-dessous.
DIRECTIVES DE TEST
Les directives
suivantes sont comprises dans un
test
:
ATTR
étiquette_hors-bande nom_attribut
ATTR
étiquette nom_attribut valeur(s)
Ajouter un attribut Ă la requĂȘte de test. Les Ă©tiquettes « hors-bande » (admin-define, delete-attribute, no-value, not-settable, unknown, unsupported) nâont pas de valeur. Les valeurs pour dâautres Ă©tiquettes sont sĂ©parĂ©es par le caractĂšre virgule (« , ») â protĂ©ger les virgules avec « \ ». Les attributs et valeurs courants sont listĂ©s dans le registre IPP dâIANA â consulter les rĂ©fĂ©rences ci-dessous.
ATTR collection
nom_attribut
{ MEMBER
étiquette
nom_membre valeur(s)
...
}
[
...
,{
...
}
]
Ajouter un attribut dâensemble Ă la requĂȘte de test. Les attributs de membre suivent la mĂȘme syntaxe que les attributs normaux et peuvent ĂȘtre eux-mĂȘmes des ensembles emboitĂ©s. Plusieurs valeurs dâensemble peuvent ĂȘtre fournies si nĂ©cessaire, sĂ©parĂ©es par des virgules.
COMPRESSION
deflate
COMPRESSION
gzip
COMPRESSION
none
Utiliser la compression indiquĂ©e pour les donnĂ©es du document qui suit les attributs dans une tĂąche dâimpression ou une requĂȘte dâenvoi de document.
DELAY secondes [ ,répétition-secondes ]
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.
DISPLAY nom_attribut
Indiquer que la valeur de lâattribut nommĂ© doit ĂȘtre affichĂ© comme faisant partie du compte-rendu de test.
EXPECT
nom_attribut
[
prédicat(s)
]
EXPECT ?
nom_attribut prédicat(s)
EXPECT !
nom_attribut
Indiquer que la rĂ©ponse doit, ou peut, ou ne doit pas inclure lâattribut nommĂ©. Des exigences supplĂ©mentaires peuvent ĂȘtre ajoutĂ©es comme prĂ©dicats â consultez la section « PRĂDICATS EXPECT » pour davantage dâinformation sur les prĂ©dicats. Les noms dâattribut peuvent indiquer les attributs des membres en sĂ©parant les noms dâattribut et de membre avec une barre oblique, par exemple, « media-col/media-size/x-dimension ».
EXPECT-ALL
nom_attribut
[
prédicat(s)
]
EXPECT-ALL ?
nom_attribut prédicat(s)
Indiquer si la rĂ©ponse doit ou peut inclure lâattribut nommĂ© et que toutes les occurrences de cet attribut doivent correspondre aux prĂ©dicats indiquĂ©s.
FILE nom_fichier
Indiquer un fichier Ă ajouter Ă la fin de la requĂȘte. Cela est habituellement utilisĂ© lors de lâenvoi dâun fichier de test dâimpression.
GROUP étiquette
Indiquer lâĂ©tiquette de groupe pour les attributs suivants dans la requĂȘte.
IGNORE-ERRORS
yes
IGNORE-ERRORS
no
Indiquer si ipptool (8) ignorera les erreurs et continuera avec les tests suivants.
MONITOR-PRINTER-STATE
[
URI_imprimante
]
{ EXPECT
nom_attribut
[
prédicat(s)
]
}
Indiquer les tests de surveillance dâĂ©tat dâimprimante Ă exĂ©cuter en parallĂšle avec lâopĂ©ration de test. Les tests de supervision seront exĂ©cutĂ©s jusquâĂ ce que toutes les conditions EXPECT soient satisfaites ou que lâopĂ©ration premiĂšre de test soit terminĂ©e, quelque soit la premiĂšre qui se prĂ©sente.
NAME " chaßne_littérale "
Décrire le nom de test de maniÚre compréhensible aux utilisateurs.
OPERATION code_opération
Indiquer les opérations à effectuer.
PASS-IF-DEFINED
nom_variable
PASS-IF-NOT-DEFINED
nom_variable
Indiquer que lâactuel test sera omis automatiquement quand la variable est ou nâest pas dĂ©finie.
PAUSE " message "
Afficher le message fourni et attendre lâappui dâune touche par lâutilisateur pour continuer.
REQUEST-ID
nombre
REQUEST-ID
aléatoire
Indiquer la valeur dâidentifiant de requĂȘte Ă utiliser dans la requĂȘte, soit un nombre entier soit le mot « random » pour utiliser une valeur calculĂ©e alĂ©atoirement (comportement par dĂ©faut).
RESOURCE chemin
Indiquer un chemin de ressource alternatif pour la requĂȘte HTTP POST. Par dĂ©faut, câest la ressource de lâURI fourni par le programme ipptool (8).
SKIP-IF-DEFINED
nom_variable
SKIP-IF-NOT-DEFINED
nom_variable
Indiquer que lâactuel test sera omis quand la variable est ou nâest pas dĂ©finie.
SKIP-PREVIOUS-ERROR
yes
SKIP-PREVIOUS-ERROR
no
Indiquer si ipptool (8) ignorera le test actuel si le test précédent se termine sur une erreur ou un succÚs.
STATUS code_état [ prédicat ]
Indiquer la valeur attendue du code dâĂ©tat de la rĂ©ponse. Des exigences supplĂ©mentaires peuvent ĂȘtre ajoutĂ©es comme prĂ©dicats â consultez la section « PREDICATS STATUS » pour davantage dâinformation sur les prĂ©dicats.
TEST-ID " identificateur "
DĂ©finir une chaĂźne dâidentificateur pour le test actuel.
TRANSFER auto
Indiquer que le test utilisera « Transfer-Encoding: chunked » si un fichier est joint ou  «Content-Length: » sinon.
TRANSFER chunked
Indiquer si le test utilisera les en-tĂȘtes HTTP 1.1 « Transfer-Encoding: chunked ».
TRANSFER taille
Indiquer que ce test utilisera les en-tĂȘtes HTTP/1.0 « Content-Length: ».
VERSION 1.0
VERSION 1.1
VERSION 2.0
VERSION 2.1
VERSION 2.2
Indiquer le numĂ©ro de version dâIPP Ă utiliser pour ce test.
PRĂDICATS EXPECT
Les
prédicats ci-dessous sont compris suivant la
directive de test
EXPECT
:
COUNT
nombre
Exiger que lâattribut dâ EXPECT ait le nombre indiquĂ© de valeurs.
DEFINE-MATCH nom_variable
DĂ©finir la variable Ă 1 quand la condition dâ EXPECT correspond. Un effet de bord de ce prĂ©dicat est que EXPECT nâĂ©chouera jamais Ă un test.
DEFINE-NO-MATCH nom_variable
DĂ©finir la variable Ă 1 quand la condition dâ EXPECT ne correspond pas. Un effet de bord de ce prĂ©dicat est que EXPECT nâĂ©chouera jamais Ă un test.
DEFINE-VALUE nom_variable
DĂ©finir la variable Ă la valeur de lâattribut quand la condition dâ EXPECT correspond. Un effet de bord de ce prĂ©dicat est que EXPECT nâĂ©chouera jamais Ă un test.
DISPLAY-MATCH "message"
Afficher le message indiqué quand la condition EXPECT correspond.
IF-DEFINED nom_variable
Appliquer les conditions dâ EXPECT seulement si la variable indiquĂ©e est dĂ©finie.
IF-NOT-DEFINED nom_variable
Appliquer les conditions dâ EXPECT seulement si la variable indiquĂ©e nâest pas dĂ©finie.
IN-GROUP étiquette
Exiger que lâattribut dâ EXPECT soit dans lâĂ©tiquette de groupe indiquĂ©e.
OF-TYPE étiquette[(limites)|étiquette|...]
Exiger que lâattribut EXPECT utilise une des Ă©tiquettes de valeur indiquĂ©es. La plupart des Ă©tiquettes de valeur gĂšrent aussi la spĂ©cification de limites entre parenthĂšses, par exemple, « name(42) » autoriserait les chaines nameWith/WithoutLanguage jusquâĂ 42 octets de longueur, « name(4:MAX) » autoriserait les chaines nameWith/WithoutLanguage entre 4 et 255 octets et « integer(-273:MAX) » autoriserait des entiers entre -273 et 147483647.
REPEAT-LIMIT nombre
Définir le nombre maximal de répétitions si le prédicat REPEAT-MATCH ou REPEAT-NO-MATCH est indiqué. La valeur par défaut est 1000 .
REPEAT-MATCH
REPEAT-NO-MATCH
Indiquer que lâactuel test doit ĂȘtre recommencĂ© si la condition EXPECT correspond ou pas.
SAME-COUNT-AS nom_attribut
Exiger que lâattribut dâ EXPECT ait le mĂȘme nombre de valeurs que lâattribut similaire indiquĂ©.
WITH-ALL-HOSTNAMES
"
chaßne_littérale
"
WITH-ALL-HOSTNAMES
"/
exp_rationnelle
/"
Exiger que toutes les valeurs dâURI contiennent un nom dâhĂŽte correspondant.
WITH-ALL-RESOURCES
"
chaßne_littérale
"
WITH-ALL-RESOURCES
"/
exp_rationnelle
/"
Exiger que toutes les valeurs dâURI contiennent une ressource correspondante y compris le « / » de dĂ©but)
WITH-ALL-SCHEMES
"
chaßne_littérale
"
WITH-ALL-SCHEMES
"/
exp_rationnelle
/"
Exiger que toutes les valeurs dâURI contiennent un schĂ©ma correspondant.
WITH-ALL-VALUES " chaßne_littérale "
Exiger que toutes les valeurs de lâattribut dâ EXPECT correspondent Ă la chaĂźne littĂ©rale. Les comparaisons sont sensibles Ă la casse.
WITH-ALL-VALUES
<
nombre
WITH-ALL-VALUES =
nombre
WITH-ALL-VALUES >
nombre
WITH-ALL-VALUES
nombre
[
,...,nombre
]
Exiger que toutes les valeurs de lâattribut dâ EXPECT correspondent au(x) nombre(s) ou Ă la comparaison numĂ©rique. Lors de la comparaison des valeurs dâintervalle de nombres entiers, les opĂ©rateurs « < » et « > » contrĂŽlent seulement la limite supĂ©rieure de lâintervalle.
WITH-ALL-VALUES
"false"
WITH-ALL-VALUES "true"
Exiger que toutes les valeurs de lâattribut dâ EXPECT correspondent Ă la valeur boolĂ©enne donnĂ©e
WITH-ALL-VALUES "/ expr_rationnelle /"
Exiger que les valeurs de lâattribut dâ EXPECT correspondent Ă lâexpression rationnelle, qui doit ĂȘtre conforme Ă la syntaxe POSIX des expressions rationnelles. Les comparaisons sont sensibles Ă la casse.
WITH-DISTINCT-VALUES
Exiger que toutes les valeurs de lâattribut EXPECT soient uniques. Les comparaisons sont sensibles Ă la casse. Seuls les attributs charset, collection, enum, integer, keyword, mimeMediaType, naturalLanguage, rangeOfInteger, resolution, uriScheme gĂšrent ce prĂ©dicat.
WITH-HOSTNAME
"
chaßne_littérale
"
WITH-HOSTNAME
"/
exp_rationnelle
/"
Exiger quâau moins une valeur dâURI contienne un nom dâhĂŽte concordant.
WITH-RESOURCE
"
chaßne_littérale
"
WITH-RESOURCE
"/
exp_rationnelle
/"
Exiger quâau moins une valeur dâURI contienne une ressource correspondante.(y compris le « / » de dĂ©but).
WITH-SCHEME
"
chaßne_littérale
"
WITH-SCHEME
"/
exp_rationnelle
/"
Exiger quâau moins une valeur dâURI contienne un schĂ©ma concordant.
WITH-VALUE " chaßne_littérale "
Exiger quâau moins une valeur de lâattribut dâ EXPECT corresponde Ă la chaĂźne littĂ©rale. Les comparaisons sont sensibles Ă la casse.
WITH-VALUE
<
nombre
WITH-VALUE =
nombre
WITH-VALUE >
nombre
WITH-VALUE
nombre
[
,...,nombre
]
Exiger quâau moins une valeur de lâattribut dâ EXPECT corresponde au(x) nombre(s) ou Ă la comparaison numĂ©rique. Lors de la comparaison des valeurs dâintervalle de nombres entiers, les opĂ©rateurs « < » et « > » contrĂŽlent seulement la limite supĂ©rieure de lâintervalle.
WITH-VALUE "false"
WITH-VALUE "true"
Exiger quâau moins une valeur de lâattribut dâ EXPECT corresponde Ă la valeur boolĂ©enne donnĂ©e
WITH-VALUE "/ exp_rationnelle /"
Exiger quâau moins une valeur de lâattribut dâ EXPECT corresponde Ă lâexpression rationnelle, qui doit ĂȘtre conforme Ă la syntaxe POSIX des expressions rationnelles. Les comparaisons sont sensibles Ă la casse.
WITH-VALUE-FROM nom_attribut
Exiger que la(es) valeur(s) de lâattribut EXPECT corresponde(nt) Ă (ux) valeur(s) dans lâattribut indiquĂ©. Par exemple, « EXPECT job-sheets WITH-VALUE-FROM job-sheets-supported » exige que la valeur « job-sheets » soit listĂ©e comme valeur de lâattribut « job-sheets-supported ».
PRĂDICATS STATUS
Les
prédicats ci-dessous sont compris suivant la
directive de test
STATUS
:
DEFINE-MATCH
nom_variable
DĂ©finir la variable Ă 1 quand le STATUS correspond. Un effet de bord de ce prĂ©dicat est que ce STATUS nâĂ©chouera jamais Ă un test.
DEFINE-NO-MATCH nom_variable
DĂ©finir la variable Ă 1 quand le STATUS ne correspond pas. Un effet de bord de ce prĂ©dicat est que ce STATUS nâĂ©chouera jamais Ă un test.
IF-DEFINED nom_variable
Appliquer le STATUS seulement si la variable indiquée est définie.
IF-NOT-DEFINED nom_variable
Appliquer le STATUS seulement si la variable indiquĂ©e nâest pas dĂ©finie.
REPEAT-LIMIT nombre
Définir le nombre maximal de répétitions. La valeur par défaut est 1000 .
REPEAT-MATCH
REPEAT-NO-MATCH
Indiquer si le test actuel doit ĂȘtre recommencĂ© si le code de lâĂ©tat de la rĂ©ponse correspond ou ne correspond pas Ă la valeur indiquĂ©e par la directive STATUS
CODES DâOPĂRATION
Les codes dâopĂ©ration correspondent aux nombres hexadĂ©cimaux (0xHHHH) et noms de la RFC 8011 et dâautres spĂ©cifications dâextensions IPP. Voici une liste complĂšte de noms pris en charge par ipptool (8) :
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
CODES DâĂTAT
Les codes dâĂ©tat correspondent aux nombres hexadĂ©cimaux (0xHHHH) et noms de la RFC 8011 et dâautres spĂ©cifications dâextensions IPP. Voici une liste complĂšte de noms pris en charge par ipptool (8) :
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-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
ĂTIQUETTES
Les Ă©tiquettes de valeur et de groupe correspondent aux noms de la RFC 8011 et dâautres spĂ©cifications dâextensions IPP. Voici les Ă©tiquettes de groupe :
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
Voici les étiquettes de valeur :
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
VARIABLES
Le programme ipptool (8) conserve une liste de variables qui peuvent ĂȘtre utilisĂ©es dans nâimporte quelle chaĂźne littĂ©rale ou valeur dâattribut en indiquant « $nom_variable ». En plus des variables dĂ©finies en utilisant lâoption « -d » ou la directive DEFINE , les variables prĂ©dĂ©finies suivantes sont disponibles :
|
$$ |
Insérer un seul caractÚre « $ ». |
$ENV[ nom ]
InsĂ©rer la valeur de la variable dâenvironnement nommĂ©e, ou une chaĂźne vide si la variable dâenvironnement nâest pas dĂ©finie.
$date-current
InsĂ©rer la date et lâheure courantes en utilisant le format ISO-8601 (« aaaa-mm-jjThh:mm:ssZ »).
$date-start
InsĂ©rer la date et lâheure de dĂ©marrage en utilisant le format ISO-8601 (« aaaa-mm-jjThh:mm:ssZ »).
$nom_fichier
InsĂ©rer le nom de fichier fourni Ă ipptool (8) avec lâoption -f .
$type_fichier
InsĂ©rer le type MIME de mĂ©dia pour le nom de fichier fourni Ă ipptool (8) avec lâoption « -f ».
$nom_hĂŽte
InsĂ©rer le nom dâhĂŽte Ă partir de lâURI fourni Ă ipptool (8).
$id_tĂąche
InsĂ©rer la valeur du dernier identifiant de tĂąche renvoyĂ©e par la rĂ©ponse dâun test ou 0 si aucun identifiant nâa Ă©tĂ© trouvĂ©.
$uri_travail
InsĂ©rer la derniĂšre valeur de lâattribut de lâURI de travail renvoyĂ©e par la rĂ©ponse dâun test ou une chaĂźne vide si aucun attribut dâURI nâa Ă©tĂ© trouvĂ©.
$id_notification_souscription
InsĂ©rer la derniĂšre valeur de lâattribut dâidentifiant de notification dâabonnement renvoyĂ©e dans une rĂ©ponse de test ou 0 si aucun attribut nâa Ă©tĂ© trouvĂ©.
$port
InsĂ©rer le numĂ©ro du port Ă partir de lâURI fourni Ă ipptool (8).
$ressource
InsĂ©rer le chemin de ressource Ă partir de lâURI fourni Ă ipptool (8).
$schéma
InsĂ©rer le schĂ©ma depuis lâURI fourni Ă ipptool (8).
|
$uri |
InsĂ©rer lâURI fourni Ă ipptool (8). |
$uri_utilisateur
InsĂ©rer lâidentifiant Ă partir de lâURI fourni par ipptool (8), sâil existe.
$utilisateur
InsĂ©rer le nom de connexion de lâutilisateur actuel.
VOIR AUSSI
ipptool (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)
COPYRIGHT
Copyright © 2020-2024 by OpenPrinting.