Scroll to navigation

str_to_gensio_accepter(3) Library Functions Manual str_to_gensio_accepter(3)

NAME

str_to_gensio_accepter - Create a gensio accepter from a string

SYNOPSIS

#include <gensio/gensio.h>


struct gensio_os_funcs *o,
gensio_accepter_event cb,
void *user_data,
struct gensio_accepter **acc);

const char *str,
struct gensio_os_funcs *o,
gensio_accepter_event cb,
void *user_data,
struct gensio_accepter **acc);

const void *gdata,
const char * const args[],
struct gensio_os_funcs *o,
gensio_accepter_event cb, void *user_data,
struct gensio_accepter **accepter);

struct gensio_accepter *child,
const char * const args[],
struct gensio_os_funcs *o,
gensio_accepter_event cb, void *user_data,
struct gensio_accepter **accepter);

DESCRIPTION

str_to_gensio_accepter allocates a new gensio accepter stack based upon the given string str.

str_to_gensio_accepter_child allocates a new gensio accepter stack based upon the given string str and stacks it on top of the given child accepter.

To allocate an accepter directly, use one of gensio_terminal_acc_alloc or gensio_filter_acc_alloc. A terminal accepter is one at the bottom of the stack. The gdata parameter depends on the particular gensio. For instance, for tcp it is a pointer to a gensio_addr structure. For stdio it is an argv array. See gensio.5 under "Direct Allocation" for the particular gensio for what gdata is.

A filter accepter is one that has a child. You can use these two functions to allocate an accepter stack directly, not using a string format.

The cb and user_data parameters set a function that will be called when events come in on the gensio accepter. user_data is unused by the gensio stack itself, it is there for the user and may be anything the user wishes.

The new gensio accepter is returned in acc. It will be in the shutdown state.

RETURN VALUES

Zero is returned on success, or a gensio error on failure.

SEE ALSO

gensio_acc_set_callback(3), gensio_err(3), gensio(5)

27 Feb 2019