GvaProcess

GvaProcess — An abstraction of a UNIX process

Synopsis




                    GvaProcessPrivate;
                    GvaProcess;
GvaProcess*         gva_process_new                     (GPid pid,
                                                         gint priority,
                                                         gint standard_input,
                                                         gint standard_output,
                                                         gint standard_error);
GvaProcess*         gva_process_spawn                   (const gchar *command_line,
                                                         gint priority,
                                                         GError **error);
gboolean            gva_process_write_stdin             (GvaProcess *process,
                                                         const gchar *data,
                                                         gssize length,
                                                         GError **error);
guint               gva_process_stdout_num_lines        (GvaProcess *process);
guint               gva_process_stderr_num_lines        (GvaProcess *process);
gchar*              gva_process_stdout_read_line        (GvaProcess *process);
gchar*              gva_process_stderr_read_line        (GvaProcess *process);
gchar**             gva_process_stdout_read_lines       (GvaProcess *process);
gchar**             gva_process_stderr_read_lines       (GvaProcess *process);
guint               gva_process_get_progress            (GvaProcess *process);
void                gva_process_set_progress            (GvaProcess *process,
                                                         guint progress);
gboolean            gva_process_has_exited              (GvaProcess *process,
                                                         gint *status);
void                gva_process_kill                    (GvaProcess *process);
void                gva_process_kill_all                (void);
void                gva_process_get_time_elapsed        (GvaProcess *process,
                                                         GTimeVal *time_elapsed);


Object Hierarchy


  GObject
   +----GvaProcess
         +----GvaMameProcess

Properties


  "pid"                      guint                 : Read / Write / Construct Only
  "priority"                 gint                  : Read / Write / Construct Only
  "progress"                 guint                 : Read / Write
  "stderr"                   gint                  : Read / Write / Construct Only
  "stdin"                    gint                  : Read / Write / Construct Only
  "stdout"                   gint                  : Read / Write / Construct Only

Signals


  "exited"                                         : Run First
  "stderr-ready"                                   : Run Last
  "stdout-ready"                                   : Run Last

Description

Details

GvaProcessPrivate

typedef struct _GvaProcessPrivate GvaProcessPrivate;


GvaProcess

typedef struct _GvaProcess GvaProcess;


gva_process_new ()

GvaProcess*         gva_process_new                     (GPid pid,
                                                         gint priority,
                                                         gint standard_input,
                                                         gint standard_output,
                                                         gint standard_error);

pid :

priority :

standard_input :

standard_output :

standard_error :

Returns :


gva_process_spawn ()

GvaProcess*         gva_process_spawn                   (const gchar *command_line,
                                                         gint priority,
                                                         GError **error);

command_line :

priority :

error :

Returns :


gva_process_write_stdin ()

gboolean            gva_process_write_stdin             (GvaProcess *process,
                                                         const gchar *data,
                                                         gssize length,
                                                         GError **error);

process :

data :

length :

error :

Returns :


gva_process_stdout_num_lines ()

guint               gva_process_stdout_num_lines        (GvaProcess *process);

process :

Returns :


gva_process_stderr_num_lines ()

guint               gva_process_stderr_num_lines        (GvaProcess *process);

process :

Returns :


gva_process_stdout_read_line ()

gchar*              gva_process_stdout_read_line        (GvaProcess *process);

process :

Returns :


gva_process_stderr_read_line ()

gchar*              gva_process_stderr_read_line        (GvaProcess *process);

process :

Returns :


gva_process_stdout_read_lines ()

gchar**             gva_process_stdout_read_lines       (GvaProcess *process);

process :

Returns :


gva_process_stderr_read_lines ()

gchar**             gva_process_stderr_read_lines       (GvaProcess *process);

process :

Returns :


gva_process_get_progress ()

guint               gva_process_get_progress            (GvaProcess *process);

process :

Returns :


gva_process_set_progress ()

void                gva_process_set_progress            (GvaProcess *process,
                                                         guint progress);

process :

progress :


gva_process_has_exited ()

gboolean            gva_process_has_exited              (GvaProcess *process,
                                                         gint *status);

process :

status :

Returns :


gva_process_kill ()

void                gva_process_kill                    (GvaProcess *process);

process :


gva_process_kill_all ()

void                gva_process_kill_all                (void);


gva_process_get_time_elapsed ()

void                gva_process_get_time_elapsed        (GvaProcess *process,
                                                         GTimeVal *time_elapsed);

process :

time_elapsed :

Property Details

The "pid" property

  "pid"                      guint                 : Read / Write / Construct Only

Default value: 0


The "priority" property

  "priority"                 gint                  : Read / Write / Construct Only

Default value: 200


The "progress" property

  "progress"                 guint                 : Read / Write

Default value: 0


The "stderr" property

  "stderr"                   gint                  : Read / Write / Construct Only

Allowed values: >= -1

Default value: -1


The "stdin" property

  "stdin"                    gint                  : Read / Write / Construct Only

Allowed values: >= -1

Default value: -1


The "stdout" property

  "stdout"                   gint                  : Read / Write / Construct Only

Allowed values: >= -1

Default value: -1

Signal Details

The "exited" signal

void                user_function                      (GvaProcess *gvaprocess,
                                                        gint        arg1,
                                                        gpointer    user_data)       : Run First

gvaprocess :

the object which received the signal.

arg1 :

user_data :

user data set when the signal handler was connected.

The "stderr-ready" signal

void                user_function                      (GvaProcess *gvaprocess,
                                                        gpointer    user_data)       : Run Last

gvaprocess :

the object which received the signal.

user_data :

user data set when the signal handler was connected.

The "stdout-ready" signal

void                user_function                      (GvaProcess *gvaprocess,
                                                        gpointer    user_data)       : Run Last

gvaprocess :

the object which received the signal.

user_data :

user data set when the signal handler was connected.