Ns_Exec(3aolserver)					   AOLserver Library Procedures 				       Ns_Exec(3aolserver)

__________________________________________________________________________________________________________________________________________________

NAME

       Ns_ExecArgblk,  Ns_ExecArgv,  Ns_ExecProc,  Ns_ExecProcess,  Ns_Fork,  Ns_GetEnviron, Ns_WaitForProcess, Ns_WaitProcess, ns_fork - External
       process execution

SYNOPSIS

       #include "ns.h"

       int
       Ns_ExecArgblk(char *exec, char *dir, int fdin, int fdout,
		     char *args, Ns_Set *env)

       int
       Ns_ExecArgv(char *exec, char *dir, int fdin, int fdout,
		   char **argv, Ns_Set *env)

       int
       Ns_ExecProc(char *exec, char **argv)

       int
       Ns_ExecProcess(char *exec, char *dir, int fdin, int fdout,
		      char *args, Ns_Set *env)

       int
       Ns_Fork(void)

       char
       **Ns_GetEnviron(void)

       int
       Ns_WaitForProcess(int pid, int *statusPtr)

       int
       Ns_WaitProcess(int pid)

       int
       ns_fork(void)
_________________________________________________________________

DESCRIPTION

       These functions handle fork and exec operations. See files: nsd/exec.c, nsd/tclenv.c and nsthread/fork.c.

       Ns_ExecArgblk(exec, dir, fdin, fdout, args, env)

	      Executes a command in a child process. Return process id of child process exec'ing the command or -1 on failure.	Provides  extended
	      error checking and error messages.

       Ns_ExecArgv(exec, dir, fdin, fdout, argv, env)

	      Execute a command in a child process using fork(2) and execve(2), returns the process id of child process exec'ing the command or -1
	      on failure. The child sends an extended error message to the parent.

       Ns_ExecProc(exec, argv)

	      Executes a command in a child process. Returns the process id of the child process exec'ing the command or -1 on	failure.   Simpli-
	      fies call to Ns_ExecArgv.

       Ns_ExecProcess(exec, dir, fdin, fdout, args, env)

	      Executes	a  command  in	a child process. Returns the process id of the child process exec'ing the command or -1 on failure.  Calls
	      Ns_ExecArgblk with same arguments.

       Ns_Fork()
	      Posix style fork(), using fork1() on Solaris if needed. See fork(2) man page. Calls ns_fork.

       Ns_GetEnviron()

	      Returns pointer to the environment vector.

       Ns_WaitForProcess(pid, statusPtr)

	      Wait for child process. Returns NS_OK on success, or NS_ERROR on failure. *statusPtr is set to the exit code of the child process.

       Ns_WaitProcess(pid)

	      Wait for child process. Calls Ns_WaitForProcess with NULL statusPtr. Returns NS_OK on success, or NS_ERROR on failure.

       ns_fork()

	      Posix style fork(), using fork1() on Solaris if needed.

SEE ALSO

       nsd(1), info(n)

KEYWORDS

AOLserver								4.0						       Ns_Exec(3aolserver)