This file is indexed.

/usr/share/gtk-doc/html/gcr-3/GcrSecureEntryBuffer.html is in libgcr-3-doc 3.20.0-5.1.

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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GcrSecureEntryBuffer: Gcr Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="Gcr Library Reference Manual">
<link rel="up" href="misc.html" title="Part VI. Miscellaneous">
<link rel="prev" href="gcr-Non-pageable-Memory.html" title="Non-pageable Memory">
<link rel="next" href="annotation-glossary.html" title="Annotation Glossary">
<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GcrSecureEntryBuffer.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GcrSecureEntryBuffer.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="misc.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="gcr-Non-pageable-Memory.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="annotation-glossary.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GcrSecureEntryBuffer"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GcrSecureEntryBuffer.top_of_page"></a>GcrSecureEntryBuffer</span></h2>
<p>GcrSecureEntryBuffer — a GtkEntryBuffer that uses non-pageable memory</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GcrSecureEntryBuffer.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody><tr>
<td class="function_type">
<span class="returnvalue">GtkEntryBuffer</span> *
</td>
<td class="function_name">
<a class="link" href="GcrSecureEntryBuffer.html#gcr-secure-entry-buffer-new" title="gcr_secure_entry_buffer_new ()">gcr_secure_entry_buffer_new</a> <span class="c_punctuation">()</span>
</td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GcrSecureEntryBuffer.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GcrSecureEntryBuffer.html#GcrSecureEntryBuffer-struct" title="struct GcrSecureEntryBuffer">GcrSecureEntryBuffer</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GcrSecureEntryBuffer.html#GcrSecureEntryBufferClass" title="struct GcrSecureEntryBufferClass">GcrSecureEntryBufferClass</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GcrSecureEntryBuffer.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
    <span class="lineart">╰──</span> GtkEntryBuffer
        <span class="lineart">╰──</span> GcrSecureEntryBuffer
</pre>
</div>
<div class="refsect1">
<a name="GcrSecureEntryBuffer.description"></a><h2>Description</h2>
<p>It's good practice to try to keep passwords or sensitive secrets out of
pageable memory whenever possible, so that they don't get written to disk.</p>
<p>This is a <span class="type">GtkEntryBuffer</span> to be used with <span class="type">GtkEntry</span> which uses non-pageable
memory to store a password placed in the entry. In order to make any sense
at all, the entry must have it's visibility turned off, and just be displaying
place holder characters for the text. That is, a password style entry.</p>
<p>Use <code class="function">gtk_entry_new_with_buffer()</code> or <code class="function">gtk_entry_set_buffer()</code> to set this buffer
on an entry.</p>
</div>
<div class="refsect1">
<a name="GcrSecureEntryBuffer.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gcr-secure-entry-buffer-new"></a><h3>gcr_secure_entry_buffer_new ()</h3>
<pre class="programlisting"><span class="returnvalue">GtkEntryBuffer</span> *
gcr_secure_entry_buffer_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Create a new <a class="link" href="GcrSecureEntryBuffer.html" title="GcrSecureEntryBuffer"><span class="type">GcrSecureEntryBuffer</span></a>, a <span class="type">GtkEntryBuffer</span> which uses
non-pageable memory for the text.</p>
<div class="refsect3">
<a name="gcr-secure-entry-buffer-new.returns"></a><h4>Returns</h4>
<p> the new entry buffer. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
</div>
<div class="refsect1">
<a name="GcrSecureEntryBuffer.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GcrSecureEntryBuffer-struct"></a><h3>struct GcrSecureEntryBuffer</h3>
<pre class="programlisting">struct GcrSecureEntryBuffer;</pre>
<p>A <span class="type">GtkEntryBuffer</span> which uses non-pageable memory for passwords or secrets.</p>
</div>
<hr>
<div class="refsect2">
<a name="GcrSecureEntryBufferClass"></a><h3>struct GcrSecureEntryBufferClass</h3>
<pre class="programlisting">struct GcrSecureEntryBufferClass {
	GtkEntryBufferClass parent_class;
};
</pre>
<p>The class for <a class="link" href="GcrSecureEntryBuffer.html" title="GcrSecureEntryBuffer"><span class="type">GcrSecureEntryBuffer</span></a>.</p>
<div class="refsect3">
<a name="GcrSecureEntryBufferClass.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody></tbody>
</table></div>
</div>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25</div>
</body>
</html>