.\" Copyright 1993 Mitchum DSouza .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" Modified Thu Dec 13 22:51:19 2001 by Martin Schulze .\" Modified 2001-12-14 aeb .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH CATOPEN 3 "14 décembre 2001" GNU "Manuel du programmeur Linux" .SH NOM catopen, catclose \- Ouverture et fermeture d'un catalogue de messages .SH SYNOPSIS \fB#include \fP .sp \fBnl_catd catopen(const char *\fP\fIname\fP\fB, int \fP\fIflag\fP\fB);\fP \fBint catclose(nl_catd \fP\fIcatalog\fP\fB);\fP .SH DESCRIPTION La fonction \fBcatopen\fP() ouvre un catalogue de messages, et en retourne un descripteur. Celui\-ci reste valide jusqu'à un appel \fBcatclose\fP() ou \fBexecve\fP(2). Si un descripteur de fichier est utilisé pour implémenter le descripteur de catalogue, le drapeau \fBFD_CLOEXEC\fP sera défini. .LP L'argument \fIname\fP indique le nom du catalogue à ouvrir. Si \fIname\fP indique un chemin d'accès absolu (contenant un «\ /\ » ) alors il est employé comme chemin d'accès au catalogue. Sinon, la variable d'environnement \fBNLSPATH\fP est utilisée, après avoir substitué \fIname\fP à son argument \fB%N\fP (consultez \fBlocale\fP(7)). Lorsque le processus à des privilèges root, l'emploi éventuel de \fBNLSPATH\fP n'est pas garanti. Si \fBNLSPATH\fP n'est pas définie dans l'environnement, ou si le catalogue de messages ne peut être ouvert dans aucun des chemins qu'elle contient, alors un chemin prédéfini, dépendant de l'implémentation, est utilisé. Ce dernier peut dépendre de la catégorie de localisation \fBLC_MESSAGES\fP si l'argument \fIflag\fP vaut \fBNL_CAT_LOCALE\fP ou de la variable d'environnement \fBLANG\fP si l'argument \fIflag\fP vaut zéro. Changer la partie \fBLC_MESSAGES\fP de la localisation, peut rendre invalides les descripteurs de catalogues déjà ouverts. .LP L'argument \fIflag\fP de \fBcatopen\fP() indique l'origine du langage à utiliser. S'il vaut \fBNL_CAT_LOCALE\fP alors il utilisera la configuration actuelle de la localisation définie par \fBLC_MESSAGES\fP. Sinon, il utilisera la variable d'environnement \fBLANG\fP. .LP La fonction \fBcatclose\fP() ferme le catalogue identifié par \fIcatalog\fP. Ceci invalide toute référence ultérieure au catalogue de message défini par le descripteur \fIcatalog\fP. .SH "VALEUR RENVOYÉE" La fonction \fBcatopen\fP() renvoie un descripteur de catalogue de messages du type \fInl_catd\fP si elle réussit. En cas d'échec, elle renvoie \fI(nl_catd)\ \-1\fP et définit \fIerrno\fP avec le code d'erreur. Les erreurs possibles incluent toutes celles que peut renvoyer \fBopen\fP(2). .LP La fonction \fBcatclose\fP() renvoie 0 si elle réussit, ou \-1 en cas d'échec. .SH ENVIRONNEMENT .TP \fBLC_MESSAGES\fP Peut\-être la source de la définition de la localisation \fBLC_MESSAGES\fP et peut servir à déterminer le langage à utiliser, si \fIflag\fP vaut \fBNL_CAT_LOCALE\fP. .TP \fBLANG\fP Le langage à utiliser, si \fIflag\fP vaut zéro. .SH CONFORMITÉ .\" In XPG 1987, Vol. 3 it says: .\" .I "The flag argument of catopen is reserved for future use" .\" .IR "and should be set to 0" . POSIX.1\-2001. L'origine des constantes \fBMCLoadBySet\fP et \fBMCLoadAll\fP est incertaine (consultez ci\-dessous). .SH NOTES Tout ceci correspond à la description POSIX.1\-2001. La valeur de \fBNL_CAT_LOCALE\fP de la glibc est 1 (Comparez avec \fBMCLoadAll\fP plus bas). Le chemin par défaut varie, mais il inclut en général plusieurs emplacements sous \fI/usr/share/locale\fP. .SS "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 \fInl_catd\fP est en réalité une zone de mémoire de projection \fBmmap\fP(2) et non pas un descripteur de fichier. L'argument \fIflag\fP de \fBcatopen\fP() devrait être soit \fBMCLoadBySet\fP (= 0) soit \fBMCLoadAll\fP (= 1). La première valeur indique qu'un ensemble du catalogue doit être chargé quand le besoin s'en fait sentir, alors que la seconde réclame le chargement en mémoire dès l'appel initial à \fBcatopen\fP(). Le chemin par défaut varie, mais il inclut en général plusieurs emplacements sous \fI/etc/locale\fP et \fI/usr/lib/locale\fP. .SH "VOIR AUSSI" \fBcatgets\fP(3), \fBsetlocale\fP(3) .SH COLOPHON Cette page fait partie de la publication 3.65 du projet \fIman\-pages\fP Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%http://www.kernel.org/doc/man\-pages/. .SH TRADUCTION Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a par l'équipe de traduction francophone au sein du projet perkamon . .PP Christophe Blaess (1996-2003), Alain Portal (2003-2006). Florentin Duneau et l'équipe francophone de traduction de Debian\ (2006-2009). .PP Veuillez signaler toute erreur de traduction en écrivant à ou par un rapport de bogue sur le paquet \fBmanpages\-fr\fR. .PP Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande «\ \fBman\ \-L C\fR \fI
\fR\ \fI\fR\ ».