Name	Size	Mode	Actions
dns.html	4710	0644	editdlrm
ftp.html	9565	0644	editdlrm
http.html	11449	0644	editdlrm
index.html	7569	0644	editdlrm
installation.html	3883	0644	editdlrm
introduction.html	12433	0644	editdlrm
ltn12.html	10936	0644	editdlrm
lua05.ppt	304128	0644	editdlrm
luasocket.png	11732	0644	editdlrm
mime.html	14160	0644	editdlrm
README	237	0644	editdlrm
reference.css	950	0644	editdlrm
reference.html	7583	0644	editdlrm
smtp.html	14503	0644	editdlrm
socket.html	13866	0644	editdlrm
tcp.html	21458	0644	editdlrm
udp.html	16921	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-rc1

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