NAME

       str_to_gensio_accepter - Create a gensio accepter from a string

SYNOPSIS

       #include <gensio/gensio.h>

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

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

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

       int gensio_filter_acc_alloc(const char *gensiotype,
                           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                         str_to_gensio_accepter(3)