aboutsummaryrefslogtreecommitdiffstats
path: root/doc/luaossl.tex
diff options
context:
space:
mode:
authorLibravatarLibravatar daurnimator <quae@daurnimator.com> 2022-07-03 22:54:31 +1000
committerLibravatarLibravatar daurnimator <quae@daurnimator.com> 2022-07-03 22:56:07 +1000
commitbed73b66dee1dde0bfa5a658cf109457c3f70b46 (patch)
tree932f7b82052832b459f607323a92dad8929014dc /doc/luaossl.tex
parentb9212f4029be6d51d12ac0414b06eb9fe450a0e3 (diff)
parent2922f436c562cf4dc716fc24816784b71da27403 (diff)
downloadluaossl-bed73b66dee1dde0bfa5a658cf109457c3f70b46.tar.gz
luaossl-bed73b66dee1dde0bfa5a658cf109457c3f70b46.tar.bz2
luaossl-bed73b66dee1dde0bfa5a658cf109457c3f70b46.zip
Merge remote-tracking branch 'origin/refs/pull/201/head'
Diffstat (limited to 'doc/luaossl.tex')
-rw-r--r--doc/luaossl.tex8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/luaossl.tex b/doc/luaossl.tex
index efc6422..df5626a 100644
--- a/doc/luaossl.tex
+++ b/doc/luaossl.tex
@@ -1485,6 +1485,14 @@ Update the cipher instance with the specified string(s). Returns a string on suc
Update the cipher with the specified string(s). Returns the final output string on success, or nil and an error message on failure. The returned string may be empty if all blocks have already been flushed in prior \fn{:update} calls.
+\subsubsection[\fn{cipher:getTag}]{\fn{cipher:getTag($len$)}}
+
+Returns the authentication tag for the ciphertext (GCM ciphers only) as a binary string. This method can only be called when encrypting data, and must be called after all data has been processed (i.e. after calling \fn{:final()}).
+
+\subsubsection[\fn{cipher:setTag}]{\fn{cipher:setTag($tag$)}}
+
+Sets the provided binary string as the expected authentication tag for the forthcoming ciphertext (GCM ciphers only). This method can only be called when decrypting data, and must be called before \fn{:final()} to ensure the ciphertext integrity can be verified successfully.
+
\end{Module}