comparison doc/index.html @ 0:4b915342e2a8

LuaSocket 2.0.2 + CMake build description.
author Eric Wing <ewing . public |-at-| gmail . com>
date Tue, 26 Aug 2008 18:40:01 -0700
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:4b915342e2a8
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
2 "http://www.w3.org/TR/html4/strict.dtd">
3 <html>
4
5 <head>
6 <meta name="description" content="The LuaSocket Homepage">
7 <meta name="keywords" content="Lua, LuaSocket, Network, Library, Support, Internet">
8 <title>LuaSocket: Network support for the Lua language </title>
9 <link rel="stylesheet" href="reference.css" type="text/css">
10 </head>
11
12 <body>
13
14 <!-- header +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
15
16 <div class=header>
17 <hr>
18 <center>
19 <table summary="LuaSocket logo">
20 <tr><td align=center><a href="http://www.lua.org">
21 <img width=128 height=128 border=0 alt="LuaSocket" src="luasocket.png">
22 </a></td></tr>
23 <tr><td align=center valign=top>Network support for the Lua language
24 </td></tr>
25 </table>
26 <p class=bar>
27 <a href="home.html">home</a> &middot;
28 <a href="home.html#download">download</a> &middot;
29 <a href="installation.html">installation</a> &middot;
30 <a href="introduction.html">introduction</a> &middot;
31 <a href="reference.html">reference</a>
32 </p>
33 </center>
34 <hr>
35 </div>
36
37 <!-- whatis +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
38
39 <h2 id=whatis>What is LuaSocket?</h2>
40
41 <p>
42 LuaSocket is a <a href="http://www.lua.org">Lua</a> extension library
43 that is composed by two parts: a C core that provides support for the TCP
44 and UDP transport layers, and a set of Lua modules that add support for
45 functionality commonly needed by applications that deal with the Internet.
46 </p>
47
48 <p>
49 The core support has been implemented so that it is both efficient and
50 simple to use. It is available to any Lua application once it has been
51 properly initialized by the interpreter in use. The code has been tested
52 and runs well on several Windows and Unix platforms. </p>
53
54 <p>
55 Among the support modules, the most commonly used implement the
56 <a href=smtp.html>SMTP</a>
57 (sending e-mails),
58 <a href=http.html>HTTP</a>
59 (WWW access) and
60 <a href=ftp.html>FTP</a>
61 (uploading and downloading files) client
62 protocols. These provide a very natural and generic interface to the
63 functionality defined by each protocol.
64 In addition, you will find that the
65 <a href=mime.html>MIME</a> (common encodings),
66 <a href=url.html>URL</a>
67 (anything you could possible want to do with one) and
68 <a href=ltn12.html>LTN12</a>
69 (filters, sinks, sources and pumps) modules can be very handy.
70 </p>
71
72 <p>
73 The library is available under the same
74 <a href="http://www.lua.org/copyright.html">
75 terms and conditions</a> as the Lua language, the MIT license. The idea is
76 that if you can use Lua in a project, you should also be able to use
77 LuaSocket.
78 </p>
79
80 <p>
81 Copyright &copy; 2004-2007 Diego Nehab. All rights reserved. <br>
82 Author: <A href="http://www.cs.princeton.edu/~diego">Diego Nehab</a>
83 </p>
84
85 <!-- download +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
86
87 <h2 id=download>Download</h2>
88
89 <p>
90 LuaSocket version 2.0.2 is now available for download! It is
91 compatible with Lua&nbsp;5.1, and has
92 been tested on Windows&nbsp;XP, Linux, and Mac OS X. Chances
93 are it works well on most UNIX distributions and Windows flavors.
94 </p>
95
96 <p>
97 The library can be downloaded in source code from the
98 <a href=http://luaforge.net/projects/luasocket/>LuaSocket
99 project page</a> at LuaForge.
100 Besides the full C and Lua source code for the library, the distribution
101 contains several examples, this user's manual and basic test procedures.
102 </p>
103
104 <p>
105 Danilo Tuler is maintaining Win32 binaries for LuaSocket, which are also
106 available from LuaForge. These are compatible with the
107 <a href=http://luaforge.net/projects/luabinaries>LuaBinaries</a>,
108 also available from LuaForge.
109 </p>
110
111 <p> Take a look at the <a
112 href=installation.html>installation</a> section of the
113 manual to find out how to properly install the library.
114 </p>
115
116 <!-- thanks +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
117
118 <h2 id=thanks>Special thanks</h2>
119
120 <p>
121 Throughout LuaSocket's history, many people gave suggestions that helped
122 improve it. For that, I thank the Lua community.
123 Special thanks go to
124 David Burgess, who has helped push the library to a new level of quality and
125 from whom I have learned a lot of stuff that doesn't show up in RFCs.
126 Special thanks also to Carlos Cassino, who played a big part in the
127 extensible design seen in the C core of LuaSocket 2.0. Mike Pall
128 has been helping a lot too! Thanks to you all!
129 </p>
130
131 <!-- whatsnew +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
132
133 <h2 id=new>What's New</h2>
134
135 <p>
136 2.0.2 is just a bug-fix/update release.
137 </p>
138
139 <ul>
140 <li> Improved: http.request() now supports deprecated
141 HTTP/0.9 servers (Florian Berger);
142 <li> Fixed: could return "timedout" instead of "timeout" (Leo Leo);
143 <li> Fixed: crash when reading '*a' on closed socket (Paul Ducklin);
144 <li> Fixed: return values are consistent when reading from closed sockets;
145 <li> Fixed: case sensitivity in headers of multipart
146 messages in smtp.message() (Graham Henstridge);
147 <li> Fixed a couple instances of error() being called instead of
148 base.error(). These would cause an error when an error was
149 reported :) (Ketmar Dark);
150 <li> Fixed: test script now uses pairs() iterator instead
151 of the old Lua syntax (Robert Dodier).
152 </ul>
153
154 <p>
155 2.0.1 is just a bug-fix/update release.
156 </p>
157
158 <ul>
159 <li> Updated: now using <tt>compat-5.1r5</tt>;
160 <li> Improved: <tt>http.request</tt> is more robust to
161 malformed URLs (Adrian Sietsma);
162 <li> Improved: the simple <tt>http.request</tt> interface sends a
163 "<tt>Content-type: application/x-www-form-urlencoded</tt>"
164 header (William Trenker);
165 <li> Improved: <tt>http.request</tt> is robust to evil
166 servers that send inappropriate 100-continue messages
167 (David Burgess);
168 <li> Fixed: <tt>http.request</tt> was using the old host header during
169 redirects (Florian Berger);
170 <li> Fixed: sample <tt>unix.c</tt> had fallen through the
171 cracks during development (Matthew Percival);
172 <li> Fixed: error code was not being propagated correctly in
173 ftp.lua (David Burgess).
174 </ul>
175
176 <!-- old ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
177
178 <h2 id=old>Old Versions</h2>
179
180 <p>
181 All previous versions of the LuaSocket library can be downloaded <a
182 href="http://www.cs.princeton.edu/~diego/professional/luasocket/old">
183 here</a>. Although these versions are no longer supported, they are
184 still available for those that have compatibility issues.
185 </p>
186
187 <!-- footer +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
188
189 <div class=footer>
190 <hr>
191 <center>
192 <p class=bar>
193 <a href="home.html#download">download</a> &middot;
194 <a href="installation.html">installation</a> &middot;
195 <a href="introduction.html">introduction</a> &middot;
196 <a href="reference.html">reference</a>
197 </p>
198 <p>
199 <small>
200 Last modified by Diego Nehab on <br>
201 Wed Oct 3 02:07:59 BRT 2007
202 </small>
203 </p>
204 </center>
205 </div>
206
207 </body>
208 </html>