aboutsummaryrefslogtreecommitdiff
path: root/doc/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/index.html')
-rw-r--r--doc/index.html140
1 files changed, 70 insertions, 70 deletions
diff --git a/doc/index.html b/doc/index.html
index 7d81b41..e92b4d4 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -1,4 +1,4 @@
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
2 "http://www.w3.org/TR/html4/strict.dtd"> 2 "http://www.w3.org/TR/html4/strict.dtd">
3<html> 3<html>
4 4
@@ -13,22 +13,22 @@
13 13
14<!-- header +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 14<!-- header +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
15 15
16<div class=header> 16<div class="header">
17<hr> 17<hr>
18<center> 18<center>
19<table summary="LuaSocket logo"> 19<table summary="LuaSocket logo">
20<tr><td align=center><a href="http://www.lua.org"> 20<tr><td align="center"><a href="http://www.lua.org">
21<img width=128 height=128 border=0 alt="LuaSocket" src="luasocket.png"> 21<img width="128" height="128" border="0" alt="LuaSocket" src="luasocket.png">
22</a></td></tr> 22</a></td></tr>
23<tr><td align=center valign=top>Network support for the Lua language 23<tr><td align="center" valign="top">Network support for the Lua language
24</td></tr> 24</td></tr>
25</table> 25</table>
26<p class=bar> 26<p class="bar">
27<a href="index.html">home</a> &middot; 27<a href="index.html">home</a> &middot;
28<a href="index.html#download">download</a> &middot; 28<a href="index.html#download">download</a> &middot;
29<a href="installation.html">installation</a> &middot; 29<a href="installation.html">installation</a> &middot;
30<a href="introduction.html">introduction</a> &middot; 30<a href="introduction.html">introduction</a> &middot;
31<a href="reference.html">reference</a> 31<a href="reference.html">reference</a>
32</p> 32</p>
33</center> 33</center>
34<hr> 34<hr>
@@ -36,13 +36,13 @@
36 36
37<!-- whatis +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 37<!-- whatis +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
38 38
39<h2 id=whatis>What is LuaSocket?</h2> 39<h2 id="whatis">What is LuaSocket?</h2>
40 40
41<p> 41<p>
42LuaSocket is a <a href="http://www.lua.org">Lua</a> extension library 42LuaSocket is a <a href="http://www.lua.org">Lua</a> extension library
43that is composed by two parts: a C core that provides support for the TCP 43that is composed by two parts: a C core that provides support for the TCP
44and UDP transport layers, and a set of Lua modules that add support for 44and UDP transport layers, and a set of Lua modules that add support for
45functionality commonly needed by applications that deal with the Internet. 45functionality commonly needed by applications that deal with the Internet.
46</p> 46</p>
47 47
48<p> 48<p>
@@ -52,43 +52,43 @@ properly initialized by the interpreter in use. The code has been tested
52and runs well on several Windows and UNIX platforms. </p> 52and runs well on several Windows and UNIX platforms. </p>
53 53
54<p> 54<p>
55Among the support modules, the most commonly used implement the 55Among the support modules, the most commonly used implement the
56<a href=smtp.html>SMTP</a> 56<a href="smtp.html">SMTP</a>
57(sending e-mails), 57(sending e-mails),
58<a href=http.html>HTTP</a> 58<a href="http.html">HTTP</a>
59(WWW access) and 59(WWW access) and
60<a href=ftp.html>FTP</a> 60<a href="ftp.html">FTP</a>
61(uploading and downloading files) client 61(uploading and downloading files) client
62protocols. These provide a very natural and generic interface to the 62protocols. These provide a very natural and generic interface to the
63functionality defined by each protocol. 63functionality defined by each protocol.
64In addition, you will find that the 64In addition, you will find that the
65<a href=mime.html>MIME</a> (common encodings), 65<a href="mime.html">MIME</a> (common encodings),
66<a href=url.html>URL</a> 66<a href="url.html">URL</a>
67(anything you could possible want to do with one) and 67(anything you could possible want to do with one) and
68<a href=ltn12.html>LTN12</a> 68<a href="ltn12.html">LTN12</a>
69(filters, sinks, sources and pumps) modules can be very handy. 69(filters, sinks, sources and pumps) modules can be very handy.
70</p> 70</p>
71 71
72<p> 72<p>
73The library is available under the same 73The library is available under the same
74<a href="http://www.lua.org/copyright.html"> 74<a href="http://www.lua.org/copyright.html">
75terms and conditions</a> as the Lua language, the MIT license. The idea is 75terms and conditions</a> as the Lua language, the MIT license. The idea is
76that if you can use Lua in a project, you should also be able to use 76that if you can use Lua in a project, you should also be able to use
77LuaSocket. 77LuaSocket.
78</p> 78</p>
79 79
80<p> 80<p>
81Copyright &copy; 1999-2013 Diego Nehab. All rights reserved. <br> 81Copyright &copy; 1999-2013 Diego Nehab. All rights reserved. <br>
82Author: <A href="http://www.impa.br/~diego">Diego Nehab</a> 82Author: <a href="http://www.impa.br/~diego">Diego Nehab</a>
83</p> 83</p>
84 84
85<!-- download +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 85<!-- download +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
86 86
87<h2 id=download>Download</h2> 87<h2 id="download">Download</h2>
88 88
89<p> 89<p>
90LuaSocket version 3.0-rc1 is now available for download! 90LuaSocket version 3.0-rc1 is now available for download!
91It is compatible with Lua&nbsp;5.1 and 5.2, and has 91It is compatible with Lua&nbsp;5.1 and 5.2, and has
92been tested on Windows&nbsp;XP, Linux, and Mac OS X. Chances 92been tested on Windows&nbsp;XP, Linux, and Mac OS X. Chances
93are it works well on most UNIX distributions and Windows flavors. 93are it works well on most UNIX distributions and Windows flavors.
94</p> 94</p>
@@ -96,19 +96,19 @@ are it works well on most UNIX distributions and Windows flavors.
96<p> 96<p>
97The current version of the library can be found at 97The current version of the library can be found at
98the <a href="https://github.com/diegonehab/luasocket">LuaSocket 98the <a href="https://github.com/diegonehab/luasocket">LuaSocket
99project page</a> on GitHub. Besides the full C and Lua source code 99project page</a> on GitHub. Besides the full C and Lua source code
100for the library, the distribution contains several examples, 100for the library, the distribution contains several examples,
101this user's manual and basic test procedures. 101this user's manual and basic test procedures.
102</p> 102</p>
103 103
104<p> Take a look at the <a 104<p> Take a look at the <a
105href=installation.html>installation</a> section of the 105href="installation.html">installation</a> section of the
106manual to find out how to properly install the library. 106manual to find out how to properly install the library.
107</p> 107</p>
108 108
109<!-- thanks +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 109<!-- thanks +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
110 110
111<h2 id=thanks>Special thanks</h2> 111<h2 id="thanks">Special thanks</h2>
112 112
113<p> 113<p>
114This marks the first release of LuaSocket that 114This marks the first release of LuaSocket that
@@ -118,85 +118,85 @@ convinced me it was time for a release including IPv6 and
118Lua 5.2 support. It was more work than we anticipated. 118Lua 5.2 support. It was more work than we anticipated.
119Special thanks to Sam Roberts, Florian Zeitz, and Paul 119Special thanks to Sam Roberts, Florian Zeitz, and Paul
120Aurich, Liam Devine, Alexey Melnichuk, and everybody else 120Aurich, Liam Devine, Alexey Melnichuk, and everybody else
121that has helped bring this library back to life. 121that has helped bring this library back to life.
122</p> 122</p>
123 123
124<!-- whatsnew +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 124<!-- whatsnew +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
125 125
126<h2 id=new>What's New</h2> 126<h2 id="new">What's New</h2>
127 127
128<p> 128<p>
129Main changes for LuaSocket&nbsp;3.0-rc1 are IPv6 support 129Main changes for LuaSocket&nbsp;3.0-rc1 are IPv6 support
130and Lua&nbsp;5.2 compatibility. 130and Lua&nbsp;5.2 compatibility.
131</p> 131</p>
132 132
133<ul> 133<ul>
134<li> Added: Compatible with Lua&nbsp;5.2 134<li> Added: Compatible with Lua&nbsp;5.2</li>
135<ul> 135<ul>
136<li> Note that unless you define <tt>LUA_COMPAT_MODULE</tt>, 136<li> Note that unless you define <tt>LUA_COMPAT_MODULE</tt>,
137package tables will <em>not</em> be exported as globals! 137package tables will <em>not</em> be exported as globals!</li>
138</ul> 138</ul>
139<li> Added: IPv6 support; 139<li> Added: IPv6 support;</li>
140<ul> 140<ul>
141<li> <tt>Socket.connect</tt> and <tt>socket.bind</tt> support IPv6 addresses; 141<li> <tt>Socket.connect</tt> and <tt>socket.bind</tt> support IPv6 addresses;</li>
142<li> <tt>Getpeername</tt> and <tt>getsockname</tt> support 142<li> <tt>Getpeername</tt> and <tt>getsockname</tt> support
143IPv6 addresses, and return the socket family as a third value; 143IPv6 addresses, and return the socket family as a third value;</li>
144<li> URL module updated to support IPv6 host names; 144<li> URL module updated to support IPv6 host names;</li>
145<li> New <tt>socket.tcp6</tt> and <tt>socket.udp6</tt> functions; 145<li> New <tt>socket.tcp6</tt> and <tt>socket.udp6</tt> functions;</li>
146<li> New <tt>socket.dns.getaddrinfo</tt> and 146<li> New <tt>socket.dns.getaddrinfo</tt> and
147 <tt>socket.dns.getnameinfo</tt> functions; 147 <tt>socket.dns.getnameinfo</tt> functions;</li>
148</ul> 148</ul>
149<li> Added: <tt>getoption</tt> method; 149<li> Added: <tt>getoption</tt> method;</li>
150<li> Fixed: <tt>url.unescape</tt> was returning additional values; 150<li> Fixed: <tt>url.unescape</tt> was returning additional values;</li>
151<li> Fixed: <tt>mime.qp</tt>, <tt>mime.unqp</tt>, 151<li> Fixed: <tt>mime.qp</tt>, <tt>mime.unqp</tt>,
152 <tt>mime.b64</tt>, and <tt>mime.unb64</tt> could 152 <tt>mime.b64</tt>, and <tt>mime.unb64</tt> could
153 mistaking their own stack slots for functions arguments; 153 mistaking their own stack slots for functions arguments;</li>
154<li> Fixed: Receiving zero-length datagram is now possible; 154<li> Fixed: Receiving zero-length datagram is now possible;</li>
155<li> Improved: Hidden all internal library symbols; 155<li> Improved: Hidden all internal library symbols;</li>
156<li> Improved: Better error messages; 156<li> Improved: Better error messages;</li>
157<li> Improved: Better documentation of socket options. 157<li> Improved: Better documentation of socket options.</li>
158<li> Fixed: manual sample of HTTP authentication now uses correct 158<li> Fixed: manual sample of HTTP authentication now uses correct
159 "authorization" header (Alexandre Ittner); 159 "authorization" header (Alexandre Ittner);</li>
160<li> Fixed: failure on bind() was destroying the socket (Sam Roberts); 160<li> Fixed: failure on bind() was destroying the socket (Sam Roberts);</li>
161<li> Fixed: receive() returns immediatelly if prefix can satisfy 161<li> Fixed: receive() returns immediatelly if prefix can satisfy
162 bytes requested (M Joonas Pihlaja); 162 bytes requested (M Joonas Pihlaja);</li>
163<li> Fixed: multicast didn't work on Windows, or anywhere 163<li> Fixed: multicast didn't work on Windows, or anywhere
164 else for that matter (Herbert Leuwer, Adrian Sietsma); 164 else for that matter (Herbert Leuwer, Adrian Sietsma);</li>
165<li> Fixed: select() now reports an error when called with more 165<li> Fixed: select() now reports an error when called with more
166 sockets than FD_SETSIZE (Lorenzo Leonini); 166 sockets than FD_SETSIZE (Lorenzo Leonini);</li>
167<li> Fixed: manual links to home.html changed to index.html 167<li> Fixed: manual links to home.html changed to index.html
168(Robert Hahn); 168(Robert Hahn);</li>
169<li> Fixed: mime.unb64() would return an empty string on results that started 169<li> Fixed: mime.unb64() would return an empty string on results that started
170 with a null character (Robert Raschke); 170 with a null character (Robert Raschke);</li>
171<li> Fixed: HTTP now automatically redirects on 303 and 307 (Jonathan Gray); 171<li> Fixed: HTTP now automatically redirects on 303 and 307 (Jonathan Gray);</li>
172<li> Fixed: calling sleep() with negative numbers could 172<li> Fixed: calling sleep() with negative numbers could
173 block forever, wasting CPU. Now it returns immediately (MPB); 173 block forever, wasting CPU. Now it returns immediately (MPB);</li>
174<li> Improved: FTP commands are now sent in upper case to 174<li> Improved: FTP commands are now sent in upper case to
175 help buggy servers (Anders Eurenius); 175 help buggy servers (Anders Eurenius);</li>
176<li> Improved: known headers now sent in canonic 176<li> Improved: known headers now sent in canonic
177 capitalization to help buggy servers (Joseph Stewart); 177 capitalization to help buggy servers (Joseph Stewart);</li>
178<li> Improved: Clarified tcp:receive() in the manual (MPB); 178<li> Improved: Clarified tcp:receive() in the manual (MPB);</li>
179<li> Improved: Decent makefiles (LHF). 179<li> Improved: Decent makefiles (LHF).</li>
180<li> Fixed: RFC links in documentation now point to IETF (Cosmin Apreutesei). 180<li> Fixed: RFC links in documentation now point to IETF (Cosmin Apreutesei).</li>
181</ul> 181</ul>
182 182
183<!-- old ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 183<!-- old ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
184 184
185<h2 id=old>Old Versions</h2> 185<h2 id="old">Old Versions</h2>
186 186
187<p> 187<p>
188All previous versions of the LuaSocket library can be downloaded <a 188All previous versions of the LuaSocket library can be downloaded <a
189href="http://www.impa.br/~diego/software/luasocket/old"> 189href="http://www.impa.br/~diego/software/luasocket/old">
190here</a>. Although these versions are no longer supported, they are 190here</a>. Although these versions are no longer supported, they are
191still available for those that have compatibility issues. 191still available for those that have compatibility issues.
192</p> 192</p>
193 193
194<!-- footer +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 194<!-- footer +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
195 195
196<div class=footer> 196<div class="footer">
197<hr> 197<hr>
198<center> 198<center>
199<p class=bar> 199<p class="bar">
200<a href="index.html#download">download</a> &middot; 200<a href="index.html#download">download</a> &middot;
201<a href="installation.html">installation</a> &middot; 201<a href="installation.html">installation</a> &middot;
202<a href="introduction.html">introduction</a> &middot; 202<a href="introduction.html">introduction</a> &middot;
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-08-14 09:47:19 +0000