connectionMgr/inc/pingThread.h File Reference

Check whether IDS server can be reached. More...

#include <gtk/gtk.h>
#include <glib.h>
#include <liberregxml/erregapi.h>

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

Go to the source code of this file.

Classes
struct	ping_thread_parms
Enumerations
enum	ping_status_t { PING_IDLE = 0, PING_RUNNING, PING_ABORTING, PING_UNDEFINED }
Functions
gboolean	pingThread_start (ping_thread_parms *ping_parms)
gboolean	pingThread_stop (void)
gboolean	pingThread_wait (int timeout_sec)
gboolean	pingThread_stopped (void)

---

Detailed Description

Check whether IDS server can be reached.

Copyright (C) 2007 iRex Technologies BV.

Definition in file pingThread.h.

---

Enumeration Type Documentation

enum ping_status_t

Enumerator:

PING_IDLE
PING_RUNNING
PING_ABORTING
PING_UNDEFINED

Definition at line 33 of file pingThread.h.

        {
            PING_IDLE = 0,   // ping-thread not running
            PING_RUNNING,    // ping-thread started and connecting to server
            PING_ABORTING,   // ping-thread running but not wanted anymore
            PING_UNDEFINED
        } ping_status_t;

---

Function Documentation

gboolean pingThread_start

(

ping_thread_parms *

ping_parms

)

Definition at line 199 of file pingThread.c.

{
    GThread* thread = NULL;
    GError*  error = NULL;

    CN_LOGPRINTF("entry");
    if (g_ping_thread)
    {
        CN_ERRORPRINTF("ping thread already running");
        return FALSE;
    }

    // create the ping thread
    g_ping_abort = FALSE;
    thread = g_thread_create(pingThread, ping_parms, FALSE, &error);
    if (error != NULL)
    {
        CN_ERRORPRINTF("Failed to create ping thread - %s [%d]", 
                       error->message, error->code);
        g_free(error);
        error = NULL;
    }
    else
    {
        g_ping_thread = thread;
    }

    return TRUE;
}

Here is the call graph for this function:

gboolean pingThread_stop

(

void

)

Definition at line 230 of file pingThread.c.

{
    CN_LOGPRINTF("entry");

    if (g_ping_thread)
    {
        // stop the ping thread
        g_ping_abort = TRUE;

        // stop connect action, when running
        connect_enable_network_abort();

        // stop any process spawned by pingThread
        pid_t pid = get_forkexec_child_pid();
        if (pid > 0)
        {
            kill(pid, SIGTERM);
        }

        return TRUE;
    }
    else
    {
        CN_ERRORPRINTF("ping thread not running");
        return FALSE;
    }
}

Here is the call graph for this function:

gboolean pingThread_stopped

(

void

)

Definition at line 282 of file pingThread.c.

{
    CN_LOGPRINTF("entry");

    if (g_ping_thread)
    {
        return FALSE;
    }
    else
    {
        return TRUE;
    }
}

gboolean pingThread_wait

(

int

timeout_sec

)

Definition at line 259 of file pingThread.c.

{
    int max_ticks = 2 * timeout_sec;

    CN_LOGPRINTF("entry");
    
    if (g_ping_thread)
    {
        // sorry don't like busy-wait, 
        // but g_thread_join has no timeout option
        while (g_ping_thread  &&  --max_ticks >= 0)
        {
            g_usleep(500*1000L);
        }
        return TRUE;
    }
    else
    {
        CN_ERRORPRINTF("ping thread not running");
        return FALSE;
    }
}