Manpages

NOM

ippeveprinter - Application d’impression ipp everywhere pour cups

SYNOPSIS

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

DESCRIPTION

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.

OPTIONS

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.

CODE DE RETOUR

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.

CONFORMITÉ

Le programme ippeveprinter est spécifique à CUPS et est conforme à la spécification IPP Everywhere (PWG 5100.14).

ENVIRONNEMENT

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 ».

SORTIE DES COMMANDES

À 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.

EXEMPLES

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"

VOIR AUSSI

ippevepcl(7), ippeveps(7), PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp)

COPYRIGHT

Copyright © 2020-2024 by OpenPrinting.