Scroll to navigation

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>


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)

27 Feb 2019