.\" .\" "$Id: filter.man 9771 2011-05-12 05:21:56Z mike $" .\" .\" filter man page for CUPS. .\" .\" Copyright 2007-2011 by Apple Inc. .\" Copyright 1997-2007 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 filter 7 CUPS 13\ mai\ 2009 "Apple Inc." .SH NOM filter \- Interface pour des filtres de conversion de fichiers pour CUPS. .SH SYNOPSIS \fBfilter\fP travail utilisateur titre copies options [ \fIfichier\fP ] .SH DESCRIPTION Les filtres CUPS offrent la possibilité de gérer avec CUPS des nouveaux types de documents. Chaque filtre est capable de convertir des fichiers de différents formats dans un format qui est soit géré directement par CUPS ou qui peut être envoyé à un autre filtre afin d'être imprimable. .LP Les filtres \fBdoivent\fP ê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 ce format de fichier. Toutes les sorties \fBdoivent\fP être envoyées sur la sortie standard. .LP Le nom de la commande (argv[0]) vaut le nom de l'imprimante de destination, mais est également disponible dans la variable d'environnement PRINTER. .SH OPTIONS Les options passées sur la ligne de commande n'incluent généralement pas le fichier PPD par défaut de l'imprimante. De plus, certaines options doivent être indiquées de plusieurs façons différentes \- «\ landscape\ » est synonyme de «\ orientation\-requested=4\ », «\ media\ » est synonyme de «\ PageSize\ » «\ PageRegion\ » «\ InputSlot\ » et «MediaType», et «\ sides\ » est synonyme pour les nombreuses options de «\ Duplex\ ». Les filtres non\-vectoriels \fBdoivent\fP supporter les deux spécifications explicites et implicites des options PPD \- utilisez les fonctions ppdMappdMarkDefaults et cupsMarkOptions de la librairie CUPS pour employer la bonne correspondance, et ppdFindMarkedChoice pour obtenir le choix de l'utilisateur sélectionné. .LP Les filtres vectoriels devraient utiliser des choix optionnels passés par les entêtes de la page vectorielle, étant donné qu'ils sont à l'identique des options actives pour une page donnée. Les options passées sur la ligne de commande déterminent les valeurs par défaut pour le travail en entier, et peuvent être outrepassées en les définissant par page. .SH "MESSAGES JOURNALISÉS" Les messages envoyés à la sortie d'erreur sont généralement enregistrés dans l'attribut printer\-state\-message et dans le journal \fIErrorLog\fP actuel. Chaque ligne commence par un préfixe standard\ : .TP 5 ALERT: message .br Définir l'attribut printer\-state\-message et ajouter le message donné au journal \fIErrorLog\fP actuel en utilisant le niveau de journalisation «\ alert\ ». .TP 5 ATTR: attribut=valeur [attribut=valeur] .br Définir l'attribut (les attributs) donné(s) du travail d'impression. Typiquement, c'est utilisé pour fixer l'attribut job\-remote\-id. .TP 5 CRIT: message .br Définir l'attribut printer\-state\-message et ajouter le message donné au journal \fIErrorLog\fP actuel en utilisant le niveau de journalisation «\ critical\ ». .TP 5 DEBUG: message .br Définir l'attribut printer\-state\-message et ajouter le message donné au journal \fIErrorLog\fP actuel en utilisant le niveau de journalisation «\ debug\ ». .TP 5 DEBUG2: message .br Définir l'attribut printer\-state\-message et ajouter le message donné au journal \fIErrorLog\fP actuel en utilisant le niveau de journalisation «\ debug2\ ». .TP 5 EMERG: message .br Définir l'attribut printer\-state\-message et ajouter le message donné au journal \fIErrorLog\fP actuel en utilisant le niveau de journalisation «\ emergency\ ». .TP 5 ERROR: message .br Définir l'attribut printer\-state\-message et ajouter le message donné au journal \fIErrorLog\fP actuel en utilisant le niveau de journalisation «\ error\ ». .TP 5 INFO: message .br Fixer l'attribut printer\-state\-message. Si \fILogLevel\fP vaut «\ debug2\ », le message est également ajouté au journal \fIErrorLog\fP en utilisant le niveau «\ info\ ». .TP 5 NOTICE: message .br Définir l'attribut printer\-state\-message et ajouter le message donné au journal \fIErrorLog\fP actuel en utilisant le niveau de journalisation «\ notice\ ». .TP 5 PAGE: numéro_page #\-copies .TP 5 PAGE: total #\-pages .br Ajouter une entrée au fichier \fIPageLog\fP actuel. La première forme ajoute le nombre de copies à l'attribut job\-media\-sheets\-completed. La seconde forme définit l'attribut job\-media\-sheets\-completed au nombre de pages. .TP 5 PPD: Mot Clé=Valeur ... Mot CléN=Valeur .br Définir les mots clés dans le fichier PPD de l'imprimante. Ceci est généralement utilisé pour mettre à jour les options de mots clés par défaut telles que DefaultPageSize et les nombreuses options insérables dans le fichier PPD. .TP 5 STATE: raison\-état\-imprimante [raison\-état\-imprimante ...] .TP 5 STATE: + raison\-état\-imprimante [raison\-état\-imprimante ...] .TP 5 STATE: \- raison\-état\-imprimante [raison\-état\-imprimante ...] .br Définir, ajouter ou retirer des mots clé raison\-état\-imprimante de la file d'attente en cours. Typiquement c'est utilisé pour indiquer l'état du média, de l'encre et du toner d'une imprimante. .TP 5 WARNING: message .br Définir l'attribut printer\-state\-message et ajouter le message donné au journal \fIErrorLog\fP actuel en utilisant le niveau de journalisation «\ warning\ ». .SH "VARIABLES D'ENVIRONNEMENT" Les variables d'environnement suivantes sont définies par le serveur CUPS pour l'exécution des filtres\ : .TP 5 CHARSET .br Définir le jeu de caractères par défaut à utiliser pour les textes, typiquement utf\-8. .TP 5 CLASS .br Quand un travail est soumis à une classe d'imprimantes, elle contient le nom de la classe d'imprimante. Sinon, cette variable d'environnement n'est pas définie. .TP 5 CONTENT_TYPE .br Le type MIME associé au fichier (par exemple application/postscript). .TP 5 CUPS_CACHEDIR .br Le répertoire où se trouvent les fichiers cache semi\-persistant .TP 5 CUPS_DATADIR .br Le répertoire où se trouvent les fichiers de données. .TP 5 CUPS_FILETYPE .br Le type du fichier en cours d'impression\ : «\ job\-sheet\ » pour une bannière et «\ document\ » pour une impression de fichier normale. .TP 5 CUPS_SERVERROOT .br Le répertoire racine du serveur. .TP 5 DEVICE_URI .br L'uri du périphérique associé à l'imprimante. .TP 5 FINAL_CONTENT_TYPE .br Le type MIME associé à l'imprimante (par exemple application/vnd.cups\-postscript). .TP 5 LANG .br La locale de la langue par défaut (généralement C ou en). .TP 5 PATH .br Le chemin d'exécution par défaut pour les programmes externes qui peuvent être exécutés par le filtre. .TP 5 PPD .br Le chemin complet vers le fichier PPD («\ PostScript Printer Description\ ») de cette imprimante. .TP 5 PRINTER .br Le nom de l'imprimante. .TP 5 RIP_CACHE .br La quantité de mémoire recommandée pour les RIP («\ Raster Image Processors\ »). .TP 5 SOFTWARE .br Le nom et la version du serveur (par exemple CUPS/1.2). .TP 5 TZ .br Le fuseau horaire du serveur .TP 5 USER .br L'utilisateur qui exécute le filtre, typiquement «\ lp\ » ou «\ root\ »\ ; consultez le fichier \fBcupsd.conf\fP(5) pour le paramétrage courant. .SH COMPATIBILITÉ Alors que l'interface des filtres est compatible avec l'interface des scripts Système\ V, elle ne fonctionnera avec le script d'interface Système\ V que comme unique filtre. Typiquement le script d'interface sera fourni par la commande \fBlpadmin\fP(8) en utilisant l'option \fB\-i\fP. .SH "VOIR AUSSI" \fIbackend(7)\fP, \fIcupsd(8)\fP, .br .SH COPYRIGHT Copyright 2007\-2011 par Apple Inc. .\" .\" End of "$Id: filter.man 9771 2011-05-12 05:21:56Z mike $". .\"