Provided by: manpages-pt-dev_20040726-4_all bug

NOME
       getcwd,  get_current_dir_name,  getwd - Retorna o diretorio de trabalho
       corrente


SINOPSE
       #include <unistd.h>

       char *getcwd(char *buf, size_t size);
       char *get_current_dir_name(void);
       char *getwd(char *buf);


DESCRI,C~AO
       A funcao getcwd() copia o caminho absoluto  do  diretorio  de  trabalho
       corrente  para  o  vetor apontado por buf, que tem seu tamanho definido
       por size.

       Se o caminho absoluto corrente for  maior  do  que  o  buffer  de  size
       elementos,  entao  a  funcao ira retornar NULL e errno recebera o valor
       ERANGE; A aplicacao (ou programa) deve verificar este tipo de  erro,  e
       alocar um buffer maior se necessario.

       Como   uma   extensao  do  padrao  POSIX.1,  getcwd()  aloca  o  buffer
       dinamicamente usando a funcao malloc() se buf for NULL  no  momento  da
       chamada a funcao. Neste caso , o buffer alocado tem o tamanho de size a
       nao ser que size seja zero, quando , entao , buf e alocado  do  tamanho
       que  for  necessario.   E  possivel  (e recomendavel) executar a funcao
       free() se os buffers forem obtidos desta maneira.

       get_current_dir_name, que e prototipada somente se _GNU_SOURCE  estiver
       definido, ira malloc(3) um vetor grande o suficiente para conter o nome
       do  diretorio  corrente.  Se  a  variavel  de  ambiente   PWD   estiver
       inicializada,  e  seu  valor  estiver  correto  , entao este valor sera
       retornado.

       getwd,    que    e    prototipada    somente    se    _BSD_SOURCE    ou
       _XOPEN_SOURCE_EXTENDED  estiverem definidos, nao ira malloc(3) (alocar)
       nenhuma memoria. O argumento buf deve ser um ponteiro para um vetor  de
       tamanho minimo , em bytes , de PATH_MAX .

       getwd somente retorna os primeiros PATH_MAX bytes do caminho atual.


VALOR RETORNADO
       NULL  em  caso  de falha (por exemplo, se o diretorio corrente nao pode
       ser lido), com errno recebendo o valor de acordo com o erro, e  buf  em
       caso de sucesso.


EM CONFORMIDADE COM
       POSIX.1


VER TAMB'EM
       chdir(2), free(3), malloc(3).


TRADU,C~AO PARA A L'INGUA PORTUGUESA
       Antonio Belloni <abelloni@ig.com.br> (traducao)