Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.

SCTP_BINDX(3)              Library Functions Manual              SCTP_BINDX(3)

     sctp_bindx - bind or unbind an SCTP socket to a list of addresses

     Standard C Library (libc, -lc)

     #include <sys/types.h>
     #include <sys/socket.h>
     #include <netinet/sctp.h>

     sctp_bindx(int s, struct sockaddr *addrs, int num, int type);

     The 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

     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.

     The call returns 0 on success and -1 upon failure.

     The sctp_bindx() function can return the following errors:

     [EBADF]            The argument s is not a valid descriptor.

     [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

     [ENOTSOCK]         The argument s is not a socket.

     bind(2), sctp(4)

     Sockets API Extensions for the Stream Control Transmission Protocol
     (SCTP), RFC, 6458, December 2011.

     This function first appeared in NetBSD 9.0.

NetBSD 9.99                     August 1, 2018                     NetBSD 9.99