LuaSocket: DNS support

From 534b0cedf714d4de0a6cf67570e11f232cdccf84 Mon Sep 17 00:00:00 2001 From: Diego Nehab Date: Sun, 28 Nov 2004 08:17:16 +0000 Subject: Added new instalation section to the manual. --- doc/dns.html | 4 +- doc/ftp.html | 4 +- doc/http.html | 4 +- doc/index.html | 84 +++++++++++++++------------- doc/installation.html | 149 ++++++++++++++++++++++++++++++++++++++++++++++++++ doc/introduction.html | 39 +++++-------- doc/ltn12.html | 6 +- doc/mime.html | 4 +- doc/reference.html | 5 +- doc/smtp.html | 5 +- doc/socket.html | 4 +- doc/tcp.html | 4 +- doc/udp.html | 4 +- doc/url.html | 4 +- 14 files changed, 245 insertions(+), 75 deletions(-) create mode 100644 doc/installation.html (limited to 'doc') diff --git a/doc/dns.html b/doc/dns.html index 09a9bdb..2c4c51f 100644 --- a/doc/dns.html +++ b/doc/dns.html @@ -4,7 +4,7 @@ - + LuaSocket: DNS support @@ -26,6 +26,7 @@

home · download · +instalation · introduction · reference

@@ -114,6 +115,7 @@ message.

home · download · +instalation · introduction · reference

diff --git a/doc/ftp.html b/doc/ftp.html index 0b52007..a1a5162 100644 --- a/doc/ftp.html +++ b/doc/ftp.html @@ -4,7 +4,7 @@ - + LuaSocket: FTP support @@ -26,6 +26,7 @@

home · download · +instalation · introduction · reference

@@ -265,6 +266,7 @@ f, e = ftp.put{

home · download · +instalation · introduction · reference

diff --git a/doc/http.html b/doc/http.html index 13acd1c..deacaa5 100644 --- a/doc/http.html +++ b/doc/http.html @@ -4,7 +4,7 @@ - + LuaSocket: HTTP support @@ -27,6 +27,7 @@ home · download · introduction · +introduction · reference

@@ -299,6 +300,7 @@ r, c = http.request {

home · download · +instalation · introduction · reference

diff --git a/doc/index.html b/doc/index.html index c0a46ea..c3c391f 100644 --- a/doc/index.html +++ b/doc/index.html @@ -4,7 +4,7 @@ - + LuaSocket: Network support for the Lua language @@ -26,6 +26,7 @@

home · download · +instalation · introduction · reference

@@ -79,7 +80,7 @@ LuaSocket.

-Copyright © 1999-2004 Tecgraf/PUC-Rio. All rights reserved.
+Copyright © 2004 Diego Nehab. All rights reserved.
Author: Diego Nehab

@@ -88,7 +89,7 @@ Author: Diego Nehab

Download

-LuaSocket version 2.0 beta2 is now available for download! It is +LuaSocket version 2.0 (beta3) is now available for download! It is compatible with Lua 5.0 and has been tested on Windows XP, Linux, and Mac OS X.

@@ -99,8 +100,8 @@ The library can be downloaded in source code from the following links:

-luasocket-2.0-beta2.tar.gz
-luasocket-2.0-beta2.zip +luasocket-2.0-beta3.tar.gz
+luasocket-2.0-beta3.zip

@@ -116,7 +117,7 @@ LuaSocket a quick try:

-luasocket-2.0-beta2-win32.zip +luasocket-2.0-beta3-win32.zip

@@ -124,11 +125,15 @@ LuaSocket a quick try: The quick and dirty way to use these binaries is to unpack everything into a directory, say c:\luasocket (include all Lua files from the LuaSocket distrbitution in the same directory too!). -Then set LUA_INIT to load the lua.lua helper file: +Then set LUA_INIT to load the compat-5.1.lua and set +LUA_PATH and LUA_CPATH to look for files in that +directory:

-c:\luasocket\> set LUA_INIT=@lua.lua
+c:\luasocket\> set LUA_INIT=@compat-5.1.lua
+c:\luasocket\> set LUA_CPATH=?.dll
+c:\luasocket\> set LUA_PATH=?.lua

@@ -142,9 +147,13 @@ c:\luasocket\> lua Lua 5.0.2 Copyright (C) 1994-2004 Tecgraf, PUC-Rio > http = require"http" > print(http.request"http://www.tecgraf.puc-rio.br/luasocket/") ---> this file +--> this gets dumped to terminal +

Take a look at the installation section of +the manual to find out how to properly install the library after you are +done playing with it.

Special thanks

@@ -165,35 +174,31 @@ has been helping a lot too! Thanks to you all!

What's New

-Changes in the 2.0-beta2 were mostly bug-fixes. +The big change for the 2.0 (beta3) release was the adoption of the Lua 5.1 +package proposal. There were several bug fixes too (a beta is a +beta, is a beta).

Fixed silly last-minute-change bug in HTTP/SMTP; -
usocket.c/wsocket.c look nicer thanks to Mike; -
Finally total timeout is reliable on Windows! (found a pretty -simple work around); -
UDP has a reasonable maximum datagram size (8k); -
Receive accepts the prefix optional argument (good for -non-blocking); -
Send doesn't support multiple arguments anymore; -
Instead, send allows the selection of the substring -to be sent (good for non-blocking); -
Fixed bug that caused select return tables not to be associative -on windows; -
Should compile with g++; -
New sample unix domain support; -
New sample LPD support; -
Comprehensive error messages; -
New getstats and setstats methods to help throttling; -
Listen defaults to 32 backlog; -
SMTP/FTP/HTTP fail gracefully; -
accept/connect/select interrupt safe -
Fixed bug that didn't set accepted sockets as non-blocking -
New timming functions sleep and gettime have -higher resolution and no wrap around problems; -
Bug fixes in the manual; -
Fixed bug of missing cast in getfd. +
New compat-5.1 distribution: +
- Instalation uses new directory structure; +
- Namespace hierarchy is in now back in use (ex. socket.url + instead of url); +
- Globals not visible from inside namespaces; +
- All modules call require even for standard libraries; +
+
LTN12 avoids coroutines (so you can go wild on the C side); +
Kludge on wsocket.c:sock_send for windows timeout issue + moved to buffer.c:sendraw; +
socket.protect only catches errors thrown by socket.try; +
Fixed udp:sendto to call sock_sendto instead of + sock_send; +
close wasn't returning 1! +
socket.gettime returns time since Unix Epoch 1/1/1970 (UTC) +
socket.sleep is robust to interrupts; +
socket.select wasn't calling tm_markstart; +
http.PROXY etc wasn't working.

@@ -201,10 +206,9 @@ higher resolution and no wrap around problems;

Incompatibilities with previous versions

New send inteface doesn't send multiple arguments anymore; -
Time is replaced by gettime with advantage. - +
Namespaces are hierarchical again. This means that whoever called +require("url") should update their code to +require("socket.url").

@@ -225,6 +229,8 @@ those that have compatibility issues.

download · +download · +instalation · introduction · reference

diff --git a/doc/installation.html b/doc/installation.html new file mode 100644 index 0000000..d5e82d9 --- /dev/null +++ b/doc/installation.html @@ -0,0 +1,149 @@ + + + + + + +LuaSocket: Instalation + + + + + + + + + + + +

Instalation

+ +

LuaSocket 2.0 uses the new package proposal for Lua 5.1, throught the +compatibility module +Compat-5.1 released in conjunction with Roberto Ierusalimschy and The Kepler project. The proposal +was considered important enough by the community to justify early adoption. +All Lua library developers are encouraged to change their libraries in +preparation for the release of Lua 5.1.

+ +

As far as LuaSocket is concerned, this means that whoever is +deploying a solution that uses LuaSocket has a lot of freedom. Here we +describe only the standard distribution. If the standard doesn't meet your +needs, we refer you to the Lua discussion list, where any quesetion about +the package scheme will likely be answered promptly. +

+ +

Directory structure

+ +

The new package scheme has a root directory for the libraries installed +on a given system. Let's call this directory <ROOT>. +On my system, this is the /usr/local/share/lua/5.0 directory. +Here is the standard LuaSocket distribution directory structure:

+ +

+<ROOT>/compat-5.1.lua
+<ROOT>/socket.lua
+<ROOT>/lsocket.dll
+<ROOT>/mime.lua
+<ROOT>/lmime.dll
+<ROOT>/ltn12.lua
+<ROOT>/socket/http.lua
+<ROOT>/socket/tp.lua
+<ROOT>/socket/ftp.lua
+<ROOT>/socket/smtp.lua
+<ROOT>/socket/url.lua
+

+ +

Naturally, on Unix systems, lsocket.dll and lmime.dll +would be replaced by lsocket.so and lmime.so. In Mac OS +X, they would be replaced by lsocket.dylib and +lmime.dylib.

+ +

In order for the interpreter to find all LuaSocket components, three +environment variables need to be set. The first environment variable tells +the interpreter to load the compat-5.1.lua module.

+ +

+LUA_INIT=@<ROOT>/compat-5.1.lua
+

+ +The other two environment variables instruct the compatibility module to +look for dynamic libraries and modules in the appropriate directories and +with the appropriate filename extensions. + +

+LUA_PATH=<ROOT>/?.lua;?.lua
+LUA_CPATH=<ROOT>/?.dll;?.dll
+

+ +

Again, naturally, in Unix the shared library extension would be +.so instead of .dll and on Mac OS X they would be +.dylib

+ +

Using LuaSocket

+ +

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 +require function to gain access to whatever module you need:

+ +

+Lua 5.0.2  Copyright (C) 1994-2004 Tecgraf, PUC-Rio
+> socket = require("socket")
+> print(socket.VERSION)
+--> LuaSocket 2.0 (beta3)
+

+ +

Each module loads their dependencies automatically, so you only need to +load the modues you are directly dependent upon.

+ +

+Lua 5.0.2  Copyright (C) 1994-2004 Tecgraf, PUC-Rio
+> http = require("socket.http")
+> print(http.get("http://www.tecgraf.puc-rio.br/luasocket"))
+--> homepage gets dumped to terminal
+

+ + + + + + + diff --git a/doc/introduction.html b/doc/introduction.html index 20c4d36..a285b81 100644 --- a/doc/introduction.html +++ b/doc/introduction.html @@ -4,7 +4,8 @@ - + LuaSocket: Introduction to the core @@ -26,6 +27,7 @@

home · download · +instalation · introduction · reference

@@ -104,29 +106,6 @@ Together, these changes make network programming in LuaSocket much simpler than it is in C, as the following sections will show.

- - -

Initializing the library

- -

-The core LuaSocket is almost entirely implemented in C. It is -usually available as a dynamic library which the interpreter can load -with the help of a loader module written in Lua. -Beginning with version 2.0 and following the Lua 5.0 trend, all LuaSocket -functionality is defined inside tables (or rather namespaces). No global -variables are ever created. -Namespaces are obtained with the require Lua function, which loads -and initializes any required library and returns the namespace. -For example, the core functionality or LuaSocket is usually available -from the "socket" namespace. -

- -

-socket = require("socket")
-print(socket.VERSION)
---> LuaSocket 2.0
-

TCP

@@ -318,6 +297,17 @@ io.write(socket.try((udp:receive()))) + + +

Much more

+ +

LuaSocket offers much more than TCP and UDP support. As the library +evolved, support for HTTP, FTP, +SMTP, MIME, URLs and much more was made available. These are +mostly implemented in Lua itself, with critical parts implemented in C for +efficiency

@@ -326,6 +316,7 @@ io.write(socket.try((udp:receive())))

home · download · +instalation · introduction · reference

diff --git a/doc/ltn12.html b/doc/ltn12.html index 40dcf96..4b8f188 100644 --- a/doc/ltn12.html +++ b/doc/ltn12.html @@ -4,8 +4,8 @@ - + LuaSocket: LTN12 module @@ -27,6 +27,7 @@ Pump, Support">

home · download · +instalation · introduction · reference

@@ -412,6 +413,7 @@ Creates and returns a source that produces the contents of a

home · download · +instalation · introduction · reference

diff --git a/doc/mime.html b/doc/mime.html index 6758a4b..594d749 100644 --- a/doc/mime.html +++ b/doc/mime.html @@ -4,7 +4,7 @@ - + LuaSocket: MIME module @@ -26,6 +26,7 @@

home · download · +instalation · introduction · reference

@@ -458,6 +459,7 @@ marker.

home · download · +instalation · introduction · reference

diff --git a/doc/reference.html b/doc/reference.html index 744da58..b15a2aa 100644 --- a/doc/reference.html +++ b/doc/reference.html @@ -4,7 +4,8 @@ - + LuaSocket: Index to reference manual @@ -26,6 +27,7 @@

home · download · +instalation · introduction · reference

@@ -220,6 +222,7 @@

home · download · +instalation · introduction · reference

diff --git a/doc/smtp.html b/doc/smtp.html index 4a9aaac..27223ae 100644 --- a/doc/smtp.html +++ b/doc/smtp.html @@ -4,7 +4,8 @@ - + LuaSocket: SMTP support @@ -26,6 +27,7 @@

home · download · +instalation · introduction · reference

@@ -394,6 +396,7 @@ r, e = smtp.send{

home · download · +instalation · introduction · reference

diff --git a/doc/socket.html b/doc/socket.html index c7525eb..809c256 100644 --- a/doc/socket.html +++ b/doc/socket.html @@ -4,7 +4,7 @@ - + LuaSocket: The socket namespace @@ -26,6 +26,7 @@

home · download · +instalation · introduction · reference

@@ -382,6 +383,7 @@ This constant has a string describing the current LuaSocket version.

home · download · +instalation · introduction · reference

diff --git a/doc/tcp.html b/doc/tcp.html index dfc2c29..57784ea 100644 --- a/doc/tcp.html +++ b/doc/tcp.html @@ -4,7 +4,7 @@ - + LuaSocket: TCP/IP support @@ -26,6 +26,7 @@

home · download · +instalation · introduction · reference

@@ -527,6 +528,7 @@ This function returns 1.

home · download · +instalation · introduction · reference

diff --git a/doc/udp.html b/doc/udp.html index b0c51f6..f712b2f 100644 --- a/doc/udp.html +++ b/doc/udp.html @@ -4,7 +4,7 @@ - + LuaSocket: UDP support @@ -26,6 +26,7 @@

home · download · +instalation · introduction · reference

@@ -398,6 +399,7 @@ imperative nature obvious.

home · download · +instalation · introduction · reference

diff --git a/doc/url.html b/doc/url.html index 92acf36..5c2be65 100644 --- a/doc/url.html +++ b/doc/url.html @@ -4,7 +4,7 @@ - + LuaSocket: URL support @@ -26,6 +26,7 @@

home · download · +instalation · introduction · reference

@@ -311,6 +312,7 @@ The function returns the decoded string.

home · download · +instalation · introduction · reference

-- cgit v1.2.3-55-g6feb