NOME

       execl, execlp, execle, execv, execvp - executa um arquivo

SINOPSE

       #include <unistd.h>

       extern char **environ;

       int execl( const char *path, const char *arg, ...);
       int execlp( const char *file, const char *arg, ...);
       int execle( const char *path, const char *arg , ..., char * const envp[]);
       int execv( const char *path, char *const argv[]);
       int execvp( const char *file, char *const argv[]);

DESCRIÇÃO

       A  família  de funções exec substitui a imagem do processo atual por uma imagem de um novo
       processo. As funções descritas nesta  página  de  manual  são  front-ends  para  a  função
       execve(2).   (Veja  a  página  de  manual  de  execve  para informações detalhadas sobre a
       substituição do processo atual.)

       O argumento inicial para estas funções é o nome de caminho de um arquivo a ser executado.

       O argumento const char *arg e as reticências que o seguem nas  funções  execl,  execlp,  e
       execle podem ser vistos como arg0, arg1, ..., argn.  Juntos eles descrevem uma lista de um
       ou mais ponteiros para strings terminadas em '\0' que representam a  lista  de  argumentos
       disponível  ao  programa  executado.  O primeiro argumento, por convenção, deveria apontar
       para o nome do arquivo associado ao arquivo sendo executado.  A lista de  argumentos  deve
       ser terminada por um ponteiro NULL .

       As  funções  execv e execvp fornecem um vetor de ponteiros para strings terminadas em '\0'
       que representam a lista de argumentos disponível ao novo programa.  O primeiro  argumento,
       por  convenção,  deveria  apontar  para  o  nome  do  arquivo  associado  ao arquivo sendo
       executado.  O vetor de ponteiros deve ser terminado por um ponteiro NULL .

       A função execle especifica também o ambiente do processo executado através de um parâmetro
       adicional  que  vem  depois do ponteiro NULL que termina a lista de argumentos na lista de
       parâmetros ou depois do ponteiro para o vetor argv.  Este parâmetro adicional é  um  vetor
       de  ponteiros  para strings terminadas em '\0' e deve ser terminado por um ponteiro NULL .
       As outras funções obtêm o ambiente para a imagem do  novo  processo  da  variável  externa
       environ no processo atual.

       Algumas destas funções têm uma semântica especial.

       As funções execlp e execvp duplicarão as ações do shell na busca por um arquivo executável
       se o nome de arquivo especificado não contém um caractere barra (/).  O caminho da busca é
       o  caminho  especificado  no ambiente através da variável PATH.  Se esta variável não está
       especificada, o caminho padrão ``:/bin:/usr/bin'' é utilizado.  Além disso,  alguns  erros
       são tratados de maneira especial.

       Se  a  permissão  é  negada para um arquivo (a tentativa de execve retornou EACCES), estas
       funções vão continuar pesquisando o resto do caminho de busca.  Se  nenhum  outro  arquivo
       for  encontrado,  entretanto,  elas  irão  retornar com a variável global errno contendo o
       valor EACCESS.

       Se um cabeçalho de um arquivo não for reconhecido (a tentativa de execve retrnou ENOEXEC),
       estas  funções irão executar o shell com o caminho do arquivo como seu primeiro argumento.
       (Se esta tentativa falhar, nenhuma busca adicional é realizada.)

VALORES DE RETORNO

       Se qualquer das funções exec retornar, um erro terá ocorrido.  O valor de retorno é -1,  e
       a variável global errno será ajustada para indicar o erro.

ARQUIVOS

       /bin/sh

ERROS

       Todas  essas funções podem falhar e ajustar errno para qualquer um dos erros especificados
       pela função de biblioteca execve(2).

VEJA TAMBÉM

       sh(1), execve(2), fork(2), environ(5), ptrace(2)

COMPATIBILIDADE

       Em alguns outros sistemas o PATH padrão possui  o  diretório  de  trabalho  atual  listado
       depois  de  /bin  e  /usr/bin, como uma medida anti-cavalo-de-Tróia.  De acordo com a libc
       5.4.7, o Linux ainda usa o tradicional "diretório atual primeiro" no PATH padrão.

       O comportamento de execlp e execvp quando erros ocorrem durante uma tentativa de  executar
       um  arquivo  é  prática  histórica,  mas não tem sido documentado tradicionalmente e não é
       especificado  pelo  padrão  POSIX.  O  BSD  (e  possivelmente  outros  sistemas)   realiza
       automaticamente  uma  espera e tenta novamente se ETXTBSY é encontrado. O Linux trata isso
       como um erro grave e retorna imediatamente.

       Tradicionalmente, as funções execlp e execvp ignoravam todos os erros exceto os  descritos
       acima  e  ENOMEM e E2BIG, nos quais elas retornavam.  Agora elas retornam se qualquer erro
       além dos descritos acima ocorrer.

PADRÕES

       Execl, execv, execle, execlp e execvp estão de acordo com IEEE Std1003.1-88 (``POSIX.1'').

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

       Felipe  Pereira  <Felipe.Pereira@ic.unicamp.br>   (tradução)   xxxxxxxxxxxxxxxxxxxxxxxxxxx
       <em@il-revisor.br> (revisão)