UDP Receiver Chain¶

local output = dnscli.new(dnscli.UDP)
output:connect("127.0.0.1", "53")
input:receiver(output)

TCP Nonblocking¶

local output = dnscli.new(dnscli.TCP + dnscli.NONBLOCKING)
output:send(object)

MODES¶

These transport modes and options are available when creating a new Dnscli output.

UDP

Create an output using UDP.

TCP

Create an output using TCP.

TLS

Create an output using TCP and encrypt it with TLS.

NONBLOCKING

Make the client nonblocking, see send() and produce().

Functions¶

Dnscli.new(mode)

Create a new Dnscli output.

Dnscli:timeout(seconds, nanoseconds)

Set or return the timeout used for sending and reciving, must be used before connect().

Dnscli:connect(host, port)

Connect to the host and port and return 0 if successful.

Dnscli:nonblocking()

Return if nonblocking mode is on (true) or off (false).

Dnscli:send(object, sent)

Send an object and optionally continue sending after sent bytes. Unlike the receive interface this function lets you know if the sending was successful or not which might be needed on nonblocking connections. Returns -2 on error, -1 if interrupted, timed out or unable to send due to nonblocking, or the number of bytes sent. Note the counters for sent, received, errors and timeouts are not affected by this function.

Dnscli:receive()

Return the C functions and context for receiving objects, these objects will be sent.

Dnscli:produce()

Return the C functions and context for producing objects, these objects are received. If nonblocking mode is enabled the producer will return a payload object with length zero if there was nothing to receive. If nonblocking mode is disabled the producer will wait for data and if timed out (see timeout) it will return a payload object with length zero. The producer returns nil on error.

Dnscli:packets()

Return the number of "packets" sent, actually the number of completely sent payloads.

Dnscli:received()

Return the number of "packets" received, actually the number of successful calls to recvfrom(2) that returned data.

Dnscli:errors()

Return the number of errors when sending or receiving.

Dnscli:timeouts()

Return the number of timeouts when sending or receiving.