Next: , Previous: , Up: The Process Library   [Index]


13.10.4 X Shell Functions

xs_argv

list xs_argv(xshell xs);

is the command line of the process to execute for the xs shell. The list may be operated as any list library provided list, though the process library expects that only items of the intrinsic string type and the byte data library provided byte array type are present in the list when executing the process.

See The List Library.

See The Byte Data Library.

xs_exited

integer xs_exited(xshell xs, integer &exit);

is non zero if the last process executed for the xs shell has exited, 0 if it otherwise terminated, undefined if it did not complete or no process was executed for xs. Sets exit to the exit status of the executed process for the first case.

xs_fashion

void xs_fashion(xshell xs, integer s);

adds s to the xs shell flags set

See X Shell Flag Definitions.

xs_fold

void xs_fold(xshell xs, file f);

sets the file from which the process to be executed for the xs shell reads to f. The file is expect opened and readable.

xs_input

file xs_input(xshell xs);

is the file from which the process executed for the xs shell reads (same as ‘xs_write’)

xs_lead

void xs_lead(xshell xs);

starts execution of one process for the xs shell.

xs_mind

void xs_mind(xshell xs, file f);

sets the file to which the process to be executed for the xs shell writes error reports to f. The file is expect opened and writable.

xs_output

file xs_output(xshell xs);

is the file to which the process executed for the xs shell writes (same as ‘xs_read’)

xs_path

data xs_path(xshell xs);

is the path to the executable to execute for the xs shell. It is to be set before execution.

xs_pid

integer xs_pid(xshell xs);

is the process id of the process associated with the xs shell, -1 if no process associates xs. Subject to arrangements made with the application embedding the interpreter, it becomes -1 when the process started for xs terminates.

xs_pipe

void xs_pipe(xshell xs, file f);

sets the file to which the process to be executed for the xs shell writes to f. The file is expect opened and writable.

xs_read

file xs_read(xshell xs);

is the file to which the process executed for the xs shell writes (same as ‘xs_output’)

xs_refine

void xs_refine(xshell xs, integer s);

removes s from the xs shell flags set

See X Shell Flag Definitions.

xs_set

xshell xs_set(xshell &xs, xshell xt);

is xt, sets the xs shell object as a reference of the xt shell object

xs_signaled

integer xs_signaled(xshell xs, integer &signal);

is non zero if the last process executed for the xs shell was terminated by a signal, 0 if it otherwise terminated, undefined if it did not complete or no process was executed for xs. Sets signal to the signal that terminated the process for the first case.

xs_spend

void xs_spend(xshell xs);

waits for the process executed successfully for the xs shell

xs_write

file xs_write(xshell xs);

is the file from which the process executed for the xs shell reads (same as ‘xs_input’)

Process Execution

The path and command line of the executed process are expected set via the objects available through ‘xs_path’ and ‘xs_argv’, respectively. If the ‘ss_path’ set path has a zero bytes length, the first item in the command line is used instead.

The standard input, output and error for the new process are put in blocking mode.


Next: , Previous: , Up: The Process Library   [Index]