ippeveprinter - Application d’impression ipp everywhere pour cups
ippeveprinter [
--help ] [
--no-web-forms ] [
--pam-service service ] [
--version ] [
-2 ] [
-A ] [
-D URI_périph ] [
-F
type_sortie/sous-type ] [
-K chemin_clé ] [
-M fabricant ] [
-P fichier.ppd ] [
-V
version_ipp ] [
-a fichier.conf ] [
-c
commande ] [
-d rép_spool ] [
-f
type/sous-type[,...] ] [
-i icône.png ] [
-k ] [
-l location ] [
-m model ] [
-n nom_hôte ] [
-p port ] [
-r
sous-type[,sous-type] ] [
-s vitesse[,vitesse_couleur] ]
[
-v[vvv] ]
service
ippeveprinter est un simple serveur IPP (Internet Printing Protocol)
conforme à la spécification IPP Everywhere (PWG 5100.14).
Il peut être utilisé pour tester le logiciel client ou agir
comme un serveur d’impression très basique qui exécute
une commande pour chaque tâche à accomplir.
Les options suivantes sont reconnues par
ippeveprinter :
- --help
- Afficher un message d’utilisation.
- --no-web-forms
- Désactiver les formes d’interface web
utilisés pour mettre à jour le média ou fournir les
niveaux.
-
--pam-service service
- Indiquer le nom du service PAM. Le nom du service par
défaut est « cups ».
- --version
- Afficher la version de CUPS.
- -2
- Indiquer la prise en charge de l’impression
recto-verso (duplex).
- -A
- Activer l’authentification pour l’imprimante
créée. ippeveprinter utilise PAM pour vérifier
les accréditations Basic d’HTTP.
-
-D URI_périph
- Indiquer l’URI du périphérique pour la
sortie d’impression. L’URI peut être un nom de
fichier, un répertoire ou un URI de socket réseau de la
forme « socket://ADRESSE[:PORT]" (où le
numéro de port par défaut est 9100). Si un répertoire
est indiqué, ippeveprinter créera un fichier de
sortie en utilisant l’identifiant de la tâche et son
nom.
-
-F type_sortie/sous-type[,...]
- Indiquer le type MIME de média de sortie. Par
défaut, c’est
« application/postscript » quand
l’option -P est indiquée.
-
-M fabricant
- Indiquer le fabricant de l’imprimante. Par
défaut, « Example ».
-
-P fichier.ppd
- Charger les attributs d’imprimante à partir
du fichier PPD indiqué. Cette option est typiquement
utilisée conjointement avec la commande d’impression de
ippeveps(7)
(« -c ippeveps »).
- -V 1.1
- -V 2.0
- Indiquer le numéro maximal de version d’IPP
à rapporter, par défaut 2.0.
-
-c commande
- Exécuter la commande indiquée pour chaque
document à imprimer. Si « commande »
n’est pas un chemin absolu,
(« /chemin/vers/commande »),
ippeveprinter recherche directement la commande dans le
sous-répertoire « command » du binaire
de CUPS, typiquement /usr/lib/cups/command ou
/usr/libexec/cups/command. La commande cups-config(1) peut
être utilisée pour découvrir le répertoire
correct du binaire
(« cups-config --serverbin »). De plus,
la variable d’environnement CUPS_SERVERBIN peut être
utilisée pour écraser l’emplacement par défaut
de ce répertoire — consulter la page de manuel de
cups(1) pour plus de détails.
-
-d rép_spool
- Indiquer le répertoire qui contiendra les fichiers
à imprimer. Par défaut, c'est un répertoire dans le
répertoire temporaire actuel de l’utilisateur.
-
-f type/sous-type[,...]
- Indiquer une liste de types MIME de média que le
serveur acceptera. Par défaut, elle dépend du type
d’imprimante créée ».
-
-i icône.png
- Indiquer le fichier d’icône de
l’imprimante pour le serveur. Le fichier d’image doit
être au format PNG. Par défaut, c’est une image PNG
fournie en interne.
- -k
- Conserver les documents dans le répertoire de spool
plutôt que de les détruire.
-
-l emplacement
- Définir la chaîne compréhensible aux
utilisateurs de l’emplacement, indiquée par le serveur. Par
défaut, une chaîne vide.
-
-m modèle
- Définir le nom de modèle de
l’imprimante. Par défaut,
« Printer ».
-
-n nom_hôte
- Définir le nom d’hôte complet
renvoyé par le serveur. Par défaut, le nom renvoyé
par la commande hostname(1).
-
-p port
- Indiquer le numéro de port à écouter.
Par défaut, un numéro défini par l’utilisateur
de 8000 à 8999.
-
-r off
- Désactiver entièrement les avertissements du
service DNS-SD.
-
-r sous-type[,sous-type]
- Indiquer le(s) sous-type(s) DNS-SD à notifier. Les
sous-types sont à séparer par des virgules. Par
défaut, « _print_».
-
-s vitesse[,vitesse_couleur]
- Indiquer la vitesse de l’imprimante en page par
minute. Si deux nombres sont indiqués et que le deuxième
nombre est supérieur à zéro, le serveur
déclarera une prise en charge de la couleur. Par défaut,
« 10,0 ».
- -v[vvv]
- Être (très) détaillé lors de
l’activité de journalisation sur la sortie
d’erreur.
Le programme
ippeveprinter renvoie
1 s’il est incapable de
traiter les arguments de la ligne de commande ou d’enregistrer le
service IPP. Sinon
ippeveprinter continuera jusqu’à la
fin de la commande.
Le programme
ippeveprinter est spécifique à CUPS et est
conforme à la spécification IPP Everywhere (PWG 5100.14).
ippeveprinter ajoute des variables d’environnement
commençant par « IPP_ » pour tous les
attributs de tâche IPP dans la requête d’impression. Par
exemple lors de l’exécution d’une commande pour un
tâche IPP contenant l’attribut de modèle de tâche
« media », la variable d’environnement
« IPP_MEDIA » sera définie à la
valeur de cet attribut.
De plus, tous les attributs de description d’imprimante IPP
« xxx-default » et
« pwg-xxx » sont ajoutés à
l’environnement. Par exemple, la variable d’environnement
« IPP_MEDIA_DEFAULT » sera définie à
la valeur par défaut pour l’attribut de modèle de
tâche « media ».
Les valeurs numériques sont converties à leurs mots-clefs
équivalents. Par exemple, un attribut de modèle de tâche
« print-quality » avec une valeur de
3 deviendra une variable d’environnement
« IPP_PRINT_QUALITY » avec comme valeur
« draft » (brouillon). Cette conversion de chaine
se produit uniquement pour les attributs de modèle, actuellement
« finishings »,
« orientation-requested » et
« print-quality ».
Finalement, la variable d’environnement
« CONTENT_TYPE » contient le type MIME de
média du document à imprimer, la variable d’environnement
« DEVICE_URI » contient l’URI du
périphérique tel qu’indiqué avec
l’option
-D, la variable d’environnement
« OUTPUT_FORMAT » contient le type MIME de
média et la variable d’environnement
« PPD » contient le nom du fichier PPD tel
qu’indiqué avec
l’option « -P ».
À moins de communiquer directement avec l’imprimante, les
commandes d’impression envoient les données prêtes pour
l’impression sur la sortie standard.
Les commandes d’impression peuvent renvoyer des messages vers
ippeveprinter sur la sortie d’erreur avec un des préfixes
suivants :
-
ATTR: attribut=valeur[
attribut=valeur]
- Définir les attribut(s) cités aux valeurs
données. Actuellement seuls les attributs d’état de
tâche « job-impressions » et
« job-impressions-completed » et les attributs
d’état d’imprimante
« marker-xxx »,
« printer-alert »,
« printer-alert-description »,
« printer-supply » et
« printer-supply-description » peuvent
être définis.
-
DEBUG: message de débogage
- Journaliser un message de débogage si au moins deux
« -v » ont été
indiqués.
-
ERROR: message d’erreur
- Journaliser un message d’erreur et le copier dans
l’attribut « job-state-message ».
-
INFO: message informatif
- Journaliser un message informationnel ou de progression si
« -v » a été indiqué et
copier le message dans l’attribut
« job-state-message » à moins
qu’une erreur ait été signalée.
-
STATE:
mot-clé[,mot-clé,...]
- Définir l’attribut
« printer-state-reasons » de
l’imprimante aux mots-clés listés.
-
STATE:
-mot-clé[,mot-clé,...]
- Supprimer les mots-clés listés de
l’attribut « printer-state-reasons » de
l’imprimante.
-
STATE:
+mot-clé[,mot-clé,...]
- Ajouter les mots-clés listés dans
l’attribut « printer-state-reasons » de
l’imprimante.
Exécuter
ippeveprinter avec un nom de service Ma Super
Imprimante :
ippeveprinter "Ma Super Imprimante"
Exécuter la commande
file(1) à chaque fois qu’une
tâche est envoyée au serveur :
ippeveprinter -c /usr/bin/file "Ma Super Imprimante"
ippevepcl(7),
ippeveps(7), PWG Internet Printing Protocol
Workgroup (
http://www.pwg.org/ipp)
Copyright © 2021-2022 par OpenPrinting.