CONFSTR(3)

NOME
confstr - ler seqüencias de dependentes da configuração

SINÓPSE
#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 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 NULO, e len for diferente de zero, confstr() copia os valores da seqüencia para buf , truncando para len-1 caracteres se necessário e acrescentando um NULO ao final. Isto pode ser verificado comparando o valor retornado por confstr() e len.

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

VALORES RETORNADOS
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.

PROBLEMAS
POSIX.2 ainda não é uma norma aprovada. A informação nesta página pode mudar.

VEJA TAMBÉM
sh(1), exec(3), system(3).

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

  Tradução:
Paulo César Mendes <drpc@ism.com.br>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>