blob: 0f6d9bbbeca95d33a78bae1191d8dca3d3b8b91a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
BSD Socket Transport (Experimental)
The {{i:_socket_ transport}} supports communication between
peers across arbitrary BSD sockets, such as those that are
created with [`nng_socket_pair()`][nng_socket_pair].
This transport only supports [listeners][listener],
using [`nng_listener_create()`][nng_listener_create].
> [!NOTE]
> Attempts to create [dialers][dialer] using this transport will result in `NNG_ENOTSUP`.
The socket file descriptor is passed to the listener using
the [{{i:`NNG_OPT_SOCKET_FD`}}][NNG_OPT_SOCKET_FD] option (as an integer).
Setting this option will cause the listener to create a [pipe][pipe]
backed by the file descriptor.
The protocol between peers using this transport is compatible with the protocol used
for the [_tcp_][tcp] transport, but this is an implementation detail and subject to change without notice.[^1]
[^1]: Specifically it is not compatible with the [_ipc_][ipc] transport.
> [!NOTE]
> This transport is _experimental_, and at present is only supported on POSIX platforms.[^2]
[^2]: Windows lacks a suitable `socketpair()` equivalent function we could use.
### Registration
No special action is necessary to register this transport.
### URI Format
This transport uses the URL {{i:`socket://`}}, without further qualification.
### Socket Address
The socket address will be of family {{i:`NNG_AF_UNSPEC`}}.
There are no further socket details available.
### Transport Options
The following transport option is available:
- {{i:`NNG_OPT_SOCKET_FD`}}: \
(int) \
\
This is a write-only option, that may be set multiple times on a listener.
Each time this is set, the listener will create a [pipe][pipe] backed by the given file
descriptor passed as an argument.
Additionally, the following options may be supported on pipes when the platform supports them:
- [`NNG_OPT_PEER_GID`][NNG_OPT_PEER_GID]
- [`NNG_OPT_PEER_PID`][NNG_OPT_PEER_PID]
- [`NNG_OPT_PEER_UID`][NNG_OPT_PEER_UID]
- [`NNG_OPT_PEER_ZONEID`][NNG_OPT_PEER_ZONEID]
{{#include ../refs.md}}
|
