Linux Certif

Toute la documentation sur la certification Linux LPI

backend

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 fournit 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 fixé à la valeur de l'URI du périphérique de l'imprimante de destination. À partir de la version 1.1.22 de CUPS, les informations d'identification sont retirées de argv[0]. Il est donc demandé aux développeurs des dorsaux d'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 filtres 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 dorsal doit lister 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"
 

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 dorsal. Les dorsaux ne doivent utiliser cette forme que s'ils supportent toute URI utilisant ce schéma. Le champ uri_périphérique spécifie 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.

PERMISSIONS

Les dorsaux sans les droits d'exécution pour tout le monde sont exécuté en tant que root. Sinon, le dorsal est exécuté en utilisant le compte non privilégié, généralement « lp ».

CODES DE SORTIE

Les dorsaux renvoient les codes de retour suivants ; les constantes définie 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'ordonanceur 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ée d'identifications valables sont nécessaires. 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 géré. L'ordonanceur répond à cela en annulant le travail d'impression.

Tous les autres codes de sortie sont réservés.

VOIR AUSSI

cupsd(8), cupsd.conf(5), filter(7)
http://localhost:631/help

COPYRIGHT

Copyright 2007 by Apple Inc.