2003-08-31 03:00:15 +02:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
|
|
|
|
|
"http://www.w3.org/TR/html4/strict.dtd">
|
|
|
|
|
<html>
|
|
|
|
|
|
|
|
|
|
<head>
|
2004-06-21 08:07:58 +02:00
|
|
|
<meta name="description" content="The LuaSocket Homepage">
|
2004-11-28 09:17:16 +01:00
|
|
|
<meta name="keywords" content="Lua, LuaSocket, Network, Library, Support, Internet">
|
2003-08-31 03:00:15 +02:00
|
|
|
<title>LuaSocket: Network support for the Lua language </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">
|
2004-06-21 08:07:58 +02:00
|
|
|
<img width=128 height=128 border=0 alt="LuaSocket" src="luasocket.png">
|
2003-08-31 03:00:15 +02:00
|
|
|
</a></td></tr>
|
|
|
|
|
<tr><td align=center valign=top>Network support for the Lua language
|
|
|
|
|
</td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<p class=bar>
|
2009-05-27 11:31:38 +02:00
|
|
|
<a href="index.html">home</a> ·
|
|
|
|
|
<a href="index.html#download">download</a> ·
|
2004-12-13 07:26:01 +01:00
|
|
|
<a href="installation.html">installation</a> ·
|
2003-08-31 03:00:15 +02:00
|
|
|
<a href="introduction.html">introduction</a> ·
|
|
|
|
|
<a href="reference.html">reference</a>
|
|
|
|
|
</p>
|
|
|
|
|
</center>
|
|
|
|
|
<hr>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<!-- whatis +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
|
|
|
|
|
|
<h2 id=whatis>What is LuaSocket?</h2>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
LuaSocket is a <a href="http://www.lua.org">Lua</a> extension library
|
2004-06-16 06:28:21 +02:00
|
|
|
that is composed by two parts: a C core that provides support for the TCP
|
2003-08-31 03:00:15 +02:00
|
|
|
and UDP transport layers, and a set of Lua modules that add support for
|
2004-06-16 06:28:21 +02:00
|
|
|
functionality commonly needed by applications that deal with the Internet.
|
2003-08-31 03:00:15 +02:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
2004-06-16 06:28:21 +02:00
|
|
|
The core support has been implemented so that it is both efficient and
|
2004-11-29 07:55:47 +01:00
|
|
|
simple to use. It is available to any Lua application once it has been
|
|
|
|
|
properly initialized by the interpreter in use. The code has been tested
|
|
|
|
|
and runs well on several Windows and Unix platforms. </p>
|
2003-08-31 03:00:15 +02:00
|
|
|
|
2004-06-16 06:28:21 +02:00
|
|
|
<p>
|
2004-11-29 07:55:47 +01:00
|
|
|
Among the support modules, the most commonly used implement the
|
2004-06-16 22:41:03 +02:00
|
|
|
<a href=smtp.html>SMTP</a>
|
|
|
|
|
(sending e-mails),
|
|
|
|
|
<a href=http.html>HTTP</a>
|
|
|
|
|
(WWW access) and
|
|
|
|
|
<a href=ftp.html>FTP</a>
|
|
|
|
|
(uploading and downloading files) client
|
2004-11-29 07:55:47 +01:00
|
|
|
protocols. These provide a very natural and generic interface to the
|
|
|
|
|
functionality defined by each protocol.
|
2004-06-16 22:41:03 +02:00
|
|
|
In addition, you will find that the
|
|
|
|
|
<a href=mime.html>MIME</a> (common encodings),
|
|
|
|
|
<a href=url.html>URL</a>
|
|
|
|
|
(anything you could possible want to do with one) and
|
|
|
|
|
<a href=ltn12.html>LTN12</a>
|
|
|
|
|
(filters, sinks, sources and pumps) modules can be very handy.
|
2004-06-16 06:28:21 +02:00
|
|
|
</p>
|
|
|
|
|
|
2003-08-31 03:00:15 +02:00
|
|
|
<p>
|
|
|
|
|
The library is available under the same
|
|
|
|
|
<a href="http://www.lua.org/copyright.html">
|
|
|
|
|
terms and conditions</a> as the Lua language, the MIT license. The idea is
|
|
|
|
|
that if you can use Lua in a project, you should also be able to use
|
|
|
|
|
LuaSocket.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
2007-06-15 08:28:56 +02:00
|
|
|
Copyright © 2004-2007 Diego Nehab. All rights reserved. <br>
|
2003-08-31 03:00:15 +02:00
|
|
|
Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<!-- download +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
|
|
2004-01-20 21:24:51 +01:00
|
|
|
<h2 id=download>Download</h2>
|
2003-08-31 03:00:15 +02:00
|
|
|
|
|
|
|
|
<p>
|
2009-05-27 11:31:38 +02:00
|
|
|
LuaSocket version 2.0.3 is now available for download! It is
|
2007-06-15 08:28:56 +02:00
|
|
|
compatible with Lua 5.1, and has
|
2006-04-20 06:16:23 +02:00
|
|
|
been tested on Windows XP, Linux, and Mac OS X. Chances
|
2007-06-15 08:38:29 +02:00
|
|
|
are it works well on most UNIX distributions and Windows flavors.
|
2003-08-31 03:00:15 +02:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
2005-06-14 06:29:23 +02:00
|
|
|
The library can be downloaded in source code from the
|
|
|
|
|
<a href=http://luaforge.net/projects/luasocket/>LuaSocket
|
|
|
|
|
project page</a> at LuaForge.
|
2003-08-31 03:00:15 +02:00
|
|
|
Besides the full C and Lua source code for the library, the distribution
|
2004-11-29 07:55:47 +01:00
|
|
|
contains several examples, this user's manual and basic test procedures.
|
2003-08-31 03:00:15 +02:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
2005-11-21 08:04:44 +01:00
|
|
|
Danilo Tuler is maintaining Win32 binaries for LuaSocket, which are also
|
2005-06-14 06:29:23 +02:00
|
|
|
available from LuaForge. These are compatible with the
|
2006-04-20 06:16:23 +02:00
|
|
|
<a href=http://luaforge.net/projects/luabinaries>LuaBinaries</a>,
|
|
|
|
|
also available from LuaForge.
|
2003-08-31 03:00:15 +02:00
|
|
|
</p>
|
|
|
|
|
|
2007-06-15 08:28:56 +02:00
|
|
|
<p> Take a look at the <a
|
|
|
|
|
href=installation.html>installation</a> section of the
|
|
|
|
|
manual to find out how to properly install the library.
|
2006-04-20 06:32:06 +02:00
|
|
|
</p>
|
2006-04-20 06:16:23 +02:00
|
|
|
|
2004-02-04 15:29:11 +01:00
|
|
|
<!-- thanks +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
|
|
|
|
|
|
<h2 id=thanks>Special thanks</h2>
|
|
|
|
|
|
|
|
|
|
<p>
|
2009-05-27 11:31:38 +02:00
|
|
|
Throughout LuaSocket's history, many people gave suggestions
|
|
|
|
|
that helped improve it. For that, I thank the Lua community.
|
|
|
|
|
Special thanks go to David Burgess, who has helped push the
|
|
|
|
|
library to a new level of quality and from whom I have
|
|
|
|
|
learned a lot of stuff that doesn't show up in RFCs.
|
|
|
|
|
Special thanks also to Carlos Cassino, who played a big part
|
|
|
|
|
in the extensible design seen in the C core of LuaSocket
|
|
|
|
|
2.0. Mike Pall has been helping a lot too! Thanks to you
|
|
|
|
|
all!
|
2004-02-04 15:29:11 +01:00
|
|
|
</p>
|
|
|
|
|
|
2003-08-31 03:00:15 +02:00
|
|
|
<!-- whatsnew +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
|
|
|
|
|
|
<h2 id=new>What's New</h2>
|
|
|
|
|
|
2004-06-16 01:00:56 +02:00
|
|
|
<p>
|
2009-05-27 11:31:38 +02:00
|
|
|
2.0.3 is just a bug-fix/update release.
|
2007-06-15 08:28:56 +02:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<ul>
|
2011-05-25 22:57:22 +02:00
|
|
|
<li> Fixed: manual sample of HTTP authentication now uses correct
|
|
|
|
|
"authorization" header (Alexandre Ittner);
|
|
|
|
|
<li> Fixed: receive() returns immediatelly if prefix can satisfy
|
|
|
|
|
bytes requested (M Joonas Pihlaja);
|
2009-05-27 11:31:38 +02:00
|
|
|
<li> Fixed: multicast didn't work on Windows, or anywhere
|
2011-05-25 22:57:22 +02:00
|
|
|
else for that matter (Herbert Leuwer, Adrian Sietsma);
|
2009-05-27 11:31:38 +02:00
|
|
|
<li> Fixed: select() now reports an error when called with more
|
2011-05-25 22:57:22 +02:00
|
|
|
sockets than FD_SETSIZE (Lorenzo Leonini);
|
|
|
|
|
<li> Fixed: manual links to home.html changed to index.html (Robert Hahn);
|
2009-05-27 11:31:38 +02:00
|
|
|
<li> Fixed: mime.unb64() would return an empty string on results that started
|
2011-05-25 22:57:22 +02:00
|
|
|
with a null character (Robert Raschke);
|
|
|
|
|
<li> Fixed: HTTP now automatically redirects on 303 and 307 (Jonathan Gray);
|
2009-05-27 11:31:38 +02:00
|
|
|
<li> Fixed: calling sleep() with negative numbers could
|
|
|
|
|
block forever, wasting CPU. Now it returns immediately (MPB);
|
|
|
|
|
<li> Improved: FTP commands are now sent in upper case to
|
2011-05-25 22:57:22 +02:00
|
|
|
help buggy servers (Anders Eurenius);
|
2009-05-27 11:31:38 +02:00
|
|
|
<li> Improved: known headers now sent in canonic
|
|
|
|
|
capitalization to help buggy servers (Joseph Stewart);
|
|
|
|
|
<li> Improved: Clarified tcp:receive() in the manual (MPB);
|
|
|
|
|
<li> Improved: Decent makefiles (LHF).
|
2003-08-31 03:00:15 +02:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<!-- old ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
|
|
|
|
|
|
<h2 id=old>Old Versions</h2>
|
|
|
|
|
|
|
|
|
|
<p>
|
2005-01-03 01:13:14 +01:00
|
|
|
All previous versions of the LuaSocket library can be downloaded <a
|
|
|
|
|
href="http://www.cs.princeton.edu/~diego/professional/luasocket/old">
|
|
|
|
|
here</a>. Although these versions are no longer supported, they are
|
|
|
|
|
still available for those that have compatibility issues.
|
2003-08-31 03:00:15 +02:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<!-- footer +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
|
|
|
|
|
|
<div class=footer>
|
|
|
|
|
<hr>
|
|
|
|
|
<center>
|
|
|
|
|
<p class=bar>
|
2009-05-27 11:31:38 +02:00
|
|
|
<a href="index.html#download">download</a> ·
|
2004-12-13 07:26:01 +01:00
|
|
|
<a href="installation.html">installation</a> ·
|
2003-08-31 03:00:15 +02:00
|
|
|
<a href="introduction.html">introduction</a> ·
|
|
|
|
|
<a href="reference.html">reference</a>
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
<small>
|
|
|
|
|
Last modified by Diego Nehab on <br>
|
2007-10-14 01:55:20 +02:00
|
|
|
Wed Oct 3 02:07:59 BRT 2007
|
2003-08-31 03:00:15 +02:00
|
|
|
</small>
|
|
|
|
|
</p>
|
|
|
|
|
</center>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
