summaryrefslogtreecommitdiff
path: root/docs/ref/sock/nng_sub_open.adoc
blob: 60e6865db1ff07db042167d056ca8358ac71afbe (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
## nng_sub_open

Create sub socket.

### Synopsis

```c
#include <nng/nng.h>
#include <nng/protocol/pubsub0/sub.h>

int nng_sub0_open(nng_socket *s);
int nng_sub0_open_raw(nng_socket *s);
```

### Description

The `nng_sub0_open` function creates a xref:../proto/sub.adoc[_SUB_] version 0 xref:../sock/index.adoc[socket] and returns it at the location pointed to by _s_.

The `nng_sub0_open_raw` function creates a _SUB_ version 0 socket in xref:../sock/raw.adoc[raw mode] and returns it at the location pointed to by _s_.

### Return Values

These functions return 0 on success, and non-zero otherwise.

### Errors

[horizontal]
`NNG_ENOMEM`:: Insufficient memory is available.
`NNG_ENOTSUP`:: The protocol is not supported.

### See Also

xref:../proto/pub.adoc[Publisher Protocol (_PUB_)],
xref:../proto/sub.adoc[Subscriber Protocol (_SUB_)]