/usr/share/doc/libgcrypt20-doc/html/Error-handler.html is in libgcrypt20-doc 1.7.6-2+deb9u3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for Libgcrypt
(version 1.7.6-beta, 18 January 2017),
which is GNU's library of cryptographic building blocks.
Copyright (C) 2000, 2002, 2003, 2004, 2006, 2007, 2008, 2009, 2011, 2012 Free Software Foundation, Inc.
Copyright (C) 2012, 2013, 2016 g10 Code GmbH
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version. The text of the license can be found in the
section entitled "GNU General Public License". -->
<!-- Created by GNU Texinfo 6.3, http://www.gnu.org/software/texinfo/ -->
<head>
<title>The Libgcrypt Reference Manual: Error handler</title>
<meta name="description" content="The Libgcrypt Reference Manual: Error handler">
<meta name="keywords" content="The Libgcrypt Reference Manual: Error handler">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Handler-Functions.html#Handler-Functions" rel="up" title="Handler Functions">
<link href="Logging-handler.html#Logging-handler" rel="next" title="Logging handler">
<link href="Allocation-handler.html#Allocation-handler" rel="prev" title="Allocation handler">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="Error-handler"></a>
<div class="header">
<p>
Next: <a href="Logging-handler.html#Logging-handler" accesskey="n" rel="next">Logging handler</a>, Previous: <a href="Allocation-handler.html#Allocation-handler" accesskey="p" rel="prev">Allocation handler</a>, Up: <a href="Handler-Functions.html#Handler-Functions" accesskey="u" rel="up">Handler Functions</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Error-handler-1"></a>
<h3 class="section">4.3 Error handler</h3>
<p>The following functions may be used to register handler functions that
are called by Libgcrypt in case certain error conditions occur. They
may and should be registered prior to calling <code>gcry_check_version</code>.
</p>
<dl>
<dt><a name="index-gcry_005fhandler_005fno_005fmem_005ft"></a>Data type: <strong>gcry_handler_no_mem_t</strong></dt>
<dd><p>This type is defined as: <code>int (*gcry_handler_no_mem_t) (void *, size_t, unsigned int)</code>
</p></dd></dl>
<dl>
<dt><a name="index-gcry_005fset_005foutofcore_005fhandler"></a>Function: <em>void</em> <strong>gcry_set_outofcore_handler</strong> <em>(gcry_handler_no_mem_t <var>func_no_mem</var>, void *<var>cb_data</var>)</em></dt>
<dd><p>This function registers <var>func_no_mem</var> as ‘out-of-core handler’,
which means that it will be called in the case of not having enough
memory available. The handler is called with 3 arguments: The first
one is the pointer <var>cb_data</var> as set with this function, the second
is the requested memory size and the last being a flag. If bit 0 of
the flag is set, secure memory has been requested. The handler should
either return true to indicate that Libgcrypt should try again
allocating memory or return false to let Libgcrypt use its default
fatal error handler.
</p></dd></dl>
<dl>
<dt><a name="index-gcry_005fhandler_005ferror_005ft"></a>Data type: <strong>gcry_handler_error_t</strong></dt>
<dd><p>This type is defined as: <code>void (*gcry_handler_error_t) (void *, int, const char *)</code>
</p></dd></dl>
<dl>
<dt><a name="index-gcry_005fset_005ffatalerror_005fhandler"></a>Function: <em>void</em> <strong>gcry_set_fatalerror_handler</strong> <em>(gcry_handler_error_t <var>func_error</var>, void *<var>cb_data</var>)</em></dt>
<dd><p>This function registers <var>func_error</var> as ‘error handler’,
which means that it will be called in error conditions.
</p></dd></dl>
</body>
</html>
|