NOM¶
backend - Programme de transmission de CUPS.
SYNOPSIS¶
backend
backend travail utilisateur titre copies
options [
fichier ]
DESCRIPTION¶
Les programmes de transmission de CUPS sont des filtres particuliers (consultez
filter(7) qui sont utilisés pour envoyer les données à
imprimer et découvrir les différents périphériques
d'impression du système.
Comme les filtres, ils doivent être capables de lire depuis un fichier
fourni sur la ligne de commande ou depuis l'entrée standard, en copiant
l'entrée standard vers un fichier temporaire si nécessaire pour
l'interface physique.
Le nom de la commande (argv[0]) est défini à la valeur de l'URI du
périphérique de l'imprimante de destination. À partir de la
version 1.1.22 de CUPS, toute information d'identification est
retirée de argv[0], les développeurs des programmes de transmission
devraient utiliser la variable d'environnement DEVICE_URI pour obtenir les
informations d'identification quand cela est nécessaire. L'API CUPS
propose la fonction
cupsBackendDeviceURI pour récupérer la
valeur correcte de l'URI du périphérique.
Les données en retour du périphérique doivent être
envoyées au filtre des travaux en écrivant sur le descripteur de
fichiers 3. L'API CUPS propose la fonction
cupsBackChannelWrite pour
cela.
DÉCOUVERTE DES PÉRIPHÉRIQUES¶
Quand il est exécuté sans paramètre, le programme de transmission
doit afficher sur la sortie standard les périphériques et
schémas qu'il gère ou qu'il annonce. La sortie consiste en zéro
ou plus de lignes de la forme suivante :
classe_périphérique schéma "Unknown" "info_périphérique"
classe_périphérique URI_périphérique "marque_et_modèle_périphérique" "info_périphérique"
classe_périphérique URI_périphérique "marque_et_modèle_périphérique" "info_périphérique" "id_périphérique"
classe_périphérique URI_périphérique "marque_et_modèle_périphérique" "info_périphérique" "emplacement_périphérique"
Le champ
classe_périphérique peut prendre une de ces
valeurs :
- direct
-
L'URI du périphérique se réfère à un accès
direct au périphérique, sans option, comme pour un
périphérique sur port parallèle, USB ou SCSI.
- file
-
L'URI du périphérique se réfère à un fichier sur le
disque.
- network
-
L'URI du périphérique se réfère à un
périphérique réseau et respecte les formes
générales des URI réseau.
- serial
-
L'URI du périphérique se réfère à un
périphérique série avec une vitesse configurable et
d'autres options. Si l'URI du périphérique contient la vitesse,
elle représente la vitesse maximale gérée par le
périphérique.
Le champ
schéma fournit le schéma d'URI géré par le
programme de transmission. Les programmes de transmission ne doivent utiliser
cette forme que s'ils gèrent toute URI utilisant ce schéma. Le champ
uri_périphérique indique l'URI complète à utiliser
pour la communication avec le périphérique.
Le champ
marque_et_modèle_périphérique précise la
marque et le modèle du périphérique, par exemple
« Acme Foojet 2000 ». Si la marque et le modèle ne
sont pas connus, vous devez indiquer « Unknown ».
Le champ
info_périphérique ajoute des informations à
propos du périphérique. Typiquement cela comprend la marque et le
modèle avec le numéro de port ou l'adresse réseau, par exemple
« Acme Foojet 2000 USB #1 ».
Le champ optionnel
id_périphérique indique l'identifiant
IEEE-1284 du périphérique, qui est utilisé pour
sélectionner le pilote correspondant.
Le champ optionnel
emplacement_périphérique indique
l'emplacement physique du périphérique, qui est utilisé la
plupart du temps pour pré-remplir l'emplacement-périphérique
lors de l'ajout d'une imprimante.
PERMISSIONS¶
Les programmes de transmission sans droit d'exécution pour tout le monde
sont exécutés en tant que root. Sinon, le programme de transmission
est exécuté en utilisant le compte non privilégié,
généralement « lp ».
CODES DE SORTIE¶
Les programmes de transmission renvoient les codes de retour suivants ; les
constantes définies par l'API C dans <cups/backend.h> sont
indiquées entre parenthèses :
- 0 (CUPS_BACKEND_OK)
-
Le fichier à imprimer a été transmis avec succès au
périphérique ou au serveur distant.
- 1 (CUPS_BACKEND_FAILED)
-
Le fichier à imprimer n'a pas été transmis correctement au
périphérique ou au serveur distant. L'ordonnanceur annulera le
travail, réessayera l'impression ou stoppera la queue en fonction de
l'état de l'attribut error-policy.
- 2 (CUPS_BACKEND_AUTH_REQUIRED)
-
Le fichier à imprimer n'a pas été transmis correctement parce
que des données d'identifications valables sont nécessaires.
L'ordonnanceur suspendra le travail et ajoutera le mot clé
authentication-required à l'attribut job-reasons.
- 3 (CUPS_BACKEND_HOLD)
-
Le fichier à imprimer n'a pas pu être transmis parce qu'il ne
pouvait pas être imprimé à ce moment. L'ordonnaceur
conservera le travail d'impression.
- 4 (CUPS_BACKEND_STOP)
-
Le fichier à imprimer n'a pas été transmis car il ne peut pas
être imprimé en ce moment. L'ordonnanceur stoppera la queue.
- 5 (CUPS_BACKEND_CANCEL)
-
Le fichier à imprimer n'a pas été transmis parce qu'un
attribut n'est pas géré. L'ordonnanceur répond à cela
en annulant le travail d'impression.
- 6 (CUPS_BACKEND_RETRY)
-
Le fichier à imprimer n'a pas pu être transmis à cause d'un
incident temporaire. L'ordonnanceur retentera de lancer la tâche plus
tard - les autres tâches pourraient imprimer avant celui-ci.
- 7 (CUPS_BACKEND_RETRY_CURRENT)
-
Le fichier à imprimer n'a pas pu être transmis à cause d'un
incident temporaire. L'ordonnanceur retentera de lancer la tâche
immédiatement en empêchant d'autres tâches d'intervenir.
Tous les autres codes de sortie sont réservés.
VOIR AUSSI¶
cupsd(8),
cupsd.conf(5),
filter(7)
<URL:
http://localhost:631/help>
COPYRIGHT¶
Copyright 2007-2011 par Apple Inc.