Provided by: cups_1.3.9-2_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.

       Le nom de  la  commande  (argv[0])  vaut  le  nom  de  l’imprimante  de
       destination.

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.

       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 DENVIRONNEMENT
       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_DATADIR
            Le répertoire où se trouvent les fichiers de données.

       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(1), cupsd(8),
       http://localhost:631/help

COPYRIGHT

       Copyright 2007 by Apple Inc.