Provided by: manpages-es-dev_4.13-4_all 
NOMBRE
catopen, catclose - abre/cierra un catálogo de mensajes
SINOPSIS
#include <nl_types.h>
nl_catd catopen(const char *name, int flag);
int catclose(nl_catd catalog);
DESCRIPCIÓN
La función catopen() abre un catálogo de mensajes y devuelve un descriptor de catálogo. El
descriptor permanece válido hasta una llamada a catclose() o execve(2). Si un descriptor
de fichero es utilizado para implementar descriptores de catálogo la bandera FD_CLOEXEC es
activada.
El argumento name espeficica el nombre del catálogo de mensajes a ser abierto. Si name
especifica un camino absoluto (i.e. contiene una '/'), entonces name especifica un nombre
de camino para el catálogo de mensajes. Si no, se usa la variable de ambiente NLSPATH
donde %N se sustituirá por name (vea locale(7)). Es indefinido si NLSPATH será utilizado
cuando un proceso tenga privilegios de superusuario. Si NLSPATH no existe en el entorno, o
si un catálogo de mensajes no se puede abrir en ninguno de los caminos especificados por
esa variable, se utiliza un camino definido por la implementación. Este camino por defecto
puede depender de LC_MESSAGES cuando el argumento flag es NL_CAT_LOCALE y de la variable
de entorno LANG cuando el argumento flag es 0. Cambiar la variable de localización
LC_MESSAGES puede invalidar los descriptores de catálogos abiertos.
El argumento flag de catopen() se emplea para indicar el origen para el idioma a utilizar.
Si vale NL_CAT_LOCALE usará la configuración de localización actual para LC_MESSAGES. En
otro caso usará la variable de entorno LANG.
La función catclose() cierra el catálogo de mensajes identificado por catalog. Esto
invalida cualquier referencia posterior al catálogo de mensajes definido por catalog.
VALOR DEVUELTO
La función catopen() devuelve un descritor de catálogo de mensajes de tipo nl_catd en caso
de éxito. En caso de fallo devuelve (nl_catd) -1 -1 y modifica errno para indicar el
error. Los posibles valores de error incluyen todos los posibles valores para la llamada
open(2).
La función catclose() devuelve 0 en caso de éxito, o -1 en caso de fallo.
ENTORNO
LC_MESSAGES
Puede ser el origen de la configuración de localización LC_MESSAGES, y por tanto
determina el idioma a usar si flag vale NL_CAT_LOCALE.
LANG El idioma a utilizar si flag vale 0.
ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
┌───────────┬────────────────────┬───────────────────┐
│Interfaz │ Atributo │ Valor │
├───────────┼────────────────────┼───────────────────┤
│catopen() │ Seguridad del hilo │ MT-Safe env │
├───────────┼────────────────────┼───────────────────┤
│catclose() │ Seguridad del hilo │ Multi-hilo seguro │
└───────────┴────────────────────┴───────────────────┘
CONFORME A
POSIX.1-2001, POSIX.1-2008.
NOTAS
Esta es la descripción de POSIX.1. El valor de glibc para NL_CAT_LOCALE es 1. El camino
por defecto varía, pero normalmente se suele buscar en un número de sitios por debajo de
/usr/share/locale.
VÉASE TAMBIÉN
catgets(3), setlocale(3)
COLOFÓN
Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una
descripción del proyecto, información sobre cómo informar errores y la última versión de
esta página en https://www.kernel.org/doc/man-pages/.
TRADUCCIÓN
La traducción al español de esta página del manual fue creada por Sebastian Desimone
<chipy@argenet.com.ar>, Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es> y Miguel
Pérez Ibars <mpi79470@alu.um.es>
Esta traducción es documentación libre; lea la GNU General Public License Version 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ o posterior con respecto a las condiciones de
copyright. No existe NINGUNA RESPONSABILIDAD.
Si encuentra algún error en la traducción de esta página del manual, envíe un correo
electrónico a debian-l10n-spanish@lists.debian.org ⟨⟩.