FPATHCONF(3)

NOME
fpathconf, pathconf - obtém valores de configuração para arquivos

SINÓPSE
#include <unistd.h>

long fpathconf(int filedes, int name);
long pathconf(char *path, int name);

DESCRIÇÃO
fpathconf() obtém um valor para a opção de configuração name do descritor de arquivo filedes.

pathconf() obtém um valor para a opção de configuração name para o nome de arquivo path.

As macros correspondentes definidas em <unistd.h> são valores mínimos; se uma aplicação quer tomar vantagem dos valores que podem mudar, uma chamada a fpathconf() ou pathconf() pode ser feita, o que pode produzir resultados mais liberais.

Configurar name igual a uma das seguintes constantes retorna as seguintes opções de configuração:

_PC_LINK_MAX
    retorna o número máximo de ligações para o arquivo. Se filedes ou path referem-se a um diretório, então o valor se aplica ao diretório inteiro. A macro correspondente é _POSIX_LINK_MAX.

_PC_MAX_CANON
    retorna o comprimento máximo de uma linha de entrada formatada, onde filedes ou path precisa se referir a um terminal. A macro correspondente é _POSIX_MAX_CANON.

_PC_MAX_INPUT
    retorna o comprimento máximo de uma linha de entrada, onde filedes ou path precisa se referir a um terminal. A macro correspondente é _POSIX_MAX_INPUT.

_PC_NAME_MAX
    retorna o comprimento máximo de um nome de arquivo no diretório path ou filedes. o processo é permitido criar. A macro correspondente é _POSIX_NAME_MAX.

_PC_PATH_MAX
    retorna o comprimento máximo de um caminho de diretório relativo quando path ou filedes é um diretório de trabalho corrente. A macro correspondente é _POSIX_PATH_MAX.

_PC_PIPE_BUF
    retorna o tamanho de um buffer de cano, onde filedes precisa se referir a um cano ou FIFO, e path precisa se referir a uma FIFO. A macro correspondente é _POSIX_PIPE_BUF.

_PC_CHOWN_RESTRICTED
    retorna valor diferente de zero se a chamada chown(2) não pode ser usada neste arquivo. Se filedes ou path referem-se a um diretório, então isso se aplica a todos os arquivos naquele diretório. A macro correspondente é _POSIX_CHOWN_RESTRICTED.

_PC_NO_TRUNC
    retorna valor diferente de zero se o acesso a nomes de arquivo maiores que _POSIX_NAME_MAX gera um erro. A macro correspondente é _POSIX_NO_TRUNC.

_PC_VDISABLE
    retorna valor diferente de zero se o processamento especial de caracteres pode ser desabilitado, onde filedes ou path precisam se referir a um terminal.

VALORES RETORNADOS
O limite é retornado, se existir. Se o sistema não tem um limite para o recurso pedido, é retornado -1, e errno não é alterado. Se há um erro, -1 é retornado, e errno é setado para refletir a natureza do erro.

DE ACORDO COM
POSIX.1.

NOTAS
Arquivos com comprimentos de nome maiores que o valor retornado para name igual a _PC_NAME_MAX podem existir no diretório dado.

Alguns valores retornados podem ser gigantes; eles não são próprios para alocação de memória.

VEJA TAMBÉM
getconf(1), statfs(2), open(2), sysconf(3).

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

  Tradução:
Rubens de Jesus Nogueira <darkseid99@usa.net>

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