.\" Copyright (c) 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)exec.3	6.4 (Berkeley) 4/19/91
.\"
.\" Converted for Linux, Mon Nov 29 11:12:48 1993, faith@cs.unc.edu
.\" Updated more for Linux, Tue Jul 15 11:54:18 1997, pacman@cqc.com
.\"
.TH EXEC 3  "29/11/1993" "Pgina de Manual do BSD" "Manual do Programador do Linux"
.SH NOME
execl, execlp, execle, execv, execvp \- executa um arquivo
.SH SINOPSE
.B #include <unistd.h>
.sp
.B extern char **environ;
.sp
.BI "int execl( const char *" path ", const char *" arg ", ...);
.br
.BI "int execlp( const char *" file ", const char *" arg ", ...);
.br
.BI "int execle( const char *" path ", const char *" arg
.BI ", ..., char * const " envp "[]);"
.br
.BI "int execv( const char *" path ", char *const " argv "[]);"
.br
.BI "int execvp( const char *" file ", char *const " argv "[]);"
.SH DESCRIO
A famlia de funes
.B exec
substitui a imagem do processo atual por uma imagem de um novo processo. As
funes descritas nesta pgina de manual so front-ends
para a funo
.BR execve (2).
(Veja a pgina de manual de
.B execve
para informaes detalhadas sobre a substituio do processo atual.)
.PP
O argumento inicial para estas funes  o nome de caminho de um
arquivo a ser executado.
.PP
O argumento
.I "const char *arg"
e as reticncias que o seguem nas funes
.BR execl ,
.BR execlp ,
e
.B execle
podem ser vistos como
.IR arg0 ,
.IR arg1 ,
\&...,
.IR argn .
Juntos eles descrevem uma lista de um ou mais ponteiros para strings
terminadas em '\\0' que representam a lista de argumentos disponvel ao
programa executado.  O primeiro argumento, por conveno, deveria apontar
para o nome do arquivo associado ao arquivo sendo executado.  A lista de
argumentos
.I deve
ser terminada por um ponteiro
.B NULL .
.PP
As funes
.B execv
e
.B execvp
fornecem um vetor de ponteiros para strings
terminadas em '\\0' que representam a lista de argumentos disponvel ao novo
programa.  O primeiro argumento, por conveno, deveria apontar para o nome
do arquivo associado ao arquivo sendo executado.  O vetor de ponteiros
.I deve
ser terminado por um ponteiro
.B NULL .
.PP
A funo
.B execle
especifica tambm o ambiente do processo executado atravs de um parmetro
adicional que vem depois do ponteiro
.B NULL
que termina a lista de argumentos na lista de parmetros ou depois do
ponteiro para o vetor argv.  Este parmetro adicional  um vetor de ponteiros
para strings terminadas em '\\0' e
.I deve
ser terminado por um ponteiro
.B NULL . 
As outras funes obtm o ambiente para a imagem do novo processo da
varivel externa
.I environ
no processo atual.
.PP
Algumas destas funes tm uma semntica especial.
.PP
As funes
.B execlp
e
.B execvp
duplicaro as aes do shell na busca por um arquivo executvel se o nome de
arquivo especificado no contm um caractere barra (/).  O
caminho da busca  o caminho especificado no ambiente atravs da varivel
.B PATH.
Se esta varivel no est especificada, o caminho padro
``:/bin:/usr/bin''  utilizado.  Alm disso, alguns erros so tratados de
maneira especial.
.PP
Se a permisso  negada para um arquivo (a tentativa de
.B execve
retornou
.BR EACCES ),
estas funes vo continuar pesquisando o resto do caminho de busca.  Se
nenhum outro arquivo for encontrado, entretanto, elas iro retornar com a
varivel global
.I errno
contendo o valor
.BR EACCESS .
.PP
Se um cabealho de um arquivo no for reconhecido (a tentativa de
.B execve
retrnou
.BR ENOEXEC ),
estas funes iro executar o shell com o caminho do arquivo como seu
primeiro argumento.  (Se esta tentativa falhar, nenhuma busca adicional 
realizada.)
.SH "VALORES DE RETORNO"
Se qualquer das funes
.B exec
retornar, um erro ter ocorrido.  O valor de retorno  \-1, e a varivel
global
.I errno
ser ajustada para indicar o erro.
.SH ARQUIVOS
.I /bin/sh
.SH ERROS
Todas essas funes podem falhar e ajustar
.I errno
para qualquer um dos erros especificados pela funo de biblioteca
.BR execve (2).
.SH "VEJA TAMBM"
.BR sh (1),
.BR execve (2),
.BR fork (2),
.BR environ (5),
.BR ptrace (2)
.SH COMPATIBILIDADE
Em alguns outros sistemas o \fBPATH\fR padro possui o diretrio de trabalho
atual listado depois de
.I /bin
e
.IR /usr/bin ,
como uma medida anti-cavalo-de-Tria.  De acordo com a libc 5.4.7, o Linux
ainda usa o tradicional "diretrio atual primeiro" no \fBPATH\fR padro.
.PP
O comportamento de
.B execlp
e
.B execvp
quando erros ocorrem durante uma tentativa de executar um arquivo  prtica
histrica, mas no tem sido documentado tradicionalmente e no 
especificado pelo padro 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.
.PP
Tradicionalmente, as funes
.B execlp
e
.B execvp
ignoravam todos os erros exceto os descritos acima e
.B ENOMEM
e
.BR E2BIG ,
nos quais elas retornavam.  Agora elas retornam se qualquer erro alm dos
descritos acima ocorrer.
.SH "PADRES"
.BR Execl ,
.BR execv ,
.BR execle ,
.B execlp
e
.B execvp
esto de acordo com
IEEE Std1003.1-88 (``POSIX.1'').
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWFelipe Pereira <Felipe.Pereira@ic.unicamp.br> (traduo)\fR
\&\fR\&\f(CWxxxxxxxxxxxxxxxxxxxxxxxxxxx <em@il-revisor.br> (reviso)\fR