ippeveprinter(1)

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.