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)