> This page is for version 4.3.
> For other versions, use one of these documentation indexes:
> - 4.6 (Latest) (default): https://docs.nvidia.com/holoscan/sdk-user-guide/4-6-latest/llms.txt
> - ltsb-2.0: https://docs.nvidia.com/holoscan/sdk-user-guide/ltsb-2-0/llms.txt
> - 4.5: https://docs.nvidia.com/holoscan/sdk-user-guide/4-5/llms.txt
> - 4.4: https://docs.nvidia.com/holoscan/sdk-user-guide/4-4/llms.txt
> - 4.3: https://docs.nvidia.com/holoscan/sdk-user-guide/4-3/llms.txt
> - Archives: https://docs.nvidia.com/holoscan/sdk-user-guide/archives/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/holoscan/sdk-user-guide/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/holoscan/sdk-user-guide/_mcp/server.

# holoscan::get_unused_network_ports

> Generate a list of unused network ports within a specified range.

```cpp showLineNumbers={false}
std::vector<int> holoscan::get_unused_network_ports(
    uint32_t num_ports = 1,
    uint32_t min_port = 10000,
    uint32_t max_port = 32767,
    const std::vector<int> &used_ports = {},
    const std::vector<int> &prefer_ports = {}
)
```

Generate a list of unused network ports within a specified range.

This method generates a vector of unused network ports based on the specified parameters. The generated ports are guaranteed to be unused at the time of generation. The generated ports can be used to bind to a network socket. The generated ports are not guaranteed to remain unused after generation.

**Returns:** The vector containing the generated unused network ports.

**Parameters**

**`num_ports`** `uint32_t` — default: 1

The number of unused ports to generate (default: 1).

---

**`min_port`** `uint32_t` — default: 10000

The minimum value of the port range (default: 10000).

---

**`max_port`** `uint32_t` — default: 32767

The maximum value of the port range (default: 32767).

---

**`used_ports`** `const std::vector<int> &` — default: \{}

The vector of ports to exclude from the generated list (default: empty).

---

**`prefer_ports`** `const std::vector<int> &` — default: \{}

The vector of ports to prefer in the generated list (default: empty).

---