.\" .\" "$Id: backend.man 9693 2011-04-16 02:51:22Z mike $" .\" .\" Backend man page for CUPS. .\" .\" Copyright 2007-2011 by Apple Inc. .\" Copyright 1997-2006 by Easy Software Products. .\" .\" These coded instructions, statements, and computer programs are the .\" property of Apple Inc. and are protected by Federal copyright .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH backend 7 CUPS "15 avril 2011" "Apple Inc." .SH NOM backend \- Programme de transmission de CUPS. .SH SYNOPSIS \fBbackend\fP .br \fBbackend\fP \fItravail\fP \fIutilisateur\fP \fItitre\fP \fIcopies\fP \fIoptions\fP [ \fIfichier\fP ] .SH DESCRIPTION Les programmes de transmission de CUPS sont des filtres particuliers (consultez \fBfilter\fP(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. .LP 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. .LP 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 \fIcupsBackendDeviceURI\fP pour récupérer la valeur correcte de l'URI du périphérique. .LP 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 \fIcupsBackChannelWrite\fP pour cela. .SH "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\ : .nf 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" .fi .LP Le champ \fIclasse_périphérique\fP peut prendre une de ces valeurs\ : .TP 5 \fBdirect\fP .br 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. .TP 5 \fBfile\fP .br L'URI du périphérique se réfère à un fichier sur le disque. .TP 5 \fBnetwork\fP .br 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. .TP 5 \fBserial\fP .br 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. .LP Le champ \fIschéma\fP 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 \fIuri_périphérique\fP indique l'URI complète à utiliser pour la communication avec le périphérique. .LP Le champ \fImarque_et_modèle_périphérique\fP 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\ ». .LP Le champ \fIinfo_périphérique\fP 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\ ». .LP Le champ optionnel \fIid_périphérique\fP indique l'identifiant IEEE\-1284 du périphérique, qui est utilisé pour sélectionner le pilote correspondant. .LP Le champ optionnel \fIemplacement_périphérique\fP 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. .SH 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\ ». .SH "CODES DE SORTIE" Les programmes de transmission renvoient les codes de retour suivants\ ; les constantes définies par l'API C dans sont indiquées entre parenthèses\ : .TP 5 0 (CUPS_BACKEND_OK) .br Le fichier à imprimer a été transmis avec succès au périphérique ou au serveur distant. .TP 5 1 (CUPS_BACKEND_FAILED) .br 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. .TP 5 2 (CUPS_BACKEND_AUTH_REQUIRED) .br 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. .TP 5 3 (CUPS_BACKEND_HOLD) .br 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. .TP 5 4 (CUPS_BACKEND_STOP) .br Le fichier à imprimer n'a pas été transmis car il ne peut pas être imprimé en ce moment. L'ordonnanceur stoppera la queue. .TP 5 5 (CUPS_BACKEND_CANCEL) .br 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. .TP 5 6 (CUPS_BACKEND_RETRY) .br 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. .TP 5 7 (CUPS_BACKEND_RETRY_CURRENT) .br 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. .PP Tous les autres codes de sortie sont réservés. .SH "VOIR AUSSI" \fIcupsd\fP(8), \fIcupsd.conf\fP(5), \fIfilter\fP(7) .br .SH COPYRIGHT Copyright 2007\-2011 par Apple Inc. .\" .\" End of "$Id: backend.man 9693 2011-04-16 02:51:22Z mike $". .\"