blob: 16aa62ce1fe3cef9aa03de08965acaa6799fe481 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
# Polling API
Source code: [poll.go](../poll.go)
`poll` waits for and returns the next event from one or more clients, or `nil` if none of the clients passed to it are active (`connected` state).
Optionally, a timeout can be passed to poll; if no other event occurs until the timeout elapses, a timeout event is returned.
## Events
An event is a table that contains a string `type`. Depending on the type, it may have different other fields.
- `type = "interrupt"`: Fired globally when the program was interrupted using a signal.
- `type = "timeout"`: Fired when the timeout elapses.
- `type = "pkt"`: Fired when a packet was received. See [pkts.md](pkts.md)
- `type = "disconnect"`: Fired when a client connection closed. Has a `client` field.
- `type = "error"`: Fired when an error occurs during deserialization of a packet. Has a `client` field. Stores the error message in an `error` field.
|
