/usr/share/gtk-doc/html/libsecret-1/migrating-searching.html is in libsecret-1-dev 0.18.4-1ubuntu2.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Searching for passwords and items: Libsecret Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="index.html" title="Libsecret Library Reference Manual">
<link rel="up" href="migrating-api.html" title="API conversion">
<link rel="prev" href="migrating-storing.html" title="Storing passwords and items">
<link rel="next" href="migrating-removing.html" title="Removing passwords and icons">
<meta name="generator" content="GTK-Doc V1.24 (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"></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="migrating-api.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="migrating-storing.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="migrating-removing.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="migrating-searching"></a>Searching for passwords and items</h2></div></div></div>
<p>In general libsecret tries not to unlocking keyrings
where not necessary. Many search methods only return one item or
password that matches, preferring already unlocked items, and recently stored
items.</p>
<p>Attributes are meant to be used for lookup of items; they're not
designed to be used as a generic key/value database. Although you can
force libsecret to do the latter, it's better to store your account
information elsewhere if possible, and use libsecret to store the password
or other secret. Because of this many search methods return just the
password or secret.</p>
<p>Replacements for related libgnome-keyring functions and types
are described below:
</p>
<div class="table">
<a name="id-1.6.3.6.4.1"></a><p class="title"><b>Table 4. </b></p>
<div class="table-contents"><table border="1">
<colgroup>
<col>
<col>
</colgroup>
<thead><tr>
<th>libgnome-keyring</th>
<th>libsecret</th>
</tr></thead>
<tbody>
<tr>
<td><code class="function">gnome_keyring_find_password()</code></td>
<td><a class="link" href="libsecret-Password-storage.html#secret-password-lookup" title="secret_password_lookup ()"><code class="function">secret_password_lookup()</code></a></td>
</tr>
<tr>
<td><code class="function">gnome_keyring_find_password_sync()</code></td>
<td><a class="link" href="libsecret-Password-storage.html#secret-password-lookup-sync" title="secret_password_lookup_sync ()"><code class="function">secret_password_lookup_sync()</code></a></td>
</tr>
<tr>
<td><code class="function">gnome_keyring_find_items()</code></td>
<td>
<a class="link" href="SecretService.html#secret-service-search" title="secret_service_search ()"><code class="function">secret_service_search()</code></a>, with flags to fine tune behavior</td>
</tr>
<tr>
<td><code class="function">gnome_keyring_find_itemsv()</code></td>
<td>
<a class="link" href="SecretService.html#secret-service-search" title="secret_service_search ()"><code class="function">secret_service_search()</code></a>, with flags to fine tune behavior</td>
</tr>
<tr>
<td><code class="function">gnome_keyring_find_items_sync()</code></td>
<td>
<a class="link" href="SecretService.html#secret-service-search-sync" title="secret_service_search_sync ()"><code class="function">secret_service_search_sync()</code></a>, with flags to fine tune behavior</td>
</tr>
<tr>
<td><code class="function">gnome_keyring_find_itemsv_sync()</code></td>
<td>
<a class="link" href="SecretService.html#secret-service-search" title="secret_service_search ()"><code class="function">secret_service_search()</code></a>, with flags to fine tune behavior</td>
</tr>
<tr>
<td>GnomeKeyringFound</td>
<td>no equivalent, <a class="link" href="SecretService.html#secret-service-search" title="secret_service_search ()"><code class="function">secret_service_search()</code></a> returns a <a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of
<a class="link" href="SecretItem.html" title="SecretItem"><span class="type">SecretItem</span></a>s, and other methods return passwords directly.</td>
</tr>
<tr>
<td><code class="function">gnome_keyring_found_copy()</code></td>
<td>no equivalent</td>
</tr>
<tr>
<td><code class="function">gnome_keyring_found_free()</code></td>
<td>
<a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on the each of the items returned from
<a class="link" href="SecretService.html#secret-service-search" title="secret_service_search ()"><code class="function">secret_service_search()</code></a>
</td>
</tr>
<tr>
<td><code class="function">gnome_keyring_found_list_free()</code></td>
<td>
<a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free-full"><code class="function">g_list_free_full()</code></a> used with <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on the items returned from
<a class="link" href="SecretService.html#secret-service-search" title="secret_service_search ()"><code class="function">secret_service_search()</code></a>
</td>
</tr>
<tr>
<td><code class="function">gnome_keyring_find_network_password()</code></td>
<td>
<a class="link" href="libsecret-Password-storage.html#secret-password-lookup" title="secret_password_lookup ()"><code class="function">secret_password_lookup()</code></a> with <a class="link" href="libsecret-SecretSchema.html#SECRET-SCHEMA-COMPAT-NETWORK:CAPS" title="SECRET_SCHEMA_COMPAT_NETWORK"><code class="literal">SECRET_SCHEMA_COMPAT_NETWORK</code></a>,
although this only returns one password and no attributes</td>
</tr>
<tr>
<td><code class="function">gnome_keyring_find_network_password_sync()</code></td>
<td>
<a class="link" href="libsecret-Password-storage.html#secret-password-lookup-sync" title="secret_password_lookup_sync ()"><code class="function">secret_password_lookup_sync()</code></a> with <a class="link" href="libsecret-SecretSchema.html#SECRET-SCHEMA-COMPAT-NETWORK:CAPS" title="SECRET_SCHEMA_COMPAT_NETWORK"><code class="literal">SECRET_SCHEMA_COMPAT_NETWORK</code></a>,
although this only returns one password and no attributes</td>
</tr>
<tr>
<td><span class="type">GnomeKeyringNetworkPasswordData</span></td>
<td>no equivalent, <a class="link" href="libsecret-Password-storage.html#secret-password-lookup" title="secret_password_lookup ()"><code class="function">secret_password_lookup()</code></a> gets the password directly
and no attributes</td>
</tr>
<tr>
<td><code class="function">gnome_keyring_network_password_free()</code></td>
<td>no equivalent</td>
</tr>
<tr>
<td><code class="function">gnome_keyring_network_password_list_free()</code></td>
<td>no equivalent</td>
</tr>
</tbody>
</table></div>
</div>
<p><br class="table-break"></p>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.24</div>
</body>
</html>
|