From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/elisp/format-of-gnutls-cryptography-inputs.html | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 devdocs/elisp/format-of-gnutls-cryptography-inputs.html (limited to 'devdocs/elisp/format-of-gnutls-cryptography-inputs.html') diff --git a/devdocs/elisp/format-of-gnutls-cryptography-inputs.html b/devdocs/elisp/format-of-gnutls-cryptography-inputs.html new file mode 100644 index 00000000..263d56fd --- /dev/null +++ b/devdocs/elisp/format-of-gnutls-cryptography-inputs.html @@ -0,0 +1,10 @@ +

Format of GnuTLS Cryptography Inputs

The inputs to GnuTLS cryptographic functions can be specified in several ways, both as primitive Emacs Lisp types or as lists.

The list form is currently similar to how md5 and secure-hash operate.

buffer
+

Simply passing a buffer as input means the whole buffer should be used.

string
+

A string as input will be used directly. It may be modified by the function (unlike most other Emacs Lisp functions) to reduce the chance of exposing sensitive data after the function does its work.

(buffer-or-string start end coding-system noerror)
+

This specifies a buffer or a string as described above, but an optional range can be specified with start and end.

In addition an optional coding-system can be specified if needed.

The last optional item, noerror, overrides the normal error when the text can’t be encoded using the specified or chosen coding system. When noerror is non-nil, this function silently uses raw-text coding instead.

(iv-auto length)
+

This generates a random IV (Initialization Vector) of the specified length and passes it to the function. This ensures that the IV is unpredictable and unlikely to be reused in the same session.

+

+ Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc.
Licensed under the GNU GPL license.
+ https://www.gnu.org/software/emacs/manual/html_node/elisp/Format-of-GnuTLS-Cryptography-Inputs.html +

+
-- cgit v1.2.3