aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorLibravatarLibravatar william <william+macosx@25thandclement.com> 2015-06-04 16:00:48 -0700
committerLibravatarLibravatar william <william+macosx@25thandclement.com> 2015-06-04 16:00:48 -0700
commit53bcdd14c76157bac713414ca3df745c08b87916 (patch)
tree47ae4545cbeabd7d77d31a433b1e9336b53d0642 /doc
parentc7edf769c899cab01d35dc97256a049f11d508ec (diff)
downloadluaossl-53bcdd14c76157bac713414ca3df745c08b87916.tar.gz
luaossl-53bcdd14c76157bac713414ca3df745c08b87916.tar.bz2
luaossl-53bcdd14c76157bac713414ca3df745c08b87916.zip
document openssl module constants and openssl.version, which resolves issue #20
Diffstat (limited to 'doc')
-rw-r--r--doc/luaossl.pdfbin286521 -> 287875 bytes
-rw-r--r--doc/luaossl.tex32
2 files changed, 32 insertions, 0 deletions
diff --git a/doc/luaossl.pdf b/doc/luaossl.pdf
index a253cff..a9d03ad 100644
--- a/doc/luaossl.pdf
+++ b/doc/luaossl.pdf
Binary files differ
diff --git a/doc/luaossl.tex b/doc/luaossl.tex
index 96a966c..80e7a78 100644
--- a/doc/luaossl.tex
+++ b/doc/luaossl.tex
@@ -217,6 +217,38 @@ Install Lua 5.3 module.
\section{Modules}
+\begin{Module}{openssl}
+
+Binds various global interfaces, including version and build information.
+
+\subsubsection[\fn{openssl[]}]{\fn{openssl[]}}
+
+Table of various compile-time constant values. See also \fn{openssl.version}.
+
+\begin{ctabular}{ c | p{12cm} }
+name & description \\\hline
+\small{\texttt{SSLEAY\_VERSION\_NUMBER}} & OpenSSL version as an integer. \\
+\small{\texttt{LIBRESSL\_VERSION\_NUMBER}} & LibreSSL version as an integer. \\
+\small{\texttt{NO\_[feature]}} & If defined, signals that this installation of OpenSSL was compiled without [feature]. \\
+\end{ctabular}
+
+
+\subsubsection[\fn{openssl.version}]{\fn{openssl.version($info$)}}
+
+Returns information about the run-time version of OpenSSL, as opposed to the compile-time version used to build the Lua module. If $info$ is not specified, returns the version number as an integer. Otherwise, $info$ may be one of the following constants.
+
+\begin{ctabular}{ c | p{12cm} }
+name & description \\\hline
+\small{\texttt{SSLEAY\_VERSION}} & OpenSSL version description as a string. \\
+\small{\texttt{SSLEAY\_CFLAGS}} & Description of compiler flags used to build OpenSSL as a string. \\
+\small{\texttt{SSLEAY\_BUILT\_ON}} & Compilation date description as a string. \\
+\small{\texttt{SSLEAY\_PLATFORM}} & Platform description as a string. \\
+\small{\texttt{SSLEAY\_DIR}} & OpenSSL installation directory description as a string. \\
+\end{ctabular}
+
+\end{Module}
+
+
\begin{Module}{openssl.bignum}
\module{openssl.bignum} binds OpenSSL's libcrypto bignum library. It supports all the standard arithmetic operations. Regular number operands in a mixed arithmetic expression are upgraded as-if \method{bignum.new} was used explicitly. The \fn{\_\_tostring} metamethod generates a decimal encoded represention.