---
title: "port_bridge()"
description: "Securely connects to a particular remote network."
url: "https://wasix.org/docs/api-reference/wasix/port_bridge/"
markdown: "https://wasix.org/docs/api-reference/wasix/port_bridge.md"
---

# `port_bridge()`

Securely connects to a particular remote network.

## Description

The `port_bridge()` function establishes a secure connection to a specific remote network. It securely bridges the local network with the remote network, allowing communication between them.

## Syntax

```ebnf
  ;;; Securely connects to a particular remote network
  (@interface func (export "port_bridge")
    ;;; Fully qualified identifier for the network
    (param $network string)
    ;;; Access token used to authenticate with the network
    (param $token string)
    ;;; Level of encryption to encapsulate the network connection with
    (param $security $stream_security)
    (result $error (expected (error $errno)))
  )
```

## Parameters

- `ctx`: A mutable reference to the function environment.
- `network`: A pointer to the memory location holding the fully qualified identifier for the network.
- `network_len`: The length of the network identifier.
- `token`: A pointer to the memory location holding the access token used to authenticate with the network.
- `token_len`: The length of the access token.
- `security`: The level of encryption to encapsulate the network connection with.

## Return Value

The function returns a `Result` indicating the outcome of the operation. If the operation is successful, `Ok(Errno::Success)` is returned. If an error occurs, an appropriate `WasiError` is returned.

## Errors

- `Errno::Inval`: If an invalid `Streamsecurity` value is provided for the `security` parameter.

## Notes

- The `port_bridge()` function establishes a secure connection to a remote network, allowing communication between the local and remote networks.
- It takes the fully qualified identifier for the network as a string input through the `network` and `network_len` parameters.
- The access token used to authenticate with the network is provided as a string input through the `token` and `token_len` parameters.
- The `security` parameter specifies the level of encryption to be used for the network connection. It accepts one of the `Streamsecurity` values: `Unencrypted`, `AnyEncryption`, `ClassicEncryption`, or `DoubleEncryption`.
- The behavior and limitations of the `port_bridge()` function may vary depending on the specific runtime environment and underlying networking implementation. It is important to consult the documentation or specifications of the specific environment to understand its behavior in that context.

---

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