NAME¶

gensio_glib_funcs_alloc - Abstraction for some operating system functions done with glib

SYNOPSIS¶

#include <gensio/gensio_glib.h>

int gensio_glib_funcs_alloc(struct gensio_os_funcs **o)

DESCRIPTION¶

This structure provides an abstraction for the gensio library that lets it work on top of glib. See the gensio_os_funcs.3 man page for details on what this does. This can be used if you have a project based on glib that you want to integrate gensio into.

Unfortunately, it has some limitations because of weaknesses in the glib interface.

If you use this, you really want to use the gensio wait functions, not g_cont_wait..() yourself. You don't strictly have have to, especially if your app is single threaded, but especially in multithreaded apps you cannot mix calls to the os funcs wait functions and the glib wait functions. Which means you can't use the blocking functions, which all use os func waiters.

Performance should be ok for a single thread. For multiple threads, though, only on thing at a time can be waiting on the main glib thread. This is a weakness in glib. For multiple threads, one function sits in the main context and the others sit on condition variables. When the thead sitting on the main context wakes up, it wakes another waiting thread to take over.

If performance is important, it might be better to put glib on top of gensio os funcs with g_main_context_set_poll_func(). I leave that as an exercise to the reader.

RETURN VALUES¶

A gensio_err returns a standard gensio error.

SEE ALSO¶

gensio_os_funcs(3), gensio(5), gensio_err(3)