mirror of
https://github.com/lunarmodules/luasocket.git
synced 2024-12-27 04:48:21 +01:00
f960b3872a
Documented headers.lua Update copyright date everywhere Remove RCSID from files Move version back to 2.1 rather than 2.1.1 Fixed url package to support ipv6 hosts Changed "domain" to "family" in tcp and udp structures Implemented getfamily methods
183 lines
5.7 KiB
HTML
183 lines
5.7 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
|
|
"http://www.w3.org/TR/html4/strict.dtd">
|
|
<html>
|
|
|
|
<head>
|
|
<meta name="description" content="The LuaSocket Homepage">
|
|
<meta name="keywords" content="Lua, LuaSocket, Network, Library, Support, Internet">
|
|
<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">
|
|
<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>
|
|
|
|
<!-- whatis +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
<h2 id=whatis>What is LuaSocket?</h2>
|
|
|
|
<p>
|
|
LuaSocket is a <a href="http://www.lua.org">Lua</a> extension library
|
|
that is composed by two parts: a C core that provides support for the TCP
|
|
and UDP transport layers, and a set of Lua modules that add support for
|
|
functionality commonly needed by applications that deal with the Internet.
|
|
</p>
|
|
|
|
<p>
|
|
The core support has been implemented so that it is both efficient and
|
|
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>
|
|
|
|
<p>
|
|
Among the support modules, the most commonly used implement the
|
|
<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
|
|
protocols. These provide a very natural and generic interface to the
|
|
functionality defined by each protocol.
|
|
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.
|
|
</p>
|
|
|
|
<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>
|
|
Copyright © 1999-2012 Diego Nehab. All rights reserved. <br>
|
|
Author: <A href="http://www.impa.br/~diego">Diego Nehab</a>
|
|
</p>
|
|
|
|
<!-- download +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
<h2 id=download>Download</h2>
|
|
|
|
<p>
|
|
LuaSocket version 2.1-rc1 is now available for download!
|
|
It is compatible with Lua 5.1 and 5.2, and has
|
|
been tested on Windows XP, Linux, and Mac OS X. Chances
|
|
are it works well on most UNIX distributions and Windows flavors.
|
|
</p>
|
|
|
|
<p>
|
|
The library can be downloaded in source code from the
|
|
<a href="https://github.com/diegonehab/luasocket/downloads">LuaSocket
|
|
project page</a> at GitHub. Besides the full C and Lua source code
|
|
for the library, the distribution contains several examples,
|
|
this user's manual and basic test procedures.
|
|
</p>
|
|
|
|
<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.
|
|
</p>
|
|
|
|
<!-- thanks +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
<h2 id=thanks>Special thanks</h2>
|
|
|
|
<p>
|
|
This marks the first release of LuaSocket that
|
|
wholeheartedly embraces the open-source development
|
|
philosophy. After a long hiatus, Matthew Wild finally
|
|
convinced me it was time for a release including IPv6
|
|
and Lua 5.2 support. Special thanks to Sam Roberts, Florian
|
|
Zeitz, and Paul Aurich, Liam Devine, and everybody else that
|
|
has helped bring this library back to life.
|
|
</p>
|
|
|
|
<!-- whatsnew +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
<h2 id=new>What's New</h2>
|
|
|
|
<p>
|
|
Main changes for LuaSocket 2.1-rc1 are IPv6 support
|
|
and Lua 5.2 compatibility.
|
|
</p>
|
|
|
|
<ul>
|
|
<li> Added: Compatible with Lua 5.2 (using <tt>LUA_COMPAT_MODULE</tt>);
|
|
<li> Added: IPv6 support;
|
|
<ul>
|
|
<li> <tt>Socket.connect</tt> and <tt>socket.bind</tt> support IPv6 addresses;
|
|
<li> <tt>Getpeername</tt> and <tt>getsockname</tt> support IPv6 addresses;
|
|
<li> URL module updated to support IPv6 host names;
|
|
<li> New <tt>socket.tcp6</tt> and <tt>socket.udp6</tt> functions;
|
|
<li> New <tt>socket.dns.getaddrinfo</tt> function;
|
|
</ul>
|
|
<li> Added: <tt>getoption</tt> method;
|
|
<li> Fixed: <tt>url.unescape</tt> was returning additional values;
|
|
<li> Fixed: Receiving zero-length datagram is now possible;
|
|
<li> Improved: Hidden all internal library symbols;
|
|
<li> Improved: Better error messages;
|
|
<li> Improved: Better documentation of socket options.
|
|
</ul>
|
|
|
|
<!-- old ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
<h2 id=old>Old Versions</h2>
|
|
|
|
<p>
|
|
All previous versions of the LuaSocket library can be downloaded <a
|
|
href="http://www.impa.br/~diego/software/luasocket/old">
|
|
here</a>. Although these versions are no longer supported, they are
|
|
still available for those that have compatibility issues.
|
|
</p>
|
|
|
|
<!-- footer +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
|
|
|
|
<div class=footer>
|
|
<hr>
|
|
<center>
|
|
<p class=bar>
|
|
<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>
|
|
<p>
|
|
<small>
|
|
Last modified by Diego Nehab on <br>
|
|
Mon Apr 16 21:58:56 HKT 2012
|
|
</small>
|
|
</p>
|
|
</center>
|
|
</div>
|
|
|
|
</body>
|
|
</html>
|