NOME

       confstr - ler variáveis string dependentes da configuração

SINOPSE

       #define _POSIX_C_SOURCE 2
       ou
       #define _XOPEN_SOURCE
       #include <unistd.h>

       size_t confstr(int name, char *buf, size_t len);

DESCRIÇÃO

       confstr() lê os valores de variáveis string dependentes da configuração.

       O argumento name indica a variável do sistema a ser retornada.  As seguintes variáveis são suportadas:

       _CS_PATH
              Valor da variável PATH , que indica onde podem ser encontrados os utilitários padrão POSIX.2

       Se  buf  não  for  NULL,  e  len  for  diferente de zero, confstr() copia os valores da string para buf ,
       truncando para len - 1 caracteres se necessário  e  acrescentando  um  null  ao  final.   Isto  pode  ser
       verificado comparando o valor retornado por confstr() e len.

       Se len for zero e buf for NULL, confstr() retornará o valor definido abaixo.

VALOR RETORNADO

       Se name não corresponder a uma variável de configuração válida, confstr() retorna 0.

EXEMPLOS

       O código abaixo localiza o caminho onde estão os utilitários POSIX.2.

          char *pathbuf; size_t n;

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

ERROS

       Se o valor de name for inválido, errno será EINVAL.

DE ACORDO COM

       proposta POSIX.2

BUGS

       POSIX.2 ainda não é uma norma aprovada. A informação nesta manpage pode mudar.

VER TAMBÉM

       sh(1), exec(3), system(3)

TRADUZIDO POR LDP-BR em 21/08/2000.

       Paulo César Mendes <drpc@ism.com.br> (tradução) xxxxxxxxxxxxxxxxxxxxxxxxx <xxx@xxxxxx.xxx.xx> (revisão)

GNU                                              April 17, 1993                                       CONFSTR(3)