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

FreeBSD Manual Pages

  
 
  

home | help
gensio_open(3)		   Library Functions Manual		gensio_open(3)

NAME
       gensio_open,  gensio_open_s, gensio_open_nochild, gensio_open_nochild_s
       - Start a connecting gensio

SYNOPSIS
       #include	<gensio/gensio.h>

       typedef void (*gensio_done_err)(struct gensio *io, int err,
			   void	*open_data);

       int gensio_open(struct gensio *io, gensio_done_err open_done,
			   void	*open_data);

       int gensio_open_s(struct	gensio *io);

       int gensio_open_nochild(struct gensio *io, gensio_done_err open_done,
			   void	*open_data);

       int gensio_open_nochild_s(struct	gensio *io);

DESCRIPTION
       gensio_open starts the gensio.  gensios received	from an	 accepter  are
       open  upon  receipt, but	connecting gensios are started closed and need
       to be opened before use.	 If no error is	returned, the open_done	 call-
       back will be called, if there is	no error in the	callback err value the
       gensio will be open.  This will open all	children, too.

       Note  that  the	open_done  callback  will always be called even	if you
       close the gensio	before the open_done callback happens or if  an	 error
       occurs.	This is	guaranteed.

       gensio_open_s  is like gensio_open, but waits for the open to complete.
       Normal gensio processing	will happen while waiting.  Note that you must
       be careful to not call this from	a callback, you	should only call  this
       from  a non-callback thread or a	runner (see gensio_os_funcs(3) for de-
       tails on	runners).

       gensio_open_nochild is like gensio_open,	but assumes any	child  gensios
       are already open	and just opens this gensio.  This can be useful	if you
       have  a gensio that is already opened (like you received	it from	an ac-
       cepter) and you want to stack another gensio on top of it.  Only	filter
       gensios will support this.

       gensio_open_nochild_s is	like gensio_open_nochild, but  waits  for  the
       open to complete.  See the notes	on gensio_open_s above for warnings.

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

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

				  27 Feb 2019			gensio_open(3)

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

home | help