NOMBRE

       confstr - obtiene variables cadena dependientes de la configuración

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

SINOPSIS

       #include <unistd.h>

       size_t confstr(int name, char buf[.size], size_t size);

   Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

       confstr():
           _POSIX_C_SOURCE >= 2 || _XOPEN_SOURCE

DESCRIPCIÓN

       confstr() obtiene el valor de una variable cadena dependiente de la configuración.

       El  argumento  name  es la variable del sistema a ser examinada. Se admiten las siguientes
       variables:

       _CS_GNU_LIBC_VERSION (GNU C library only; since glibc 2.3.2)
              A string which identifies the GNU C library version on this  system  (e.g.,  "glibc
              2.3.4").

       _CS_GNU_LIBPTHREAD_VERSION (GNU C library only; since glibc 2.3.2)
              A  string  which  identifies  the  POSIX  implementation supplied by this C library
              (e.g., "NPTL 2.3.4" or "linuxthreads-0.10").

       _CS_PATH
              Un valor para la variable PATH que indica dónde pueden ser  encontradas  todas  las
              utilidades POSIX.2 estándar.

       If  buf is not NULL and size is not zero, confstr()  copies the value of the string to buf
       truncated to size - 1 bytes if necessary, with a null byte ('\0') as terminator.  This can
       be detected by comparing the return value of confstr()  against size.

       Si size es cero y buf es NULL, confstr() sólo devuelve el valor como se define más abajo.

VALOR DEVUELTO

       If  name  is  a  valid  configuration  variable,  confstr()   returns  the number of bytes
       (including the terminating null byte)  that would be required to hold the entire value  of
       that  variable.  This value may be greater than size, which means that the value in buf is
       truncated.

       If name is a valid configuration variable, but that variable does not have a  value,  then
       confstr()   returns  0.   If  name  does not correspond to a valid configuration variable,
       confstr()  returns 0, and errno is set to EINVAL.

ERRORES

       EINVAL The value of name is invalid.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

       ┌────────────────────────────────────────────────┬────────────────────┬───────────────────┐
       │Interfaz                                        │ Atributo           │ Valor             │
       ├────────────────────────────────────────────────┼────────────────────┼───────────────────┤
       │confstr()                                       │ Seguridad del hilo │ Multi-hilo seguro │
       └────────────────────────────────────────────────┴────────────────────┴───────────────────┘

ESTÁNDARES

       POSIX.1-2001, POSIX.1-2008.

EJEMPLOS

       El siguiente fragmento de código determina el camino donde se encuentran las utilidades de
       sistema POSIX.2:

           char *pathbuf;
           size_t n;

           n = confstr(_CS_PATH, NULL, (size_t) 0);
           pathbuf = malloc(n);
           if (pathbuf == NULL)
               abort();
           confstr(_CS_PATH, pathbuf, n);

VÉASE TAMBIÉN

       getconf(1), sh(1), exec(3), fpathconf(3), pathconf(3), sysconf(3), system(3)

TRADUCCIÓN

       La  traducción  al  español  de  esta  página del manual fue creada por Sebastian Desimone
       <chipy@argenet.com.ar> y Gerardo Aburruzaga García <gerardo.aburruzaga@uca.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⟩.