Root Zanli
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
usr
/
share
/
doc
/
lua-socket
/
Filename :
installation.html
back
Copy
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <meta name="description" content="LuaSocket: Introduction to the core"> <meta name="keywords" content="Lua, LuaSocket, TCP, UDP, Network, Support, Installation"> <title>LuaSocket: Installation</title> <link rel="stylesheet" href="reference.css" type="text/css"> </head> <body> <!-- header +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> <div class=header> <hr> <center> <table summary="LuaSocket logo"> <tr><td align=center><a href="http://www.lua.org"> <img width=128 height=128 border=0 alt="LuaSocket" src="luasocket.png"> </a></td></tr> <tr><td align=center valign=top>Network support for the Lua language </td></tr> </table> <p class=bar> <a href="index.html">home</a> · <a href="index.html#download">download</a> · <a href="installation.html">installation</a> · <a href="introduction.html">introduction</a> · <a href="reference.html">reference</a> </p> </center> <hr> </div> <!-- installation ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> <h2>Installation</h2> <p> 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. </p> <h3>Directory structure</h3> <p> 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 <tt><CDIR></tt> and <tt><LDIR></tt>, respectively. For example, in my laptp, Lua 5.1 is configured to use '<tt>/usr/local/lib/lua/5.1</tt>' for <tt><CDIR></tt> and '<tt>/usr/local/share/lua/5.1</tt>' for <tt><LDIR></tt>. On Windows, <tt><CDIR></tt> usually points to the directory where the Lua executable is found, and <tt><LDIR></tt> points to a <tt>lua/</tt> directory inside <tt><CDIR></tt>. (These settings can be overridden by environment variables <tt>LUA_PATH</tt> and <tt>LUA_CPATH</tt>. See the Lua documentation for details.) Here is the standard LuaSocket distribution directory structure:</p> <pre class=example> <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 </pre> <p> Naturally, on Unix systems, <tt>core.dll</tt> would be replaced by <tt>core.so</tt>. </p> <h3>Using LuaSocket</h3> <p> 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 <tt>require</tt> function to gain access to whatever module you need:</p> <pre class=example> Lua 5.2.2 Copyright (C) 1994-2013 Lua.org, PUC-Rio > socket = require("socket") > print(socket._VERSION) --> LuaSocket 3.0.0 </pre> <p> Each module loads their dependencies automatically, so you only need to load the modules you directly depend upon: </p> <pre class=example> 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 </pre> <!-- footer +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> <div class=footer> <hr> <center> <p class=bar> <a href="index.html">home</a> · <a href="index.html#down">download</a> · <a href="installation.html">installation</a> · <a href="introduction.html">introduction</a> · <a href="reference.html">reference</a> </p> <p> <small> Last modified by Diego Nehab on <br> Tue Jun 11 19:06:14 HKT 2013 </small> </p> </center> </div> </body> </html>