DOKK / manpages / debian 12 / cups-ipp-utils / ippeveprinter.1.fr
ippeveprinter(1) OpenPrinting ippeveprinter(1)

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 :

Afficher un message d’utilisation.
Désactiver les formes d’interface web utilisés pour mettre à jour le média ou fournir les niveaux.
Indiquer le nom du service PAM. Le nom du service par défaut est « cups ».
Afficher la version de CUPS.
-2
Indiquer la prise en charge de l’impression recto-verso (duplex).
Activer l’authentification pour l’imprimante créée. ippeveprinter utilise PAM pour vérifier les accréditations Basic d’HTTP.
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.
Indiquer le type MIME de média de sortie. Par défaut, c’est « application/postscript » quand l’option -P est indiquée.
Indiquer le fabricant de l’imprimante. Par défaut, « Example ».
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 »).
Indiquer le numéro maximal de version d’IPP à rapporter, par défaut 2.0.
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.
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.
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 ».
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.
Conserver les documents dans le répertoire de spool plutôt que de les détruire.
Définir la chaîne compréhensible aux utilisateurs de l’emplacement, indiquée par le serveur. Par défaut, une chaîne vide.
Définir le nom de modèle de l’imprimante. Par défaut, « Printer ».
Définir le nom d’hôte complet renvoyé par le serveur. Par défaut, le nom renvoyé par la commande hostname(1).
Indiquer le numéro de port à écouter. Par défaut, un numéro défini par l’utilisateur de 8000 à 8999.
Désactiver entièrement les avertissements du service DNS-SD.
Indiquer le(s) sous-type(s) DNS-SD à notifier. Les sous-types sont à séparer par des virgules. Par défaut, « _print_».
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 ».
Ê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 :

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.
Journaliser un message de débogage si au moins deux « -v » ont été indiqués.
Journaliser un message d’erreur et le copier dans l’attribut « job-state-message ».
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.
Définir l’attribut « printer-state-reasons » de l’imprimante aux mots-clés listés.
Supprimer les mots-clés listés de l’attribut « printer-state-reasons » de l’imprimante.
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.

CUPS 28 février 2021