Provided by: cups_1.4.4-6ubuntu2_i386 bug

NOM

       filter  -  Interface  pour  des  filtres de conversion de fichiers pour
       CUPS.

SYNOPSIS

       filter travail utilisateur titre copies options [ fichier ]

DESCRIPTION

       Les filtres CUPS offrent la possibilite de gerer avec CUPS des nouveaux
       types de documents. Chaque filtre est capable de convertir des fichiers
       de differents formats dans un format qui est soit gere directement  par
       CUPS ou qui peut etre envoye a un autre filtre afin d'etre imprimable.

       Les filtres doivent etre capables de lire depuis un fichier fournit sur
       la ligne de commande ou depuis l'entree standard, en  copiant  l'entree
       standard  vers  un  fichier  temporaire si necessaire pour ce format de
       fichier. Toutes  les  sorties  doivent  etre  envoyees  sur  la  sortie
       standard.

       The  command  name  (argv[0])  is  set  to  the name of the destination
       printer but is also available in the PRINTER environment variable.

OPTIONS

       Options passed on the command-line typically do not include the default
       choices  the  printer's  PPD  file.  In  addition,  some options may be
       specified  in  multiple  ways  -   "landscape"   is   a   synonym   for
       "orientation-requested=4",   "media"   is  a  synonym  for  "PageSize",
       "PageRegion", "InputSlot", and "MediaType", and "sides"  is  a  synonym
       for  the various "Duplex" options. Non-raster filters must support both
       explicit  and  implicit  specification  of  PPD  options  -   use   the
       ppdMarkDefaults  and  cupsMarkOptions  functions in the CUPS library to
       use  the  correct  mapping,  and   ppdFindMarkedChoice   to   get   the
       user-selected choice.

       Raster  filters  should  use option choices set through the raster page
       header, as those reflect the  options  in  effect  for  a  given  page.
       Options  specified on the command-line determine the default values for
       the entire job, which can be overridden on a per-page basis.

MESSAGES JOURNALIS'ES

       Les messages envoyes a la sortie d'erreur sont generalement enregistres
       dans  l'attribut  printer-state-message  et  dans  le  journal ErrorLog
       actuel. Chaque ligne commence par un prefixe standard :

       ALERT: message
            Definir l'attribut printer-state-message  et  ajouter  le  message
            donne  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation << alert >>.

       ATTR: attribut=valeur [attribut=valeur]
            Definir   l'attribut   (les   attributs)   donne(s)   du   travail
            d'impression.  Typiquement,  c'est  utilise  pour fixer l'attribut
            job-remote-id.

       CRIT: message
            Definir l'attribut printer-state-message  et  ajouter  le  message
            donne  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation << critical >>.

       DEBUG: message
            Definir l'attribut printer-state-message  et  ajouter  le  message
            donne  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation << debug >>.

       DEBUG2: message
            Definir l'attribut printer-state-message  et  ajouter  le  message
            donne  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation << debug2 >>.

       EMERG: message
            Definir l'attribut printer-state-message  et  ajouter  le  message
            donne  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation << emergency >>.

       ERROR: message
            Definir l'attribut printer-state-message  et  ajouter  le  message
            donne  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation << error >>.

       INFO: message
            Fixer   l'attribut   printer-state-message.   Si   LogLevel   vaut
            << debug2 >>,  le message est egalement ajoute au journal ErrorLog
            en utilisant le niveau << info >>.

       NOTICE: message
            Definir l'attribut printer-state-message  et  ajouter  le  message
            donne  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation << notice >>.

       PAGE: numero_page #-copies

       PAGE: total #-pages
            Ajouter une entree au fichier PageLog actuel.  La  premiere  forme
            ajoute      le      nombre      de     copies     a     l'attribut
            job-media-sheets-completed. La seconde  forme  definie  l'attribut
            job-media-sheets-completed au nombre de pages.

       PPD: Keyword=Value ... KeywordN=Value
            Sets  the  named  keywords  in  the  printer's  PPD  file. This is
            typically  used  to  update  default  option  keywords   such   as
            DefaultPageSize  and  the  various  installable options in the PPD
            file.

       STATE: raison-etat-impimante [raison-etat-impimante ...]

       STATE: + raison-etat-impimante [raison-etat-impimante ...]

       STATE: - raison-etat-impimante [raison-etat-impimante ...]
            Definir, ajouter ou retirer des mots cle raison-etat-impimante  de
            la  file  d'attente  en  cours.  Typiquement  c'est  utilise  pour
            indiquer l'etat du media, de l'encre et du toner d'une imprimante.

       WARNING: message
            Definir l'attribut printer-state-message  et  ajouter  le  message
            donne  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation << warning >>.

VARIABLES D'ENVIRONNEMENT

       Les variables d'environnement suivantes sont definies  par  le  serveur
       CUPS pour l'execution des filtres :

       CHARSET
            Definir  le  jeu  de  caracteres  par  defaut  a utiliser pour les
            textes, typiquement utf-8.

       CLASS
            Quand un travail est  soumis  a  une  classe  d'imprimantes,  elle
            contient  le  nom de la classe d'imprimante. Sinon, cette variable
            d'environnement n'est pas definie.

       CONTENT_TYPE
            Le    type    MIME    associe    au    fichier    (par     exemple
            application/postscript).

       CUPS_CACHEDIR
            The directory for semi-persistent cache files can be found.

       CUPS_DATADIR
            Le repertoire ou se trouvent les fichiers de donnees.

       CUPS_FILETYPE
            The  type of file being printed: "job-sheet" for a banner page and
            "document" for a regular print file.

       CUPS_SERVERROOT
            Le repertoire racine du serveur.

       DEVICE_URI
            L'uri du peripherique associe a l'imprimante.

       FINAL_CONTENT_TYPE
            Le   type   MIME   associe    a    l'imprimante    (par    exemple
            application/vnd.cups-postscript).

       LANG
            La locale de la langue par defaut (generalement C ou en).

       PATH
            Le  chemin d'execution par defaut pour les programmes externes qui
            peuvent etre executes par le filtre.

       PPD
            Le  chemin  complet  vers  le  fichier  PPD  (PostScript   Printer
            Description) de cette imprimante.

       PRINTER
            Le nom de l'imprimante.

       RIP_CACHE
            La  quantite  de  memoire  recommandee  pour les RIP (Raster Image
            Processors).

       SOFTWARE
            Le nom et la version du serveur (par exemple CUPS/1.2).

       TZ
            Le fuseau horaire du serveur

       USER
            L'utilisateur qui  execute  le  filtre,  typiquement  << lp >>  ou
            << root >> ;   consultez   le   fichier   cupsd.conf(5)   pour  le
            parametrage courant.

COMPATIBILIT'E

       Alors que l'interface des filtres est compatible avec  l'interface  des
       scripts  Systeme V,  elle  ne  fonctionnera  avec le script d'interface
       Systeme V que comme unique filtre. Typiquement  le  script  d'interface
       sera fournit par la commande lpadmin(8) en utilisant l'option -i.

VOIR AUSSI

       backend(7), cupsd(8),
       http://localhost:631/help

COPYRIGHT

       Copyright 2007-2009 by Apple Inc.