EXECL.3
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:5k
源码类别:

操作系统开发

开发平台:

WINDOWS

  1. EXECL(3)                  Minix Programmer's Manual                   EXECL(3)
  2. NAME
  3.      execl, execv, execle, execlp, execvp, exec, environ - execute a file
  4. SYNOPSIS
  5.      #include <unistd.h>
  6.      int execl(const char *name, const char *arg0, ..., (char *) NULL)
  7.      int execv(const char *name, char *const argv[])
  8.      int execle(const char *name, const char *arg0, ..., (char *)  NULL,  char
  9.            *const envp[])
  10.      int execlp(const char *name, const char *arg0, ..., (char *) NULL)
  11.      int execvp(const char *name, char *const argv[])
  12.      extern char *const *environ;
  13. DESCRIPTION
  14.      These routines provide various interfaces  to  the  execve  system  call.
  15.      Refer  to  execve(2)  for  a  description of their properties; only brief
  16.      descriptions are provided here.
  17.      Exec in all its forms overlays the calling process with the  named  file,
  18.      then  transfers  to the entry point of the core image of the file.  There
  19.      can be no return from a successful exec; the calling core image is lost.
  20.      The name argument is a pointer to the name of the file  to  be  executed.
  21.      The   pointers  arg[0],  arg[1]  ...   address  null-terminated  strings.
  22.      Conventionally arg[0] is the name of the file.
  23.      Two interfaces are available.  execl is useful when  a  known  file  with
  24.      known arguments is being called; the arguments to execl are the character
  25.      strings constituting the file and the arguments; the  first  argument  is
  26.      conventionally the same as the file name (or its last component).  A null
  27.      pointer argument must end the  argument  list.   (Note  that  the  execl*
  28.      functions  are  variable argument functions.  This means that the type of
  29.      the arguments beyond arg0 is not checked.  So the null  pointer  requires
  30.      an explicit cast to type (char *) if not of that type already.)
  31.      The execv version is useful when the number of arguments  is  unknown  in
  32.      advance;  the  arguments to execv are the name of the file to be executed
  33.      and a vector of strings containing  the  arguments.   The  last  argument
  34.      string must be followed by a null pointer.
  35.      When a C program is executed, it is called as follows:
  36.           int main(int argc, char *const argv[], char *const envp[]);
  37.           exit(main(argc, argv, envp));
  38. 5BSD                             April 25, 1986                              1
  39. EXECL(3)                  Minix Programmer's Manual                   EXECL(3)
  40.      where argc is the argument count  and  argv  is  an  array  of  character
  41.      pointers   to   the   arguments   themselves.    As  indicated,  argc  is
  42.      conventionally at least one and the first member of the array points to a
  43.      string containing the name of the file.
  44.      Argv is directly usable in another execv because argv[argc] is 0.
  45.      Envp is a pointer to an array of strings that constitute the  environment
  46.      of  the  process.   Each  string  consists of a name, an "=", and a null-
  47.      terminated value.  The array of pointers is terminated by a null pointer.
  48.      The  shell  sh(1)  passes  an  environment  entry  for  each global shell
  49.      variable defined when the program is called.   See  environ(7)  for  some
  50.      conventionally  used  names.   The  C run-time start-off routine places a
  51.      copy of envp in the global cell environ, which is used by execv and execl
  52.      to  pass  the  environment  to  any  subprograms  executed by the current
  53.      program.
  54.      Execlp and execvp are called with the same arguments as execl and  execv,
  55.      but  duplicate the shell's actions in searching for an executable file in
  56.      a  list  of  directories.   The  directory  list  is  obtained  from  the
  57.      environment variable PATH.  Under standard Minix, if a file is found that
  58.      is executable, but does not have the proper executable header then it  is
  59.      assumed  to  be  a  shell  script.   Execlp and execvp execute /bin/sh to
  60.      interpret the script.  Under Minix-vmd this does  not  happen,  a  script
  61.      must  begin with #! and the full path name of the interpreter if it is to
  62.      be an executable script.
  63. SEE ALSO
  64.      execve(2), fork(2), environ(7), sh(1).
  65. DIAGNOSTICS
  66.      If the file cannot be found, if it is not  executable,  if  it  does  not
  67.      start  with  a  valid  magic  number (see a.out(5)), if maximum memory is
  68.      exceeded,  or  if  the  arguments  require  too  much  space,  a   return
  69.      constitutes  the  diagnostic;  the return value is -1 and errno is set as
  70.      for execve.  Even for the  super-user,  at  least  one  of  the  execute-
  71.      permission bits must be set for a file to be executed.
  72. 5BSD                             April 25, 1986                              2