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 listen 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 dynamically (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 particular 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)