Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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  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 func-
       tions  to  allocate an accepter stack directly, not using a string for-
       mat.

       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 gen-
       sio 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gensio_terminal_acc_alloc&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help