ipptoolfile - Format de fichier ipptool
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
}
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.
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]
- Définir un délai en seconde avant
l’exécution du test. Si deux valeurs sont indiquées,
la seconde est utilisée pour définir l’intervalle
entre des tests répétitifs.
-
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.
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 ».
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
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
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
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
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.
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 © 2021-2022 par OpenPrinting.