connectionMgr/inc/scanThread.h File Reference

Scan for available wireless networks. 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	network_spec_t
struct	scan_thread_parms
Enumerations
enum	scan_status_t { SCAN_IDLE = 0, SCAN_RUNNING, SCAN_ABORTING, SCAN_UNDEFINED }
Functions
gboolean	scanThread_start (scan_thread_parms *scan_parms)
gboolean	scanThread_stop (void)
gboolean	scanThread_wait (int timeout_sec)
gboolean	scanThread_stopped (void)
void	free_network_spec (network_spec_t *pNetwork)
network_spec_t *	dup_network_spec (network_spec_t *pNetwork)

---

Detailed Description

Scan for available wireless networks.

Copyright (C) 2007 iRex Technologies BV.

Definition in file scanThread.h.

---

Enumeration Type Documentation

enum scan_status_t

Enumerator:

SCAN_IDLE
SCAN_RUNNING
SCAN_ABORTING
SCAN_UNDEFINED

Definition at line 33 of file scanThread.h.

        {
            SCAN_IDLE = 0, // scan-thread not running
            SCAN_RUNNING,  // scan-thread started and connecting to server
            SCAN_ABORTING, // scan-thread running but not wanted anymore
            SCAN_UNDEFINED
        } scan_status_t;

---

Function Documentation

network_spec_t* dup_network_spec

(

network_spec_t *

pNetwork

)

Definition at line 437 of file scanThread.c.

{
    network_spec_t *pDupNetwork = NULL;
    if (pNetwork)
    {
        pDupNetwork = g_new0(network_spec_t, 1);
        if (pDupNetwork)
        {
            pDupNetwork->ssid = g_strdup(pNetwork->ssid);
            pDupNetwork->encryption = pNetwork->encryption;
            pDupNetwork->quality = pNetwork->quality;
        }
    }
    return pDupNetwork;
}

void free_network_spec

(

network_spec_t *

pNetwork

)

Definition at line 428 of file scanThread.c.

{
    if (pNetwork)
    {
        g_free(pNetwork->ssid);
        g_free(pNetwork);
    }
}

gboolean scanThread_start

(

scan_thread_parms *

scan_parms

)

Definition at line 236 of file scanThread.c.

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

    CN_LOGPRINTF("entry");
    if (g_scan_thread)
    {
        CN_ERRORPRINTF("scan thread already running");
        return FALSE;
    }

    // create the scan thread
    g_scan_abort = FALSE;
    thread = g_thread_create(scanThread, scan_parms, FALSE, &error);
    if (error != NULL)
    {
        CN_ERRORPRINTF("Failed to create scan thread - %s [%d]", 
                       error->message, error->code);
        g_free(error);
        error = NULL;
    }
    else
    {
        g_scan_thread = thread;
    }

    return TRUE;
}

Here is the call graph for this function:

gboolean scanThread_stop

(

void

)

Definition at line 267 of file scanThread.c.

{
    CN_LOGPRINTF("entry");

    if (g_scan_thread)
    {
        // stop the scan thread
        g_scan_abort = TRUE;

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

gboolean scanThread_stopped

(

void

)

Definition at line 309 of file scanThread.c.

{
    CN_LOGPRINTF("entry");

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

gboolean scanThread_wait

(

int

timeout_sec

)

Definition at line 286 of file scanThread.c.

{
    int max_ticks = 2 * timeout_sec;

    CN_LOGPRINTF("entry");
    if (g_scan_thread)
    {
        // sorry don't like busy-wait, 
        // but g_thread_join has no timeout option
        while (g_scan_thread  &&  --max_ticks >= 0)
        {
            g_usleep(500*1000L);
        }

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