BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

kexecvp - execute a command

LIBRARY CALL

int kexecvp(
   const char *arg0,
   char *const args[])

INPUT

OUTPUT

none

RETURN VALUE

Note: this call overlays the calling process with the named file, then transfers control to the new core image. If the command is successfully executed then there will be no return from the new process. If the core cannot be loaded or found then we return with an error of -1.

DESCRIPTION

This function is a replacement for the system "execvp" call. The only difference is that kexecvp() supports executing processes on remote machines.

The routine will execute another process (specified by arg0) and replace the current core image with the specified core. For example, the command:

"vfileinfo -i1 file"

would be specified as:

arg0 = "vfileinfo"

args[0] = "vfileinfo" args[1] = "-i1" args[2] = "file" args[3] = NULL

If the command is to be executed on a different machine such as "borris" then the same command would look like:

"vfileinfo@borris -i1 file"

would be specified as:

arg0 = "vfileinfo@borris"

args[0] = "vfileinfo@borris" args[1] = "-i1" args[2] = "file" args[3] = NULL

If the command is to be executed on a different machine such as "borris", and the file to be read is on "natasha" then the command would look like this:

"vfileinfo@borris -i1 file@natasha"

would be specified as:

arg0 = "vfileinfo@borris"

args[0] = "vfileinfo@borris" args[1] = "-i1" args[2] = "file@natasha" args[3] = NULL

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$BOOTSTRAP/objects/library/kutils/src/ktransport.c

SEE ALSO

kutils(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.