connectat(2) initiate a connection on a socket

LIBRARY

Lb libc

SYNOPSIS

In sys/types.h In sys/socket.h

In fcntl.h Ft int Fn connectat int fd int s const struct sockaddr *name socklen_t namelen

DESCRIPTION

The Fn connectat system call initiates a connection on a socket. It works just like the connect(2) system call with two exceptions:

  1. It is limited to sockets in the PF_LOCAL domain.

  2. If the file path stored in the Fa sun_path field of the sockaddr_un structure is a relative path, it is located relative to the directory associated with the file descriptor Fa fd . If Fn connectat is passed the special value AT_FDCWD in the Fa fd parameter, the current working directory is used and the behavior is identical to a call to connect(2).

RETURN VALUES

Rv -std connectat

ERRORS

The Fn connectat system call may fail with the same errors as the connect(2) system call for a UNIX domain socket or with the following errors:

Bq Er EBADF
The Fa sun_path field does not specify an absolute path and the Fa fd argument is neither AT_FDCWD nor a valid file descriptor.
Bq Er ENOTDIR
The Fa sun_path field is not an absolute path and Fa fd is neither AT_FDCWD nor a file descriptor associated with a directory.

AUTHORS

The was developed by An Pawel Jakub Dawidek Aq [email protected] under sponsorship from the FreeBSD Foundation.