process_t Struct Reference

Data Fields
process_status_t	status
process_protocol_t	protocol
process_read_callback_t	stdout_read_callback
process_read_callback_t	stderr_read_callback
process_exit_callback_t	exit_callback
process_exit_code_t	exit_code
char *	command
smartlist_t *	arguments
smartlist_t *	environment
buf_t *	stdout_buffer
buf_t *	stderr_buffer
buf_t *	stdin_buffer
void *	data
process_unix_t *	unix_process

Detailed Description

Structure to represent a child process.

Definition at line 36 of file process.c.

Field Documentation

arguments

smartlist_t* arguments

The arguments used for the new process. The format here is one argument per element of the smartlist_t. On Windows these arguments are combined together using the tor_join_win_cmdline function. On Unix the process name (argv[0]) and the trailing NULL is added automatically before the process is executed.

Definition at line 63 of file process.c.

Referenced by process_append_argument(), process_free_(), process_get_arguments(), process_get_argv(), and process_new().

command

char* command

Name of the command we want to execute (for example: /bin/ls).

Definition at line 56 of file process.c.

Referenced by process_exec(), process_free_(), process_get_argv(), process_get_command(), and process_new().

data

void* data

Do we need to store some custom data with the process?

Definition at line 78 of file process.c.

Referenced by process_get_data(), and process_set_data().

environment

smartlist_t* environment

The environment used for the new process.

Definition at line 66 of file process.c.

Referenced by process_free_(), process_get_environment(), process_new(), process_reset_environment(), and process_set_environment().

exit_callback

process_exit_callback_t exit_callback

Which function call when our process terminated?

Definition at line 50 of file process.c.

Referenced by process_notify_event_exit(), and process_set_exit_callback().

exit_code

process_exit_code_t exit_code

Our exit code when the process have terminated.

Definition at line 53 of file process.c.

Referenced by process_notify_event_exit().

protocol

process_protocol_t protocol

Which protocol is the process using?

Definition at line 41 of file process.c.

Referenced by process_get_protocol().

status

process_status_t status

Process status.

Definition at line 38 of file process.c.

Referenced by process_get_status(), process_new(), and process_set_status().

stderr_buffer

buf_t* stderr_buffer

Buffer to store data from stderr when it is read.

Definition at line 72 of file process.c.

Referenced by process_free_(), process_new(), and process_notify_event_stderr().

stderr_read_callback

process_read_callback_t stderr_read_callback

Which function to call when we have data ready from stderr?

Definition at line 47 of file process.c.

Referenced by process_notify_event_stderr(), and process_set_stderr_read_callback().

stdin_buffer

buf_t* stdin_buffer

Buffer to store data to stdin before it is written.

Definition at line 75 of file process.c.

Referenced by process_free_(), process_new(), process_notify_event_stdin(), and process_write().

stdout_buffer

buf_t* stdout_buffer

Buffer to store data from stdout when it is read.

Definition at line 69 of file process.c.

Referenced by process_free_(), process_new(), and process_notify_event_stdout().

stdout_read_callback

process_read_callback_t stdout_read_callback

Which function to call when we have data ready from stdout?

Definition at line 44 of file process.c.

Referenced by process_notify_event_stdout(), and process_set_stdout_read_callback().

unix_process

process_unix_t* unix_process

Our Unix process handle.

Definition at line 82 of file process.c.

Referenced by process_free_(), process_get_unix_process(), and process_new().

---

The documentation for this struct was generated from the following file:

• lib/process/process.c