diff options
| author | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
| commit | 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 (patch) | |
| tree | f1190704f78f04a2b0b4c977d20fe96a828377f1 /devdocs/elisp/format-of-gnutls-cryptography-inputs.html | |
new repository
Diffstat (limited to 'devdocs/elisp/format-of-gnutls-cryptography-inputs.html')
| -rw-r--r-- | devdocs/elisp/format-of-gnutls-cryptography-inputs.html | 10 |
1 files changed, 10 insertions, 0 deletions
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 @@ + <h4 class="subsection">Format of GnuTLS Cryptography Inputs</h4> <p>The inputs to GnuTLS cryptographic functions can be specified in several ways, both as primitive Emacs Lisp types or as lists. </p> <p>The list form is currently similar to how <code>md5</code> and <code>secure-hash</code> operate. </p> <dl compact> <dt><code><var>buffer</var></code></dt> <dd> +<p>Simply passing a buffer as input means the whole buffer should be used. </p> </dd> <dt><code><var>string</var></code></dt> <dd> +<p>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. </p> </dd> <dt><code>(<var>buffer-or-string</var> <var>start</var> <var>end</var> <var>coding-system</var> <var>noerror</var>)</code></dt> <dd> +<p>This specifies a buffer or a string as described above, but an optional range can be specified with <var>start</var> and <var>end</var>. </p> <p>In addition an optional <var>coding-system</var> can be specified if needed. </p> <p>The last optional item, <var>noerror</var>, overrides the normal error when the text can’t be encoded using the specified or chosen coding system. When <var>noerror</var> is non-<code>nil</code>, this function silently uses <code>raw-text</code> coding instead. </p> </dd> <dt><code>(<code>iv-auto</code> <var>length</var>)</code></dt> <dd> +<p>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. </p> </dd> </dl><div class="_attribution"> + <p class="_attribution-p"> + Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br> + <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Format-of-GnuTLS-Cryptography-Inputs.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Format-of-GnuTLS-Cryptography-Inputs.html</a> + </p> +</div> |