summaryrefslogtreecommitdiff
path: root/README
blob: e4455bc324ef57ef0940d6b1d2653ebc1af35d8d (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
Luxio - Lightweight UNIX I/O and POSIX binding for Lua
------------------------------------------------------

Now:
	0. Supports Lua 5.1 and Lua 5.2.
	1. Reasonably good coverage of POSIX and BSD Sockets, including IPv6,
           and some GNU extensions.
        2. Meant to be buildable anywhere that is POSIX.1-1996.  If it's not,
           there's a bug.  These are likely, as I have nowhere other than
           Linux to test.
        3. Low-level.  You get the return values and the errno for the bound
           functions where possible.  Others take a table to fill in, or
           may return tables.
        4. High-level wrapper library providing nice IO access and to misc.
           utility functions.  Generates useful errors in assert()able form,
	   and provides meaningful __tostring metamethods to aid debugging.
        5. A high-level poll()-based event dispatch library.
        6. Sub-process handling library (read/write io.popen with job control).
	7. A prototype POSIX Message Queue-based IPC scheme that can serialise
           most simple Lua values.  (No closures, userdata, etc)
        8. Liberal licence. (Same as Lua's.)

Future:
        0. Well-documented.
        1. Well-tested.
        2. Complete POSIX coverage (where appropriate).
	3. Better socketing, specifically for datagram sockets.
	4. Advanced features like file descriptor passing.

How to build:
        0. Type "make".
        1. Optionally, type "make install".