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...
NAMEconnectat - initiate a connection on a socket
SYNOPSISIn 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
DESCRIPTIONThe Fn connectat system call initiates a connection on a socket. It works just like the connect(2) system call with two exceptions:
It is limited to sockets in the PF_LOCAL domain.
- 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 VALUESRv -std connectat
ERRORSThe 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.