File: README

package info (click to toggle)
luxio 13-1
  • links: PTS
  • area: main
  • in suites: buster
  • size: 420 kB
  • ctags: 449
  • sloc: ansic: 3,117; makefile: 72; sh: 24
file content (33 lines) | stat: -rw-r--r-- 1,580 bytes parent folder | download
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
33
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. See the file LICENCE.)

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".
        2. Optionally, type "make install-doc"