NOM
backend - Programme de transmission de CUPS.
SYNOPSIS
backend
backend travail utilisateur titre copies options [ fichier ]
Les programmes de transmission de CUPS sont des filtres particuliers
(consultez filter(7) qui sont utiliss pour envoyer les donnes imprimer
et dcouvrir les diffrents priphriques d'impression du systme.
Comme les filtres, ils doivent tre capables de lire depuis un fichier
fournit sur la ligne de commande ou depuis l'entre standard, en copiant
l'entre standard vers un fichier temporaire si ncessaire pour
l'interface physique.
The command name (argv[0]) is set to the device URI of the destination
printer. Starting with CUPS 1.1.22, any authentication information in
argv[0] is removed, so backend developers are urged to use the
DEVICE_URI environment variable whenever authentication information is
required. The CUPS API includes a cupsBackendDeviceURI function for
retrieving the correct device URI.
Les donnes en retour du priphrique doivent tre envoyes au filtres des
travaux en crivant sur le descripteur de fichiers 3. L'API CUPS propose
la fonction cupsBackChannelWrite pour cela.
DCOUVERTE DES PRIPHRIQUES
Quand il est excut sans paramtre, le programme dorsal doit lister sur
la sortie standard les priphriques et schmas qu'il gre ou qu'il
annonce. La sortie consiste en zro ou plus de lignes de la forme
suivante :
device-class scheme "Unknown" "device-info"
device-class device-uri "device-make-and-model" "device-info"
device-class device-uri "device-make-and-model" "device-info" "device-id"
device-class device-uri "device-make-and-model" "device-info" "device-id" "device-location"
Le champ classe_priphrique peut prendre une de ces valeurs :
direct
L'uri du priphrique se rfre un accs direct au priphrique, sans
option, comme pour un priphrique sur port parallle, USB ou SCSI.
file
L'uri du priphrique se rfre un fichier sur le disque.
network
L'uri du priphrique se rfre un priphrique rseau et respecte les
formes gnrales des URI rseau.
serial
L'uri du priphrique se rfre un priphrique srie avec une vitesse
configurable et d'autres options. Si l'uri du priphrique contient
la vitesse, elle reprsente la vitesse maximale gre par le
priphrique.
Le champ schma fournit le schma d'URI gr par le dorsal. Les dorsaux ne
doivent utiliser cette forme que s'ils supportent toute URI utilisant
ce schma. Le champ uri_priphrique spcifie l'URI complte utiliser pour
la communication avec le priphrique.
Le champ marque_et_modle_priphrique prcise la marque et le modle du
priphrique, par exemple Acme Foojet 2000 . Si la marque et le modle ne
sont pas connus, vous devez indiquer Unknown .
Le champ info_priphrique ajoute des informations propos du priphrique.
Typiquement cela comprend la marque et le modle avec le numro de port
ou l'adresse rseau, par exemple Acme Foojet 2000 USB #1 .
Le champ optionnel id_priphrique indique l'identifiant IEEE-1284 du
priphrique, qui est utilis pour slectionner le pilote correspondant.
The optional device-location field specifies the physical location of
the device, which is often used to pre-populate the printer-location
attribute when adding a printer.
PERMISSIONS
Les dorsaux sans les droits d'excution pour tout le monde sont excut en
tant que root. Sinon, le dorsal est excut en utilisant le compte non
privilgi, gnralement lp .
CODES DE SORTIE
Les dorsaux renvoient les codes de retour suivants ; les constantes
dfinie par l'API C dans <cups/backend.h> sont indiques entre
parenthses :
0 (CUPS_BACKEND_OK)
Le fichier imprimer a t transmis avec succs au priphrique ou au
serveur distant.
1 (CUPS_BACKEND_FAILED)
Le fichier imprimer n'a pas t transmis correctement au priphrique
ou au serveur distant. L'ordonanceur annulera le travail,
ressayera 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
donne d'identifications valables sont ncessaires. L'ordonanceur
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 concervera le
travail d'impression.
4 (CUPS_BACKEND_STOP)
Le fichier imprimer n'a pas t transmis car il ne peut pas tre
imprimer en ce moment. L'ordonnanceur stopera la queue.
5 (CUPS_BACKEND_CANCEL)
Le fichier imprimer n'a pas t transmis parce qu'un atribut n'est
pas gr. L'ordonanceur rpond cela en annulant le travail
d'impression.
Tous les autres codes de sortie sont rservs.
VOIR AUSSI
cupsd(8), cupsd.conf(5), filter(7),
http://localhost:631/help
COPYRIGHT
Copyright 2007-2009 by Apple Inc.