initiate a connection on a socket
Standard C Library (libc, -lc)
connectat() system call initiates a connection on
the socket s. When passed the special value
AT_FDCWD in the fd parameter,
the behavior is identical to a call to
connectat() works like the
system call with two exceptions:
- It is limited to sockets in the PF_LOCAL domain.
- If the file path stored in the sun_path field of the
sockaddr_un structure is a relative path, it is located relative to the
directory associated with the file descriptor
connectat() function returns the value 0 if
successful; otherwise the value -1 is returned and the global variable
errno is set to indicate the error.
connectat() system call may fail with the same
errors as the
system call or with the following errors:
- The sun_path field does not specify an absolute path
and the fd argument is neither
AT_FDCWD nor a valid file descriptor.
- The sun_path field is not an absolute path and
fd is neither
AT_FDCWD nor a
file descriptor associated with a directory.
connectat was developed by Pawel
under sponsorship from the FreeBSD Foundation.