1 .\" Copyright (c) 1983, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. Neither the name of the University nor the names of its contributors
13 .\" may be used to endorse or promote products derived from this software
14 .\" without specific prior written permission.
16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" @(#)connect.2 8.1 (Berkeley) 6/4/93
36 .Nd initiate a connection on a socket
42 .Fn connect "int s" "const struct sockaddr *name" "socklen_t namelen"
50 this call specifies the peer with which the socket is to be associated;
51 this address is that to which datagrams are to be sent,
52 and the only address from which datagrams are to be received.
53 If the socket is of type
55 this call attempts to make a connection to
57 The other socket is specified by
59 which is an address in the communications space of the socket.
61 indicates the amount of space pointed to by
68 Each communications space interprets the
70 argument in its own way.
71 Generally, stream sockets may successfully
73 only once; datagram sockets may use
75 multiple times to change their association.
76 Datagram sockets may dissolve the association
77 by connecting to an invalid address, such as a null address.
89 is not a valid descriptor.
93 argument is not a valid length for the address family.
98 is a descriptor for a file, not a socket.
99 .It Bq Er EADDRNOTAVAIL
100 The specified address is not available on this machine.
101 .It Bq Er EAFNOSUPPORT
102 Addresses in the specified address family cannot be used with this socket.
104 The socket is already connected.
106 Connection establishment timed out without establishing a connection.
107 .It Bq Er ECONNREFUSED
108 The attempt to connect was forcefully rejected.
110 The connection was reset by the remote host.
111 .It Bq Er ENETUNREACH
112 The network is not reachable from this host.
113 .It Bq Er EHOSTUNREACH
114 The remote host is not reachable from this host.
116 The address is already in use.
120 argument specifies an area outside
121 the process address space.
122 .It Bq Er EINPROGRESS
123 The socket is non-blocking
124 and the connection cannot
125 be completed immediately.
128 for completion by selecting the socket for writing.
130 The connection attempt was interrupted by the delivery of a signal.
131 The connection will be established in the background,
135 A previous connection attempt has not yet been completed.
137 An attempt is made to connect to a broadcast address (obtained through the
141 return value) through a socket that does not provide broadcast functionality.
143 An auto-assigned port number was requested but no auto-assigned ports
145 Increasing the port range specified by
148 .Va net.inet.ip.portrange.first
150 .Va net.inet.ip.portrange.last
151 may alleviate the problem.
154 The following errors are specific to connecting names in the UNIX domain.
155 These errors may not apply in future versions of the UNIX IPC domain.
158 A component of the path prefix is not a directory.
159 .It Bq Er ENAMETOOLONG
160 A component of a pathname exceeded 255 characters,
161 or an entire path name exceeded 1023 characters.
163 The named socket does not exist.
165 Search permission is denied for a component of the path prefix.
167 Write access to the named socket is denied.
169 Too many symbolic links were encountered in translating the pathname.
171 Write access to the named socket is denied.
184 system call appeared in