Skip to content

demi_bind.md

Latest commit

 

History

History
52 lines (32 loc) · 1.64 KB

demi_bind.md

File metadata and controls

52 lines (32 loc) · 1.64 KB

demi_bind()

Name

demi_bind - Binds an address to a socket I/O queue.

Synopsis

#include <demi/libos.h>
#include <sys/socket.h> /* For struct sockaddr and socklen_t. */

int demi_bind(int sockqd, const struct sockaddr *addr, socklen_t size);

Description

demi_bind() assigns the address specified by addr to the socket referred to by the socket I/O queue descriptor sockqd.

The size parameter specifies the size (in bytes) of the address structure pointed to by addr.

The sockaddr structure has a genetic format and its only purpose is to cast the structure pointer passed in addr, in order to avoid compiler warnings. The length and the format of actual socket address depends on the address family of the socket.

Return Value

On success, zero is returned. On error, a positive error code is returned.

Errors

On error, one of the following positive error codes is returned:

  • EINVAL - The addr argument does not point to a valid socket address structure.
  • EINVAL - The socket address size size is not valid.
  • EINVAL - sockqd refers to an I/O queue that does not support the demi_bind() operation.
  • EBADF - sockqd does not refer to a socket I/O queue.
  • EADDRINUSE - The address pointed to by addr is already in use.

Conforming To

The socket address structure, the socket length type and error codes are conformant to POSIX.1-2017.

Bugs

Demikernel may fail with error codes that are not listed in this manual page.

Disclaimer

Any behavior that is not documented in this manual page is unintentional and should be reported.