A minimal Lua binding for common Linux functions.
The library targets Lua 5.3+ with the default 64-bit integers.
This packs a lot of Linux functions I use elsewhere in a small, self-contained library.
Completeness, POSIX compliance, support of other Unix OSes are not an objective.
errno() => errno value
strerror(errnum) => err_msg
getpid() => process id
getppid() => parent process id
geteuid() => effective process uid
getegid() => effective process gid
getcwd() => current dir pathname
chdir(pathname)
setenv(varname, value)
unsetenv(varname)
environ() => list of string "key=value"
msleep(millisecs)
fork() => pid
waitpid(pid, flags) => pid, status
kill(pid, sig)
execve(pname, argv, envp)
open() => fd
read(fd, cnt) => str --(read up to 4 kbytes)
write(fd, str [, idx, count]) => n
close(fd)
fcntl(fd, cmd, arg) => int
fsync(fd)
dup2(oldfd [, newfd]) => newfd
fileno(file) => fd
fdopen(fd) => file
ftruncate(fd, size)
pipe2([flags]) => fd0, fd1
opendir(pathname) => dfd
readdir(dfd) => pathname, filetype
closedir(dfd)
readlink(pathname) => target pathname
lstat3(pathname) => mode, size, mtime
lstat(pathname, what) => a list of stat fields, or a single attribute
utime(pathname [, time])
chown(pathname, uid, gid)
chmod(pathname, mode)
symlink(target, linkpath)
mkdir(pathname)
rmdir(pathname)
mount(src, dest, fstype, flags, data)
umount(dest)
ioctl(fd, cmd, arg_in, outlen) => out
ioctl_int(fd, cmd, intarg)
poll(pollfdlist, timeout) => n
pollin(fd, timeout) => n -- monitor only one input fd
socket(domain, type, protocol) => fd
setsockopt(fd, level, optname, optvalue)
bind(fd, addr)
listen(fd, backlog)
accept(fd) => clientfd
connect(fd, addr)
recvfrom(fd, flags) => str, sockaddr
recv(fd, flags) => str
sendto(fb, str, flags, sockaddr [, idx, count]) => n
send(fb, str, flags [, idx, count]) => n
getsockname(fd) => sockaddr
getpeername(fd) => sockaddr
getaddrinfo(host, port) => {sockaddr, ...}
getnameinfo(sockaddr) => host, port
-- In case of error, most functions return nil, errno.
Examples can be found in the lualinux and test subdirectories. They contain various Lua functions offering a more convenient API for some Linux functionality, and minimal tests for these functions.
MIT.