NAME

       gensio_acc_set_sync,   gensio_acc_accept_s,  gensio_acc_accept_s_intr  -  Synchronous  I/O
       operations on a gensio accepter

SYNOPSIS

       #include <gensio/gensio.h>

       int gensio_acc_set_sync(struct gensio_accepter *acc);

       int gensio_acc_accept_s(struct gensio_accepter *acc,
                           struct gensio_time *timeout,
                           struct gensio **new_io);

       int gensio_acc_accept_s_intr(struct gensio_accepter *acc,
                           struct gensio_time *timeout,
                           struct gensio **new_io);

DESCRIPTION

       Normal gensio accepter  operation  is  asynchronous  callback  based.   This  serves  most
       programs  fairly  well,  especially if they need to handle multiple accepts on the same or
       different accepters.

       But occasionally you  need  to  do  something  synchronous  with  the  program  execution,
       especially  if  you  have  a simple program that just accepts one connection and then does
       something.

       gensio_acc set_sync sets up the gensio accepter for synchronous accepts.  If you do  this,
       the  event  callback  that  is  currently registered will no longer receive new connection
       events.  It *will* receive other callbacks.  You must call this  before  starting  up  the
       gensio  accepter,  and once you call it the gensio accepter is in sync mode until you shut
       it down.

       gensio_accept_s Waits for an incoming connection on the gensio  accepter.   This  function
       waits for the amount of time in timeout.  timeout is updated to the amount of time left to
       wait.  If timeout is NULL, wait forever.  If  no  error  is  returned,  the  new  incoming
       connection is returned in new_io.

       gensio_accept_s_intr  is  like  gensio_accept_s,  but  it  return immediately if an signal
       interrupt occurs.  On systems without signals, this is the same as gensio_accept_s.

RETURN VALUES

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

SEE ALSO

       gensio_err(3), gensio_set_sync(3), gensio(5)

                                           27 Jan 2020                     gensio_acc_accept_s(3)