Name	Size	Mode	Actions
CHANGELOG.md	4189	0644	editdlrm
dns.html	4752	0644	editdlrm
ftp.html	9599	0644	editdlrm
http.html	11865	0644	editdlrm
index.html	4431	0644	editdlrm
installation.html	3881	0644	editdlrm
introduction.html	12433	0644	editdlrm
ltn12.html	11483	0644	editdlrm
luasocket.png	11732	0644	editdlrm
mime.html	14246	0644	editdlrm
README.md	939	0644	editdlrm
reference.css	975	0644	editdlrm
reference.html	7928	0644	editdlrm
smtp.html	14621	0644	editdlrm
socket.html	14704	0644	editdlrm
tcp.html	24022	0644	editdlrm
udp.html	18727	0644	editdlrm
url.html	8430	0644	editdlrm

Installation

Here we describe the standard distribution. If the standard doesn't meet your needs, we refer you to the Lua discussion list, where any question about the package scheme will likely already have been answered.

Directory structure

On Unix systems, the standard distribution uses two base directories, one for system dependent files, and another for system independent files. Let's call these directories <CDIR> and <LDIR>, respectively. For example, in my laptp, Lua 5.1 is configured to use '/usr/local/lib/lua/5.1' for <CDIR> and '/usr/local/share/lua/5.1' for <LDIR>. On Windows, <CDIR> usually points to the directory where the Lua executable is found, and <LDIR> points to a lua/ directory inside <CDIR>. (These settings can be overridden by environment variables LUA_PATH and LUA_CPATH. See the Lua documentation for details.) Here is the standard LuaSocket distribution directory structure:

<LDIR>/ltn12.lua
<LDIR>/socket.lua
<CDIR>/socket/core.dll
<LDIR>/socket/http.lua
<LDIR>/socket/tp.lua
<LDIR>/socket/ftp.lua
<LDIR>/socket/smtp.lua
<LDIR>/socket/url.lua
<LDIR>/mime.lua
<CDIR>/mime/core.dll

Naturally, on Unix systems, core.dll would be replaced by core.so.

Using LuaSocket

With the above setup, and an interpreter with shared library support, it should be easy to use LuaSocket. Just fire the interpreter and use the require function to gain access to whatever module you need:

Lua 5.2.2  Copyright (C) 1994-2013 Lua.org, PUC-Rio
> socket = require("socket")
> print(socket._VERSION)
--> LuaSocket 3.0.0

Each module loads their dependencies automatically, so you only need to load the modules you directly depend upon:

Lua 5.2.2  Copyright (C) 1994-2013 Lua.org, PUC-Rio
> http = require("socket.http")
> print(http.request("http://www.impa.br/~diego/software/luasocket"))
--> homepage gets dumped to terminal