lua-eco

• Index

Contents

• Functions
• Class ssl_client
• Class ssl_server

Modules

• eco
• eco.time
• eco.log
• eco.file
• eco.sys
• eco.sync
• eco.channel
• eco.shared
• eco.uci
• eco.ubus
• eco.socket
• eco.packet
• eco.dns
• eco.ssl
• eco.mqtt
• eco.net
• eco.nl
• eco.genl
• eco.rtnl
• eco.ip
• eco.nl80211
• eco.websocket
• eco.termios
• eco.ssh
• eco.http.server
• eco.http.client
• eco.encoding.hex
• eco.encoding.base64
• eco.hash.md5
• eco.hash.sha1
• eco.hash.sha256
• eco.hash.hmac

Topics

• README

Examples

• channel.lua
• coroutine.lua
• dns.lua
• base64.lua
• hex.lua
• env.lua
• exec.lua
• shell.lua
• dir.lua
• file.lua
• flock.lua
• inotify.lua
• walk.lua
• hmac.lua
• md5.lua
• sha1.lua
• sha256.lua
• hook.lua
• download_file.lua
• get.lua
• post.lua
• post_file.lua
• post_form.lua
• server.lua
• server_multiprocess.lua
• log.lua
• mqtt.lua
• custom-proto.lua
• genl_get_family.lua
• ip-addr-add.lua
• ip-addr-del.lua
• ip-addr-get.lua
• ip-link.lua
• link_del.lua
• link_dump.lua
• link_event.lua
• nl80211_add_interface.lua
• nl80211_del_interface.lua
• nl80211_dump_interface.lua
• nl80211_dump_station.lua
• nl80211_get_freqlist.lua
• nl80211_get_interface.lua
• nl80211_get_station.lua
• nl80211_scan.lua
• nl80211_set_interface.lua
• route_event.lua
• panic_hook.lua
• send-at-command.lua
• shared.lua
• signal.lua
• ping.lua
• ping6.lua
• recver.lua
• sender.lua
• arp-scan.lua
• arping.lua
• capture.lua
• send_tcp.lua
• send_udp.lua
• socketpair_dgram.lua
• socketpair_fork.lua
• socketpair_stream.lua
• client.lua
• server.lua
• client.lua
• server.lua
• client.lua
• dgram_client.lua
• dgram_server.lua
• server.lua
• spawn.lua
• exec.lua
• scp_recv.lua
• scp_send.lua
• client.lua
• server.lua
• cond.lua
• mutex.lua
• wait_group.lua
• termios.lua
• timer.lua
• signatures.lua
• subscribe.lua
• ubus.lua
• client.lua
• server.lua

Module eco.ssl

SSL/TLS support.

This module provides TLS-enabled stream connections on top of eco.socket TCP sockets.

Functions

listen (ipaddr, port[, options])	Create a TLS server listener.
connect (ipaddr, port[, options])	Create a TLS client connection.

Class ssl_client

ssl_client:send (data[, timeout])	Send data.
ssl_client:write ()	Alias of ssl_client:send.
ssl_client:sendfile (path, len[, offset[, timeout]])	Send file content.
ssl_client:recv ()	Alias of ssl_client:read.
ssl_client:read ()	See read
ssl_client:readfull ()	See readfull
ssl_client:readuntil ()	See readuntil
ssl_client:close ()	Close the TLS connection.

Class ssl_server

ssl_server:close ()	Close the server and free its TLS context.
ssl_server:accept ()	Accept a TLS client.

Functions

listen (ipaddr, port[, options])

Create a TLS server listener.

Internally this calls eco.socket.listen_tcp and wraps accepted sockets with TLS using a server context.

options fields used by TLS:

• ca: Path to CA certificate file.
• cert: Path to server certificate file.
• key: Path to server private key file.
• insecure: When true, disables/relaxes peer verification (backend dependent).

Other fields are passed to eco.socket.listen_tcp.

Parameters:

• ipaddr string Listen address.
• port int Listen port.
• options table Options table. (optional)

Returns:

ssl_server

Or

1. nil On failure.
2. string Error message.

connect (ipaddr, port[, options])

Create a TLS client connection.

Internally this calls eco.socket.connect_tcp and performs a TLS handshake.

options fields used by TLS:

• ca: Path to CA certificate file.
• cert: Path to client certificate file (optional, for mTLS).
• key: Path to client private key file (optional, for mTLS).
• insecure: When true, disables/relaxes peer verification (backend dependent).
• server_name: SNI server name.
• ctx: An existing ssl context object to reuse.

Other fields are passed to eco.socket.connect_tcp.

If options.ctx is provided, it is reused and will NOT be freed when the returned client is closed.

Parameters:

• ipaddr string Remote address.
• port int Remote port.
• options table Options table. (optional)

Returns:

ssl_client

Or

1. nil On failure.
2. string Error message.

Class ssl_client

ssl_client:send (data[, timeout])

Send data.

Parameters:

• data string Data to send.
• timeout number Timeout in seconds (optional)

Returns:

int Bytes sent.

Or

1. nil On failure.
2. string Error message.

ssl_client:write ()

Alias of ssl_client:send.

ssl_client:sendfile (path, len[, offset[, timeout]])

Send file content.

This is a convenience helper that reads from a file and sends exactly len bytes (unless EOF/error occurs).

Parameters:

• path string File path.
• len int Bytes to send.
• offset int Start offset in file. (optional)
• timeout number Timeout in seconds (optional)

Returns:

int Bytes sent.

Or

1. nil On failure.
2. string Error message.

ssl_client:recv ()

Alias of ssl_client:read.

ssl_client:read ()

See read

ssl_client:readfull ()

See readfull

ssl_client:readuntil ()

See readuntil

ssl_client:close ()

Close the TLS connection.

Frees internal TLS state and closes the underlying TCP socket.

Class ssl_server

ssl_server:close ()

Close the server and free its TLS context.

ssl_server:accept ()

Accept a TLS client.

This accepts an incoming TCP connection and then performs a TLS handshake.

Returns:

1. ssl_client Accepted TLS client.
2. table Peer address table.

Or

1. nil On failure.
2. string Error message.