bindat (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/bindat.2freebsd".)

NAME

bindat - assign a local protocol address to a socket

LIBRARY

Lb libc

SYNOPSIS

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

In fcntl.h Ft int Fn bindat int fd int s const struct sockaddr *addr socklen_t addrlen

DESCRIPTION

The Fn bindat system call assigns the local protocol address to a socket. It works just like the bind(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 bindat 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 bind(2).

RETURN VALUES

Rv -std bindat

ERRORS

The Fn bindat system call may fail with the same errors as the bind(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

bind(2), connectat(2), socket(2), unix(4)

AUTHORS

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