Skip to content

Commit

Permalink
updated for 0.1.1 release
Browse files Browse the repository at this point in the history
  • Loading branch information
Keith Howe committed Jan 22, 2006
1 parent aea7222 commit 8edcc8c
Showing 1 changed file with 11 additions and 8 deletions.
19 changes: 11 additions & 8 deletions htdocs/index.html
Expand Up @@ -22,33 +22,36 @@ <h1><a name="introduction">Introduction</a></h1>
<p>Currently only the digest functions are mapped by this Lua binding.</p>

<h2><a name="introduction-dl">Downloads</a></h2>
<p>The latest version of <a href="http://luaforge.net/projects/luacrypto" title="luacrypto Luaforge project page">luacrypto</a> is 0.1.0, written by Keith Howe &lt;<a href="mailto:nezroy@luaforge.net">nezroy@luaforge.net</a>&gt;</p>
<p>The latest version of <a href="http://luaforge.net/projects/luacrypto" title="luacrypto Luaforge project page">luacrypto</a> is 0.1.1, written by Keith Howe &lt;<a href="mailto:nezroy@luaforge.net">nezroy@luaforge.net</a>&gt;</p>
<ul>
<li><a href="http://luaforge.net/frs/download.php/1386/luacrypto-0.1.0.tar.gz">luacrypto-0.1.0.tar.gz</a> - SHA-1: 8d37676edd5ee9d8b48bebb9820267769684bc99</li>
<li><a href="http://luaforge.net/frs/download.php/1395/luacrypto-0.1.1.tar.gz">luacrypto-0.1.1.tar.gz</a> - SHA-1: 295adeb343e0949005536ede880c8ed77619d30b</li>
</ul>

<h1><a name="requirements">Requirements</a></h1>
<ul>
<li>Lua 5.1 - <a href="http://www.lua.org/" title="Lua homepage">http://www.lua.org/</a>: luacrypto requires Lua 5.1 since it uses the new Lua package system. It should also work with Compat-5.1, though you will have to update the build and libraries in order to support this.</li>
<li>Lua 5.x - <a href="http://www.lua.org/" title="Lua homepage">http://www.lua.org/</a>: luacrypto uses the new Lua 5.1 package system. It will also work with Lua 5.0 using the included <a href="http://www.keplerproject.org/compat" title="Compat 5.1 by the Kepler Project">Compat-5.1 emulation system</a>.</li>
<li>libcrypto 0.9.7+ - <a href="http://www.openssl.org/" title="OpenSSL homepage">http://www.openssl.org/</a>: luacrypto has only been built against and tested with OpenSSL versions 0.9.7 and above. It depends on additional API methods introduced in 0.9.7.</li>
</ul>

<h1><a name="installation">Installation</a></h1>
<p>Edit the Makefile and set the following fields to the correct values for your environment:</p>
<ul>
<li><dfn>LUAINC</dfn>: The location of your Lua 5.1 include headers. This is required to build the code.</li>
<li><dfn>LUAINC</dfn>: The location of your Lua include headers. This is required to build the code.</li>
<li><dfn>LUA_PATH</dfn>: The installation path for your system independent Lua files.</li>
<li><dfn>LUA_CPATH</dfn>: The installation path for your system dependent Lua files. This and LUA_PATH are required to install the libraries properly.</li>
<li><dfn>USE_COMPAT</dfn>: Set this if your target environment is Lua 5.0. If your target is Lua 5.1, leave this blank. (Note that the compat-5.1.lua module must be loaded before any wrapped modules will work. See <a href="http://www.keplerproject.org/compat" title="Compat-5.1 by the Kepler Project">the Compat 5.1 page</a> for details).</li>
<li><dfn>INSTALL_COMPAT</dfn>: If you have set USE_COMPAT, you should also set this value to install the compat-5.1.lua module during "make install". However, if you already have the module installed (and possibly customised), leave this unset to keep it from being clobbered during "make install".</li>
<li><dfn>LUA_TYPE</dfn>: Set this to the type of Lua libraries you would like to install; either "lc" for precompiled Lua libraries (using luac), or "lua" for regular text Lua libraries.</li>
<li><dfn>LUA</dfn>: The location of your Lua 5.1 interpreter; only needed to run the test suite.</li>
<li><dfn>LUAC</dfn>: The location of your Lua 5.1 compiler; only needed to build the precompiled Lua libraries (LUA_TYPE = lc).</li>
<li><dfn>LDFLAGS</dfn>: On most systems, the default value will be fine. However, if your OpenSSL libcrypto library is not in the standard library paths, you may need to point this at your OpenSSL install.</li>
<li><dfn>CFLAGS</dfn>: On most systems, the default value will be fine. However, if your OpenSSL libcrypto headers are not in the standard include paths, you may need to point this at your OpenSSL install.</li>
<li><dfn>LUA</dfn>: The location of your Lua interpreter; only needed to run the test suite.</li>
<li><dfn>LUAC</dfn>: The location of your Lua compiler; only needed to build the precompiled Lua libraries (LUA_TYPE = lc).</li>
<li><dfn>CRYPTOLIB</dfn>: On most systems, the default value will be fine. However, if your OpenSSL libcrypto library is not in the standard library paths, you may need to point this at your OpenSSL install.</li>
<li><dfn>CRYPTOINC</dfn>: On most systems, the default value will be fine. However, if your OpenSSL libcrypto headers are not in the standard include paths, you may need to point this at your OpenSSL install.</li>
</ul>
<p>Once configured, run <kbd>make</kbd> to build the libraries. Run <kbd>make install</kbd> to install the libraries in the correct location. The install will run a test suite if you have set the location of your Lua interpreter. You can run the tests independently with <kbd>make tests</kbd>, but you cannot run the tests until after you have run <kbd>make install</kbd>.</p>

<h1><a name="credits">Credits</a></h1>
<p>Much of this code was heavily inspired by and/or lifted directly from the <a href="http://luaforge.net/projects/lmd5/" title="lmd5 project page">lmd5 project</a>, written by Luiz Henrique de Figueiredo &lt;<a href="mailto:lhf@tecgraf.puc-rio.br">lhf@tecgraf.puc-rio.br</a>&gt;.</p>
<p>The <a href="http://www.keplerproject.org/compat" title="Compat 5.1 by the Kepler Project">Compat-5.1 library</a> written by the folks at the Kepler Project is also included for Lua 5.0 support.</p>

<h1>Usage</h1>
<p>See <a href="luacrypto.html">the documentation</a> for more info.</p>
Expand Down

0 comments on commit 8edcc8c

Please sign in to comment.