process.h File Reference

#include <glib.h>
#include <gdk/gdk.h>

Include dependency graph for process.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	proc_t
Defines
#define	PS_WAIT_STARTED   (1 << 0)
#define	PS_WAIT_EXIT   (1 << 1)
#define	PS_RESPAWN   (1 << 2)
Enumerations
enum	proc_state { STATE_IDLE, STATE_STARTING, STATE_RUNNING, STATE_COMPLETED }
Functions
gboolean	process_add (const char *command, const char *working_dir, GCallback startup_callback, GCallback exit_callback, gint flags)
	Add a process to the queue. The queue is served First In First Out.
proc_t *	process_start (const char *command, const char *working_dir, GCallback startup_callback, GCallback exit_callback, gint flags)
	Start a process without queuing.
void	process_stop (proc_t *proc)
	Stop a running process.
gboolean	process_activate (const char *application)
	Activate a running process (set to top).
gboolean	process_activate_ctb (void)
	Activate content browser (set to top).
gboolean	process_startup_complete (const char *application, gint pid, gboolean is_multidoc, const char *ipc_service, gint window)
	Call when application has finished starting.
proc_t *	process_get_by_name (const char *application)
proc_t *	process_get_by_pid (GPid pid)
void	print_process_list ()

---

Define Documentation

#define PS_RESPAWN   (1 << 2)

Definition at line 49 of file process.h.

Referenced by check_respawn(), main(), on_process_exit(), and start_phase_3().

#define PS_WAIT_EXIT   (1 << 1)

Definition at line 48 of file process.h.

Referenced by check_start_next(), start_phase_2(), and start_process().

#define PS_WAIT_STARTED   (1 << 0)

File Name : process.h

Description: Process handling functions Copyright (C) 2008 iRex Technologies B.V. All rights reserved.

Definition at line 47 of file process.h.

Referenced by check_start_next(), child_new(), main(), start_medium(), start_phase_3(), and start_process().

---

Enumeration Type Documentation

enum proc_state

Enumerator:

STATE_IDLE
STATE_STARTING
STATE_RUNNING
STATE_COMPLETED

Definition at line 61 of file process.h.

{ 
    STATE_IDLE,
    STATE_STARTING,
    STATE_RUNNING,
    STATE_COMPLETED
};

---

Function Documentation

void print_process_list

(

)

Definition at line 272 of file process.c.

References proc_t::command, g_proclist, proc_t::ipc_service, proc_t::is_multidoc, and proc_t::pid.

Referenced by testing_list_tasks().

{
    GSList *proc_ptr    = g_proclist;

    printf("%s() PROCESS LIST:\n", __func__);
    int i = 0;
    while (proc_ptr)
    {
        proc_t *cur = (proc_t *) proc_ptr->data;
        printf("  [%d] cmd=%s  ipc=%s  multi=%d  pid=%d\n", i,
            cur->command, cur->ipc_service, cur->is_multidoc, cur->pid);

        proc_ptr = proc_ptr->next;
        i++;
    }
}

Here is the caller graph for this function:

gboolean process_activate

(

const char *

application

)

Activate a running process (set to top).

---------------------------------------------------------------------------

Name : process_activate

Parameters:

application

Full path of the application

Returns:

Returns TRUE on success, FALSE on failure

--------------------------------------------------------------------------

Definition at line 149 of file process.c.

References get_application_window(), LOGPRINTF, WARNPRINTF, and window_activate().

Referenced by cb_menu_item_activated(), and process_activate_ctb().

{
    LOGPRINTF("entry");
    
    gboolean result = FALSE;
    Window win_found;
    
    win_found = get_application_window(application);
    
    if (win_found != None)
    {
        window_activate(win_found);
        result = TRUE;
    }
    else
    {
        WARNPRINTF("No window found for: %s", application);
    }

    return result;
}

Here is the call graph for this function:

Here is the caller graph for this function:

gboolean process_activate_ctb

(

void

)

Activate content browser (set to top).

---------------------------------------------------------------------------

Name : process_activate_ctb

Parameters:

--

Returns:

Returns TRUE on success, FALSE on failure

--------------------------------------------------------------------------

Definition at line 172 of file process.c.

References display_get_active_window(), LOGPRINTF, process_activate(), STATE_DEVICE_STOPPING, and sys_get_device_state().

Referenced by task_activate_by_xid(), task_cleanup_pid(), and task_cleanup_window().

{
    LOGPRINTF("entry");
    
    gboolean retval = TRUE;

    if (sys_get_device_state() == STATE_DEVICE_STOPPING)
    {
        // don't activate CTB when device is shutting down
        return FALSE;
    }
    
    // set to top when not already active
    gchar *app_active = display_get_active_window();
    if (app_active && strcmp(app_active, "ctb") != 0 )
    {
        retval = process_activate("ctb");
    }
    
    return retval;
}

Here is the call graph for this function:

Here is the caller graph for this function:

gboolean process_add	(	const char *	command,
		const char *	working_dir,
		GCallback	startup_callback,
		GCallback	exit_callback,
		gint	flags
	)

Add a process to the queue. The queue is served First In First Out.

---------------------------------------------------------------------------

Name : process_add

Parameters:

	application	Full path of the application
	working_dir	Working directory, or NULL to inherit parent's
	startup_callback	Callback function when received startupCopmlete, or NULL
	exit_callback	Callback function when processes was terminated, or NULL
	flags	Bit field PS_WAIT_STARTED | PS_WAIT_EXIT | PS_RESPAWN

Returns:

Returns TRUE on success, FALSE on failure

--------------------------------------------------------------------------

Definition at line 97 of file process.c.

References check_start_next(), create_process(), and LOGPRINTF.

Referenced by main(), start_phase_2(), and start_phase_3().

{
    LOGPRINTF("entry: %s, %d", command, flags);
    
    proc_t *proc = create_process(command, working_dir, startup_callback, exit_callback, flags);
    if (proc == NULL)
    {
        return FALSE;
    }
    
    check_start_next();
    
    return TRUE;
}

Here is the call graph for this function:

Here is the caller graph for this function:

proc_t* process_get_by_name

(

const char *

application

)

Definition at line 290 of file process.c.

References proc_t::command, g_proclist, and LOGPRINTF.

Referenced by parse_wm_messages(), and task_start().

{
    LOGPRINTF("entry [%s]", application);
    
    GSList *proc_ptr    = g_proclist;

    while (proc_ptr)
    {
        proc_t *cur_proc = (proc_t *) proc_ptr->data;

        gint   argc         = 0;
        char   **argv_ptr   = NULL;
        if (g_shell_parse_argv(cur_proc->command, &argc, &argv_ptr, NULL))
        {
            gchar  *proc_app = g_path_get_basename(argv_ptr[0]);
//            LOGPRINTF("check [%s]", proc_app);
            if (application && proc_app && (strcmp(proc_app, application) == 0))
            {
//                LOGPRINTF("match [%s] pid [%d]", proc_app, cur_proc->pid);
                g_free(proc_app);
                return cur_proc;
            }
            g_free(proc_app);
            g_strfreev(argv_ptr);
        }
        proc_ptr = proc_ptr->next;
    }
    
    return NULL;
}

Here is the caller graph for this function:

proc_t* process_get_by_pid

(

GPid

pid

)

Definition at line 248 of file process.c.

References proc_t::command, g_proclist, proc_t::ipc_service, LOGPRINTF, and proc_t::pid.

Referenced by process_startup_complete(), and task_add().

{
    LOGPRINTF("entry  pid [%d]", pid);
    
    GSList *proc_ptr = g_proclist;
    proc_t *cur_proc = NULL;
    
    while (proc_ptr)
    {
        cur_proc = (proc_t *) proc_ptr->data;
        
        if (cur_proc->pid == pid)
        {
            LOGPRINTF("found [%p] command [%s] ipc service [%s]", cur_proc, cur_proc->command, cur_proc->ipc_service);
            return cur_proc;
        }
            
        proc_ptr = proc_ptr->next;
    }
    
    return NULL;
}

Here is the caller graph for this function:

proc_t* process_start	(	const char *	command,
		const char *	working_dir,
		GCallback	startup_callback,
		GCallback	exit_callback,
		gint	flags
	)

Start a process without queuing.

---------------------------------------------------------------------------

Name : process_start

Parameters:

	application	Full path of the application
	working_dir	Working directory, or NULL to inherit parent's
	startup_callback	Callback function when received startupCopmlete, or NULL
	exit_callback	Callback function when processes was terminated, or NULL
	flags	Bit field PS_WAIT_STARTED | PS_RESPAWN

Returns:

Process created and started, or NULL on error.

--------------------------------------------------------------------------

Definition at line 113 of file process.c.

References create_process(), destroy_process(), LOGPRINTF, and start_process().

Referenced by child_new(), and start_medium().

{
    LOGPRINTF("entry: %s, %d", command, flags);
    
    gboolean result = FALSE;
    
    proc_t *proc = create_process(command, working_dir, startup_callback, exit_callback, flags);
    if (proc == NULL)
    {
        return NULL;
    }
    
    result = start_process(proc);
    if (result == FALSE)
    {
        LOGPRINTF("failed to spawn, remove from list");
        destroy_process(proc);
        proc = NULL;
    }
    
    return proc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

gboolean process_startup_complete	(	const char *	application,
		gint	pid,
		gboolean	is_multidoc,
		const char *	ipc_service,
		gint	window
	)

Call when application has finished starting.

---------------------------------------------------------------------------

Name : process_startup_complete

Parameters:

	application	Full path of the application
	pid	Process ud
	is_multidoc	TRUE if multiple documents are supported, FALSE otherwise
	ipc_service	IPC service
	window	Window id

Returns:

Returns TRUE on success, FALSE on failure

--------------------------------------------------------------------------

Definition at line 195 of file process.c.

References check_start_next(), display_set_ctb_window(), g_process_pending_source, proc_t::ipc_service, proc_t::is_multidoc, LOGPRINTF, post_process_startup(), process_get_by_pid(), proc_t::startup_callback, proc_t::state, STATE_RUNNING, STATE_STARTING, and WARNPRINTF.

Referenced by cb_startup_complete().

{
    LOGPRINTF("entry");
    gboolean retval = FALSE;
    
    // find proc by pid
    proc_t *proc = process_get_by_pid(pid);

    if (proc == NULL)
    {
        WARNPRINTF("%s (pid %d) is not started sysd", application, pid);
    }
    else if (proc->state != STATE_STARTING)
    {
        WARNPRINTF("unexpected startupComplete received from %s (pid %d), state [%d]", application, pid, proc->state);
    }
    else
    {
        // stop pending timeout
        if (g_process_pending_source)
        { 
            g_source_remove(g_process_pending_source);
            g_process_pending_source = 0;
        }

        LOGPRINTF("received startupComplete from %s (pid %d, window %d), new state STATE_RUNNING", application, pid, window);
        if (strcmp(application, "ctb") == 0) {
            display_set_ctb_window(window);
        }
        
        // update process info
        proc->state = STATE_RUNNING;
        proc->is_multidoc = is_multidoc;
        proc->ipc_service = g_strdup(ipc_service);

        // do post startup actions
        post_process_startup(proc, application, window);
        
        // call post startup callback
        if (proc->startup_callback)
        {
            (proc->startup_callback)();
        }

        // start next process
        check_start_next();
        
        retval = TRUE;
    }
    return retval;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void process_stop

(

proc_t *

proc

)

Stop a running process.

---------------------------------------------------------------------------

Name : process_stop

Parameters:

process

The process to be stopped

Returns:

--

--------------------------------------------------------------------------

Definition at line 137 of file process.c.

References proc_t::command, LOGPRINTF, and proc_t::pid.

Referenced by stop_medium().

{
    g_assert(proc);
    LOGPRINTF("entry: %s, %d", proc->command, proc->pid);
    
    if (proc && proc->pid > 0)
    {
        kill(proc->pid, SIGTERM);
    }
}

Here is the caller graph for this function: