---
title: "sock_connect()"
description: "Initiate a connection on a socket to the specified address."
url: "https://wasix.org/docs/api-reference/wasix/sock_connect/"
markdown: "https://wasix.org/docs/api-reference/wasix/sock_connect.md"
---

# `sock_connect()`

Initiate a connection on a socket to the specified address.

## Description

The `sock_connect()` function is used to initiate a connection on a socket to the specified address. It is similar to the `connect` function in POSIX.

Once the connection is initiated, the socket handle can be polled to wait for data to arrive or for the socket status to change, which can be queried using the `sock_status()` function.

## Syntax

```ebnf
  ;;; Note: This is similar to `connect` in POSIX
  ;;;
  ;;; the socket status to change which can be queried via 'sock_status'
  ;;; Polling the socket handle will wait for data to arrive or for
  ;;; 
  ;;; Initiate a connection on a socket to the specified address
  (@interface func (export "sock_connect")
    ;;; Socket descriptor
    (param $fd $fd)
    ;;; Address of the socket to connect to
    (param $addr (@witx const_pointer $addr_port))
    (result $error (expected (error $errno)))
  )
```

## Parameters

- `ctx`: A mutable reference to the function environment.
- `sock`: The file descriptor of the socket to connect.
- `addr`: The address of the socket to connect to.

## Return Value

The function returns an `Errno` value indicating the outcome of the operation. If the operation is successful, `Errno::Success` is returned.

## Notes

- The `sock_connect()` function initiates a connection on a socket to the specified address.
- The function blocks until the connection is established or an error occurs.
- The address of the remote socket is specified by `addr`.
- Once the connection is established, the socket handle can be polled to wait for data to arrive or for the socket status to change.
- The specific behavior of the `sock_connect()` function may vary depending on the runtime environment and underlying networking implementation.

---

[Documentation index](https://wasix.org/llms.txt) · [HTML version](https://wasix.org/docs/api-reference/wasix/sock_connect/)