lua-eco

• Index

Contents

• Functions

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.ip

IP configuration helpers.

This module provides a small, convenience API built on top of RTNETLINK via eco.nl and eco.rtnl.

It exposes two subtables:

• link: manage link-level properties (UP/DOWN, MTU, MAC, master, etc.)
• address: manage interface addresses (get all; add/del IPv4)

Most operations require sufficient privileges (typically CAP_NET_ADMIN).

Usage:

local link = require 'eco.ip'.link
local addr = require 'eco.ip'.address

local ok, err = link.set('eth0', { up = true, mtu = 1500 })
assert(ok, err)

local res, err = addr.get('eth0')
assert(res, err)

Functions

link.set (dev[, attrs])	Set link attributes.
link.get (dev)	Get link attributes.
address.add (dev, addr)	Add an IPv4 address to an interface.
address.del (dev, addr)	Delete an IPv4 address from an interface.
address.get ([dev])	Get addresses.

Functions

link.set (dev[, attrs])

Set link attributes.

Supported attrs fields:

• up (boolean): bring interface up
• down (boolean): bring interface down
• arp (boolean): enable/disable ARP
• dynamic (boolean)
• multicast (boolean)
• allmulticast (boolean)
• promisc (boolean)
• carrier (boolean)
• txqueuelen (number)
• address (string): MAC address like "00:11:22:33:44:55"
• broadcast (string): MAC address
• mtu (number)
• alias (string)
• master (string): master interface name
• nomaster (boolean): detach from master

Parameters:

• dev string Interface name.
• attrs table Attributes table. (optional)

Returns:

boolean true On success.

Or

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

link.get (dev)

Get link attributes.

Returns a table with fields:

• ifname (string)
• alias (string)
• master (string)
• type (int)
• mtu (int)
• txqueuelen (int)
• address (string): MAC as "xx:xx:..."
• broadcast (string): MAC as "xx:xx:..."
• carrier (boolean)
• flags (boolean): up, running, arp, dynamic, multicast, allmulticast, promisc

Parameters:

• dev string Interface name.

Returns:

table info Link info table.

Or

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

address.add (dev, addr)

Add an IPv4 address to an interface.

addr.address may include prefix length in CIDR form (e.g. "192.168.1.2/24").

Supported addr fields:

• address (string): IPv4 address (optionally with /prefix)
• prefix (number): prefix length (default: 32)
• scope (string): one of "global", "nowhere", "host", "link", "site"
• broadcast (string): IPv4 broadcast address
• label (string)
• metric (number)
• priority (number)

Note: this helper currently builds an IPv4 (AF_INET) request.

Parameters:

• dev string Interface name.
• addr table Address spec.

Returns:

boolean true On success.

Or

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

address.del (dev, addr)

Delete an IPv4 address from an interface.

Uses the same addr format as address.add.

Parameters:

• dev string Interface name.
• addr table Address spec.

Returns:

boolean true On success.

Or

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

address.get ([dev])

Get addresses.

When dev is omitted, dumps addresses for all interfaces.

Returns an array of tables with fields:

• ifname (string)
• family (int): address family (e.g. eco.socket.AF_INET)
• scope (string): scope name
• address (string)
• broadcast (string|nil) (IPv4 only)
• label (string|nil)

Parameters:

• dev string Interface name. (optional)

Returns:

table res Array of address info tables.

Or

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