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

NAME
     gensio_acc_control - Perform gensio accepter specific actions

SYNOPSIS
     #include <gensio/gensio.h>

     int gensio_acc_control(struct gensio_accepter *acc, int depth,
			 bool get, unsigned int option,
			 char *data, gensiods *datalen);

DESCRIPTION
     gensio_acc_control  performs  a  gensio  accepter specific operation on the
     gensio accepter.  This works exactly like gensio_control(3), see  that  for
     details on get, depth, and how the data and datalen work.

     gensio control operations in option depend on the particular gensio.  Below
     some  are	documented,  but there may be other controls available.  See the
     gensio documentation in gensio(5) for details.

   GENSIO_ACC_CONTROL_LADDR
     Return the given local address for the given gensio.  Since a single gensio
     may have more than one local address, this control provides a means to tell
     which one.  The data string passed in should be the  string  representation
     of a the number (like created with snprintf()) for the particular index you
     want to fetch.  If you specify a number larger than the number of open lis-
     ten  sockets, GE_NOTFOUND is returned.  The return data is a string holding
     the address.

     Note that a single fetched string may contain more than one address.  These
     will be separated by semicolons.  In some cases addresses may change dynam-
     ically (like with SCTP), so you get a single set of addresses.

   GENSIO_ACC_CONTROL_LPORT
     Return the port for the given local address for the given gensio.	Since  a
     single gensio may have more than one local address, this control provides a
     means  to	tell  which one.  The data string passed in should be the string
     representation of a the number (like created with snprintf()) for the  par-
     ticular  index  you want to fetch.  If you specify a number larger than the
     number of open listen sockets, GE_NOTFOUND is returned.  The return data is
     a string holding the port number.

   GENSIO_ACC_CONTROL_TCPDNAME
     Get or set the TCPD name for the gensio, only for TCP gensios.

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

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

				   27 Feb 2019		   gensio_acc_control(3)

home | help