Provided by: cups_1.5.2-9ubuntu1_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 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.

       Les filtres 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 ce format de
       fichier. Toutes  les  sorties  doivent  être  envoyées  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É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 ErrorLog
       actuel. Chaque ligne commence par un préfixe standard :

       ALERT: message
            Définir l'attribut printer-state-message  et  ajouter  le  message
            donné  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation « alert ».

       ATTR: attribut=valeur [attribut=valeur]
            Définir   l'attribut   (les   attributs)   donné(s)   du   travail
            d'impression.  Typiquement,  c'est  utilisé  pour fixer l'attribut
            job-remote-id.

       CRIT: message
            Définir l'attribut printer-state-message  et  ajouter  le  message
            donné  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation « critical ».

       DEBUG: message
            Définir l'attribut printer-state-message  et  ajouter  le  message
            donné  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation « debug ».

       DEBUG2: message
            Définir l'attribut printer-state-message  et  ajouter  le  message
            donné  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation « debug2 ».

       EMERG: message
            Définir l'attribut printer-state-message  et  ajouter  le  message
            donné  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation « emergency ».

       ERROR: message
            Définir l'attribut printer-state-message  et  ajouter  le  message
            donné  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 également ajouté au journal ErrorLog en
            utilisant le niveau « info ».

       NOTICE: message
            Définir l'attribut printer-state-message  et  ajouter  le  message
            donné  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation « notice ».

       PAGE: numéro_page #-copies

       PAGE: total #-pages
            Ajouter une entrée au fichier PageLog actuel.  La  première  forme
            ajoute      le      nombre      de     copies     à     l'attribut
            job-media-sheets-completed. La seconde  forme  définie  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-état-impimante [raison-état-impimante ...]

       STATE: + raison-état-impimante [raison-état-impimante ...]

       STATE: - raison-état-impimante [raison-état-impimante ...]
            Définir, ajouter ou retirer des mots clé raison-état-impimante  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.

       WARNING: message
            Définir l'attribut printer-state-message  et  ajouter  le  message
            donné  au  journal  ErrorLog  actuel  en  utilisant  le  niveau de
            journalisation « warning ».

VARIABLES D'ENVIRONNEMENT

       Les variables d'environnement suivantes sont définies  par  le  serveur
       CUPS pour l'exécution des filtres :

       CHARSET
            Définir  le  jeu  de  caractères  par  défaut  à utiliser pour les
            textes, typiquement utf-8.

       CLASS
            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.

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

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

       CUPS_DATADIR
            Le répertoire où se trouvent les fichiers de données.

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

       CUPS_SERVERROOT
            Le répertoire racine du serveur.

       DEVICE_URI
            L'uri du périphérique associé à l'imprimante.

       FINAL_CONTENT_TYPE
            Le   type   MIME   associé    à    l'imprimante    (par    exemple
            application/vnd.cups-postscript).

       LANG
            La locale de la langue par défaut (généralement C ou en).

       PATH
            Le  chemin d'exécution par défaut pour les programmes externes qui
            peuvent être exécutés 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  quantité  de  mémoire  recommandée  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  exécute  le  filtre,  typiquement  « lp »   ou
            « root » ;  consultez le fichier cupsd.conf(5) pour le paramétrage
            courant.

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 fournit par la commande lpadmin(8) en utilisant l'option -i.

VOIR AUSSI

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

COPYRIGHT

       Copyright 2007-2011 by Apple Inc.