connectat (2)

Leading comments

Copyright (c) 2013 The FreeBSD Foundation
All rights reserved.

This documentation was written by Pawel Jakub Dawidek under sponsorship from
the FreeBSD Foundation.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the abov...

(The comments found at the beginning of the groff file "man2/connectat.2freebsd".)

NAME

connectat - 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.

SEE ALSO

bindat(2), connect(2), socket(2), unix(4)

AUTHORS

The was developed by An Pawel Jakub Dawidek Aq pawel@dawidek.net under sponsorship from the FreeBSD Foundation.