|SCTP_BINDX(3)||FreeBSD Library Functions Manual||SCTP_BINDX(3)|
NAMEsctp_bindx — bind or unbind an SCTP socket to a list of addresses.
LIBRARYStandard C Library (libc, -lc)
SYNOPSIS#include < sys/types.h>
#include < sys/socket.h>
#include < netinet/sctp.h>
sctp_bindx( int s, struct sockaddr *addrs, int num, int type);
DESCRIPTIONThe sctp_bindx() call binds or unbinds a address or a list of addresses to an SCTP endpoint. This allows a user to bind a subset of addresses. The sctp_bindx() call operates similarly to bind() but allows a list of addresses and also allows a bind or an unbind. The argument s must be a valid SCTP socket descriptor. The argument addrs is a list of addresses (where the list may be only 1 in length) that the user wishes to bind or unbind to the socket. The argument type must be one of the following values.
SCTP_BINDX_ADD_ADDR This value indicates that the listed address(es) need to be added to the endpoint.
SCTP_BINDX_DEL_ADDR This value indicates that the listed address(es) need to be removed from the endpoint.
Note that when a user adds or deletes an address to an association if the dynamic address flag net.inet.sctp.auto_asconf is enabled any associations in the endpoint will attempt to have the address(es) added dynamically to the existing association.
RETURN VALUESThe call returns 0 on success and -1 upon failure.
ERRORSThe sctp_bindx() function can return the following errors:
- [ EINVAL]
- This value is returned if the type field is not one of the allowed values (see above).
- [ ENOMEM]
- This value is returned if the number of addresses being added causes a memory allocation failure in the call.
- [ EBADF]
- The argument s is not a valid descriptor.
- [ ENOTSOCK]
- The argument s is not a socket.
|December 15, 2006||FreeBSD|