ippeveprinter
Table des matières
Retour à l'index
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.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- CODE DE RETOUR
-
- CONFORMITÉ
-
- ENVIRONNEMENT
-
- SORTIE DES COMMANDES
-
- EXEMPLES
-
- VOIR AUSSI
-
- COPYRIGHT
-
This document was created by
man2html,
using the manual pages.
Time: 05:05:55 GMT, September 19, 2025