NOME¶
fpathconf, pathconf - obtém valores de configuração para
arquivos
SINOPSE¶
#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.
VALOR DE RETORNO¶
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.
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)
TRADUÇÃO PARA A LÍNGUA PORTUGUESA¶
RUBENS DE JESUS NOGUEIRA <darkseid99@usa.net> (tradução)
XXXXXX XX XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (revisão)