NAME

       libwget-thread - Implementation of multi-threading basic functionality

SYNOPSIS

   Functions
       int wget_thread_mutex_init (wget_thread_mutex_t *mutex)
       int wget_thread_mutex_destroy (wget_thread_mutex_t *mutex)
       void wget_thread_mutex_lock (wget_thread_mutex_t mutex)
       void wget_thread_mutex_unlock (wget_thread_mutex_t mutex)
       int wget_thread_cond_init (wget_thread_cond_t *cond)
       int wget_thread_cond_destroy (wget_thread_cond_t *cond)
       int wget_thread_cond_signal (wget_thread_cond_t cond)
       int wget_thread_cond_wait (wget_thread_cond_t cond, wget_thread_mutex_t mutex, long long
           ms)
       int wget_thread_start (wget_thread_t *thread, void *(*start_routine)(void *), void *arg,
           G_GNUC_WGET_UNUSED int flags)
       int wget_thread_cancel (G_GNUC_WGET_UNUSED wget_thread_t thread)
       int wget_thread_kill (G_GNUC_WGET_UNUSED wget_thread_t thread, G_GNUC_WGET_UNUSED int sig)
       int wget_thread_join (wget_thread_t *thread)
       wget_thread_id_t wget_thread_self (void)
       bool wget_thread_support (void)

Detailed Description

       This is a wrapper around Gnulib's glthread functionality.

       It currently supports Posix threads (pthreads), GNU Pth threads, Solaris threads and
       Windows threads.

Function Documentation

   int wget_thread_mutex_init (wget_thread_mutex_t * mutex)
       Parameters
           mutex The mutex to initialize

       Returns
           0 on success, non-zero on failure

       Initializes the mutex.

       After usage, a call to wget_thread_mutex_destroy() frees the allocated resources.

   int wget_thread_mutex_destroy (wget_thread_mutex_t * mutex)
       Parameters
           mutex The mutex to destroy

       Returns
           0 on success, non-zero on failure

       Free's the mutex and it's resources.

       After calling this function, the mutex cannot be used any more.

   void wget_thread_mutex_lock (wget_thread_mutex_t mutex)
       Parameters
           mutex The mutex to be locked

       Creates a lock on the mutex.

       To unlock the mutex, call wget_thread_mutex_unlock().

   void wget_thread_mutex_unlock (wget_thread_mutex_t mutex)
       Parameters
           mutex The mutex to be unlocked

       Unlocks the mutex.

   int wget_thread_cond_init (wget_thread_cond_t * cond)
       Parameters
           cond The conditional to initialize

       Returns
           0 on success, non-zero on failure

       Initializes the conditional cond.

       After usage, a call to wget_thread_cond_destroy() frees the allocated resources.

   int wget_thread_cond_destroy (wget_thread_cond_t * cond)
       Parameters
           cond The conditional to destroy

       Returns
           0 on success, non-zero on failure

       Free's the conditional cond and it's resources.

       After calling this function, cond cannot be used any more.

   int wget_thread_cond_signal (wget_thread_cond_t cond)
       Parameters
           cond The conditional to signal a condition

       Returns
           0 on success, non-zero on failure

       Wakes up one (random) thread that waits on the conditional.

   int wget_thread_cond_wait (wget_thread_cond_t cond, wget_thread_mutex_t mutex, long long ms)
       Parameters
           cond The conditional to wait for
           mutex The mutex needed for thread-safety
           ms The wait timeout in milliseconds

       Returns
           0 on success, non-zero on failure

       Waits for a condition with a max. timeout of ms milliseconds.

       To wait forever use a timeout lower or equal then 0.

   int wget_thread_start (wget_thread_t * thread, void *(*)(void *) start_routine, void * arg,
       G_GNUC_WGET_UNUSED int flags)
       Parameters
           thread The thread variable to be initialized
           start_routine The thread function to start
           arg The argument given to start_routine
           flags Currently unused

       Returns
           0 on success, non-zero on failure

       Start start_routine as own thread with argument arg.

   int wget_thread_cancel (G_GNUC_WGET_UNUSED wget_thread_t thread)
       Parameters
           thread Thread to cancel

       Returns
           0 on success, non-zero on failure

       Currently a no-op function, since it's not portable.

   int wget_thread_kill (G_GNUC_WGET_UNUSED wget_thread_t thread, G_GNUC_WGET_UNUSED int sig)
       Parameters
           thread Thread to send the signal to
           sig Signal to send

       Returns
           0 on success, non-zero on failure

       Currently a no-op function, since it's not portable.

   int wget_thread_join (wget_thread_t * thread)
       Parameters
           thread Thread to wait for

       Returns
           0 on success, non-zero on failure

       Wait until the thread has been stopped.

       This function just waits - to stop a thread you have take your own measurements.

   wget_thread_id_t wget_thread_self (void)
       Returns
           The thread id of the caller.

   bool wget_thread_support (void)
       Returns
           Whether libwget supports multi-threading on this platform or not.

Author

       Generated automatically by Doxygen for wget2 from the source code.