home | help 
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>

     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  in-
     stance,  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	particu-
     lar 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)
home | help