Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       catopen, catclose - Ouverture et fermeture d'un catalogue de messages

SYNOPSIS

       #include <nl_types.h>

       nl_catd catopen(const char *name, int flag);

       int catclose(nl_catd catalog);

DESCRIPTION

       La fonction catopen() ouvre un catalogue de messages, et en retourne un
       descripteur. Celui-ci reste  valide  jusqu'a  un  appel  catclose()  ou
       execve(2). Si un descripteur de fichier est utilise pour implementer le
       descripteur de catalogue, le drapeau FD_CLOEXEC sera defini.

       L'argument name indique le nom du catalogue a ouvrir. Si  name  indique
       un  chemin d'acces absolu (contenant un << / >> )  alors il est employe
       comme chemin d'acces au catalogue. Sinon, la  variable  d'environnement
       NLSPATH  est  utilisee,  apres  avoir  substitue name a son argument %N
       (consultez locale(7)). Lorsque le  processus  a  des  privileges  root,
       l'emploi  eventuel  de  NLSPATH n'est pas garanti. Si NLSPATH n'est pas
       definie dans l'environnement, ou si le catalogue de  messages  ne  peut
       etre  ouvert  dans  aucun des chemins qu'elle contient, alors un chemin
       predefini, dependant de l'implementation, est utilise. Ce dernier  peut
       dependre de la categorie de localisation LC_MESSAGES si l'argument flag
       vaut NL_CAT_LOCALE ou de la variable d'environnement LANG si l'argument
       flag  vaut zero. Changer la partie LC_MESSAGES de la localisation, peut
       rendre invalides les descripteurs de catalogues deja ouverts.

       L'argument flag de catopen() indique l'origine du langage  a  utiliser.
       S'il vaut NL_CAT_LOCALE alors il utilisera la configuration actuelle de
       la  localisation  definie  par  LC_MESSAGES.  Sinon,  il  utilisera  la
       variable d'environnement LANG.

       La  fonction  catclose() ferme le catalogue identifie par catalog. Ceci
       invalide toute reference ulterieure au catalogue de message defini  par
       le descripteur catalog.

VALEUR RENVOY'EE

       La  fonction  catopen() renvoie un descripteur de catalogue de messages
       du  type  nl_catd  si  elle  reussit.  En  cas  d'echec,  elle  renvoie
       (nl_catd) -1  et  definit  errno  avec  le  code  d'erreur. Les erreurs
       possibles incluent toutes celles que peut renvoyer open(2).

       La fonction catclose() renvoie 0 si elle reussit, ou -1 en cas d'echec.

ENVIRONNEMENT

       LC_MESSAGES
              Peut-etre  la  source  de  la  definition  de  la   localisation
              LC_MESSAGES  et  peut servir a determiner le langage a utiliser,
              si flag vaut NL_CAT_LOCALE.

       LANG   Le langage a utiliser, si flag vaut zero.

CONFORMIT'E

       POSIX.1-2001. L'origine des constantes  MCLoadBySet  et  MCLoadAll  est
       incertaine (consultez ci-dessous).

NOTES

       Tout  ceci  correspond  a  la  description  POSIX.1-2001.  La valeur de
       NL_CAT_LOCALE de la glibc est 1 (Comparez avec MCLoadAll plus bas).  Le
       chemin   par   defaut  varie,  mais  il  inclut  en  general  plusieurs
       emplacements sous /usr/share/locale.

   Notes sur Linux
       Ces fonctions sont disponibles sous Linux depuis la version 4.4.4.c  de
       la  libc.  Dans  le  cas  des  libc4  et libc5 Linux, le descripteur de
       catalogue nl_catd est en realite une  zone  de  memoire  de  projection
       mmap(2)  et  non  pas  un  descripteur  de  fichier. L'argument flag de
       catopen() devrait etre soit MCLoadBySet (= 0) soit MCLoadAll (= 1).  La
       premiere  valeur  indique  qu'un ensemble du catalogue doit etre charge
       quand le besoin s'en fait sentir,  alors  que  la  seconde  reclame  le
       chargement  en  memoire  des l'appel initial a catopen(). Le chemin par
       defaut varie, mais il inclut en  general  plusieurs  emplacements  sous
       /etc/locale et /usr/lib/locale.

VOIR AUSSI

       catgets(3), setlocale(3)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.27 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       etre       trouvees      a      l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis 2010, cette traduction est maintenue a l'aide  de  l'outil  po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone       au       sein        du        projet        perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/> (1996-2003),
       Alain Portal <URL:http://manpagesfr.free.fr/>  (2003-2006).   Florentin
       Duneau et l'equipe francophone de traduction de Debian (2006-2009).

       Veuillez   signaler   toute   erreur   de   traduction  en  ecrivant  a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous  pouvez  toujours avoir acces a la version anglaise de ce document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

GNU                            14 decembre 2001                     CATOPEN(3)