/usr/share/doc/libgcrypt20-doc/html/Configuration.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 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 | <!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: Configuration</title>
<meta name="description" content="The Libgcrypt Reference Manual: Configuration">
<meta name="keywords" content="The Libgcrypt Reference Manual: Configuration">
<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="index.html#Top" rel="up" title="Top">
<link href="Architecture.html#Architecture" rel="next" title="Architecture">
<link href="hmac256.html#hmac256" rel="prev" title="hmac256">
<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="Configuration"></a>
<div class="header">
<p>
Next: <a href="Architecture.html#Architecture" accesskey="n" rel="next">Architecture</a>, Previous: <a href="Tools.html#Tools" accesskey="p" rel="prev">Tools</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</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="Configuration-files-and-evironment-variables"></a>
<h2 class="chapter">16 Configuration files and evironment variables</h2>
<p>This chapter describes which files and environment variables can be
used to change the behaviour of Libgcrypt.
</p>
<p>The environment variables considered by Libgcrypt are:
</p>
<dl compact="compact">
<dt><code>GCRYPT_BARRETT</code></dt>
<dd><a name="index-GCRYPT_005fBARRETT"></a>
<p>By setting this variable to any value a different algorithm for
modular reduction is used for ECC.
</p>
</dd>
<dt><code>GCRYPT_RNDUNIX_DBG</code></dt>
<dt><code>GCRYPT_RNDUNIX_DBGALL</code></dt>
<dd><a name="index-GCRYPT_005fRNDUNIX_005fDBG"></a>
<a name="index-GCRYPT_005fRNDUNIX_005fDBGALL"></a>
<p>These two environment variables are used to enable debug output for
the rndunix entropy gatherer, which is used on systems lacking a
/dev/random device. The value of <code>GCRYPT_RNDUNIX_DBG</code> is a file
name or <code>-</code> for stdout. Debug output is the written to this
file. By setting <code>GCRYPT_RNDUNIX_DBGALL</code> to any value the debug
output will be more verbose.
</p>
</dd>
<dt><code>GCRYPT_RNDW32_NOPERF</code></dt>
<dd><a name="index-GCRYPT_005fRNDW32_005fNOPERF"></a>
<p>Setting this environment variable on Windows to any value disables
the use of performance data (<code>HKEY_PERFORMANCE_DATA</code>) as source
for entropy. On some older Windows systems this could help to speed
up the creation of random numbers but also decreases the amount of
data used to init the random number generator.
</p>
</dd>
<dt><code>HOME</code></dt>
<dd><a name="index-HOME"></a>
<p>This is used to locate the socket to connect to the EGD random
daemon. The EGD can be used on system without a /dev/random to speed
up the random number generator. It is not needed on the majority of
today’s operating systems and support for EGD requires the use of a
configure option at build time.
</p>
</dd>
</dl>
<p>The files which Libgcrypt uses to retrieve system information and the
files which can be created by the user to modify Libgcrypt’s behavior
are:
</p>
<dl compact="compact">
<dt><samp>/etc/gcrypt/hwf.deny</samp></dt>
<dd><a name="index-_002fetc_002fgcrypt_002fhwf_002edeny"></a>
<p>This file can be used to disable the use of hardware based
optimizations, see <a href="Hardware-features.html#hardware-features">hardware features</a>.
</p>
</dd>
<dt><samp>/etc/gcrypt/fips_enabled</samp></dt>
<dt><samp>/proc/sys/crypto/fips_enabled</samp></dt>
<dd><a name="index-_002fetc_002fgcrypt_002ffips_005fenabled"></a>
<a name="index-fips_005fenabled"></a>
<p>On Linux these files are used to enable FIPS mode, see <a href="Enabling-FIPS-mode.html#enabling-fips-mode">enabling fips mode</a>.
</p>
</dd>
<dt><samp>/proc/cpuinfo</samp></dt>
<dt><samp>/proc/self/auxv</samp></dt>
<dd><a name="index-_002fproc_002fcpuinfo"></a>
<a name="index-_002fproc_002fself_002fauxv"></a>
<p>On Linux running on the ARM architecture, these files are used to read
hardware capabilities of the CPU.
</p>
</dd>
</dl>
<hr>
<div class="header">
<p>
Next: <a href="Architecture.html#Architecture" accesskey="n" rel="next">Architecture</a>, Previous: <a href="Tools.html#Tools" accesskey="p" rel="prev">Tools</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</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>
</body>
</html>
|