sctp_connectx.3 (44d9c28191ff6687db9b91bdb5e32b6ec9f17972) sctp_connectx.3 (a47698f8d66e1eef4682e31d77b8f96c907461d5)
1.\" Copyright (c) 1983, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 30 unchanged lines hidden (view full) ---

39.Nd connect an SCTP socket with multiple destination addresses.
40.Sh LIBRARY
41.Lb libc
42.Sh SYNOPSIS
43.In sys/types.h
44.In sys/socket.h
45.In netinet/sctp.h
46.Ft int
1.\" Copyright (c) 1983, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 30 unchanged lines hidden (view full) ---

39.Nd connect an SCTP socket with multiple destination addresses.
40.Sh LIBRARY
41.Lb libc
42.Sh SYNOPSIS
43.In sys/types.h
44.In sys/socket.h
45.In netinet/sctp.h
46.Ft int
47.Fn sctp_connectx "int s" "struct sockaddr *" "int addrcnt" "sctp_assoc_t *"
47.Fn sctp_connectx "int sd" "struct sockaddr *addrs" "int addrcnt" "sctp_assoc_t *id"
48.Sh DESCRIPTION
49The
50.Fn sctp_connectx
51call attempts to initiate an association to a peer SCTP
52endpoint.
53The call operates similarly to
54.Fn connect
55but it also provides the ability to specify multiple destination

--- 14 unchanged lines hidden (view full) ---

70.Pp
71If the peer SCTP stack does not list one or more of
72the provided addresses in its response message then
73the extra addresses sent in the
74.Fn sctp_connectx
75call will be silently discarded from the association.
76On
77successful completion the provided
48.Sh DESCRIPTION
49The
50.Fn sctp_connectx
51call attempts to initiate an association to a peer SCTP
52endpoint.
53The call operates similarly to
54.Fn connect
55but it also provides the ability to specify multiple destination

--- 14 unchanged lines hidden (view full) ---

70.Pp
71If the peer SCTP stack does not list one or more of
72the provided addresses in its response message then
73the extra addresses sent in the
74.Fn sctp_connectx
75call will be silently discarded from the association.
76On
77successful completion the provided
78.Fa "sctp_assoc_t *"
78.Fa id
79will be
80filled in with the association identification of the newly
81forming association.
82.Sh RETURN VALUES
83The call returns 0 on success and -1 upon failure.
84.Sh ERRORS
85The
86.Fn sctp_connectx
79will be
80filled in with the association identification of the newly
81forming association.
82.Sh RETURN VALUES
83The call returns 0 on success and -1 upon failure.
84.Sh ERRORS
85The
86.Fn sctp_connectx
87can return the following errors.
87function can return the following errors:
88.Bl -tag -width Er
89.It Bq Er EINVAL
90An address listed has an invalid family or no
91addresses were provided.
92.It Bq Er E2BIG
93The size of the address list exceeds the amount of
94data provided.
95.It Bq Er EBADF
96The argument
97.Fa s
98is not a valid descriptor.
99.It Bq Er ENOTSOCK
100The argument
101.Fa s
102is not a socket.
103.El
104.Sh SEE ALSO
105.Xr connect 2 ,
106.Xr sctp 4
88.Bl -tag -width Er
89.It Bq Er EINVAL
90An address listed has an invalid family or no
91addresses were provided.
92.It Bq Er E2BIG
93The size of the address list exceeds the amount of
94data provided.
95.It Bq Er EBADF
96The argument
97.Fa s
98is not a valid descriptor.
99.It Bq Er ENOTSOCK
100The argument
101.Fa s
102is not a socket.
103.El
104.Sh SEE ALSO
105.Xr connect 2 ,
106.Xr sctp 4