~ubuntu-branches/ubuntu/maverick/gnome-keyring/maverick-proposed

« back to all changes in this revision

Viewing changes to reference/html/gnome-keyring-gnome-keyring-acl.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2008-02-25 10:14:17 UTC
  • mto: (2.2.1 sid)
  • mto: This revision was merged to the branch mainline in revision 49.
  • Revision ID: james.westby@ubuntu.com-20080225101417-wh6qww55r4uiwz7z
Tags: upstream-2.21.92
ImportĀ upstreamĀ versionĀ 2.21.92

Show diffs side-by-side

added added

removed removed

Lines of Context:
21
21
<th width="100%" align="center">gnome-keyring Reference Manual</th>
22
22
<td><a accesskey="n" href="gnome-keyring-gnome-keyring-find.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23
23
</tr>
24
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2584012" class="shortcut">Top</a>
 
24
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2587409" class="shortcut">Top</a>
25
25
                  &#160;|&#160;
26
 
                  <a href="#id2600780" class="shortcut">Description</a></nobr></td></tr>
 
26
                  <a href="#id2609606" class="shortcut">Description</a></nobr></td></tr>
27
27
</table>
28
28
<div class="refentry" lang="en">
29
29
<a name="gnome-keyring-gnome-keyring-acl"></a><div class="titlepage"></div>
30
30
<div class="refnamediv"><table width="100%"><tr>
31
31
<td valign="top">
32
32
<h2>
33
 
<a name="id2584012"></a><span class="refentrytitle">gnome-keyring-acl</span>
 
33
<a name="id2587409"></a><span class="refentrytitle">gnome-keyring-acl</span>
34
34
</h2>
35
35
<p>gnome-keyring-acl &#8212; Keyring Item ACLs</p>
36
36
</td>
74
74
</pre>
75
75
</div>
76
76
<div class="refsect1" lang="en">
77
 
<a name="id2600780"></a><h2>Description</h2>
 
77
<a name="id2609606"></a><h2>Description</h2>
78
78
<p>Each item has an access control list, which specifies the applications that 
79
79
can read, write or delete an item. The read access applies only to reading the secret.
80
80
All applications can read other parts of the item. ACLs are accessed and changed
81
81
<a href="gnome-keyring-gnome-keyring-items.html#gnome-keyring-item-get-acl"><code class="function">gnome_keyring_item_get_acl()</code></a> and <a href="gnome-keyring-gnome-keyring-items.html#gnome-keyring-item-set-acl"><code class="function">gnome_keyring_item_set_acl()</code></a>.</p>
82
82
</div>
83
83
<div class="refsect1" lang="en">
84
 
<a name="id2600819"></a><h2>Details</h2>
 
84
<a name="id2609645"></a><h2>Details</h2>
85
85
<div class="refsect2" lang="en">
86
 
<a name="id2600830"></a><h3>
 
86
<a name="id2609656"></a><h3>
87
87
<a name="GnomeKeyringAccessControl"></a>GnomeKeyringAccessControl</h3>
88
 
<a class="indexterm" name="id2600841"></a><pre class="programlisting">typedef struct GnomeKeyringAccessControl GnomeKeyringAccessControl;
 
88
<a class="indexterm" name="id2609667"></a><pre class="programlisting">typedef struct GnomeKeyringAccessControl GnomeKeyringAccessControl;
89
89
</pre>
90
90
<p>
91
91
 
93
93
</div>
94
94
<hr>
95
95
<div class="refsect2" lang="en">
96
 
<a name="id2600857"></a><h3>
 
96
<a name="id2609683"></a><h3>
97
97
<a name="GnomeKeyringApplicationRef"></a>GnomeKeyringApplicationRef</h3>
98
 
<a class="indexterm" name="id2600868"></a><pre class="programlisting">typedef struct GnomeKeyringApplicationRef GnomeKeyringApplicationRef;
 
98
<a class="indexterm" name="id2609694"></a><pre class="programlisting">typedef struct GnomeKeyringApplicationRef GnomeKeyringApplicationRef;
99
99
</pre>
100
100
<p>
101
101
 
103
103
</div>
104
104
<hr>
105
105
<div class="refsect2" lang="en">
106
 
<a name="id2600885"></a><h3>
 
106
<a name="id2609711"></a><h3>
107
107
<a name="GnomeKeyringAccessType"></a>enum GnomeKeyringAccessType</h3>
108
 
<a class="indexterm" name="id2600896"></a><pre class="programlisting">typedef enum {
 
108
<a class="indexterm" name="id2609722"></a><pre class="programlisting">typedef enum {
109
109
        GNOME_KEYRING_ACCESS_READ = 1&lt;&lt;0,
110
110
        GNOME_KEYRING_ACCESS_WRITE = 1&lt;&lt;1,
111
111
        GNOME_KEYRING_ACCESS_REMOVE = 1&lt;&lt;2
117
117
</div>
118
118
<hr>
119
119
<div class="refsect2" lang="en">
120
 
<a name="id2600914"></a><h3>
 
120
<a name="id2609740"></a><h3>
121
121
<a name="gnome-keyring-application-ref-new"></a>gnome_keyring_application_ref_new ()</h3>
122
 
<a class="indexterm" name="id2609462"></a><pre class="programlisting"><a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringApplicationRef">GnomeKeyringApplicationRef</a>* gnome_keyring_application_ref_new
 
122
<a class="indexterm" name="id2609754"></a><pre class="programlisting"><a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringApplicationRef">GnomeKeyringApplicationRef</a>* gnome_keyring_application_ref_new
123
123
                                                        (void);</pre>
124
124
<p>
125
125
Create a new application reference.</p>
137
137
</div>
138
138
<hr>
139
139
<div class="refsect2" lang="en">
140
 
<a name="id2609509"></a><h3>
 
140
<a name="id2609801"></a><h3>
141
141
<a name="gnome-keyring-application-ref-copy"></a>gnome_keyring_application_ref_copy ()</h3>
142
 
<a class="indexterm" name="id2609523"></a><pre class="programlisting"><a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringApplicationRef">GnomeKeyringApplicationRef</a>* gnome_keyring_application_ref_copy
 
142
<a class="indexterm" name="id2609815"></a><pre class="programlisting"><a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringApplicationRef">GnomeKeyringApplicationRef</a>* gnome_keyring_application_ref_copy
143
143
                                                        (const <a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringApplicationRef">GnomeKeyringApplicationRef</a> *app);</pre>
144
144
<p>
145
145
Copy an application reference.</p>
164
164
</div>
165
165
<hr>
166
166
<div class="refsect2" lang="en">
167
 
<a name="id2609596"></a><h3>
 
167
<a name="id2609888"></a><h3>
168
168
<a name="gnome-keyring-application-ref-free"></a>gnome_keyring_application_ref_free ()</h3>
169
 
<a class="indexterm" name="id2609610"></a><pre class="programlisting">void                gnome_keyring_application_ref_free  (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringApplicationRef">GnomeKeyringApplicationRef</a> *app);</pre>
 
169
<a class="indexterm" name="id2609902"></a><pre class="programlisting">void                gnome_keyring_application_ref_free  (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringApplicationRef">GnomeKeyringApplicationRef</a> *app);</pre>
170
170
<p>
171
171
Free an application reference.</p>
172
172
<p>
183
183
</div>
184
184
<hr>
185
185
<div class="refsect2" lang="en">
186
 
<a name="id2609666"></a><h3>
 
186
<a name="id2609958"></a><h3>
187
187
<a name="gnome-keyring-access-control-new"></a>gnome_keyring_access_control_new ()</h3>
188
 
<a class="indexterm" name="id2609679"></a><pre class="programlisting"><a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a>* gnome_keyring_access_control_new
 
188
<a class="indexterm" name="id2609971"></a><pre class="programlisting"><a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a>* gnome_keyring_access_control_new
189
189
                                                        (const <a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringApplicationRef">GnomeKeyringApplicationRef</a> *application,
190
190
                                                         <a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessType">GnomeKeyringAccessType</a> types_allowed);</pre>
191
191
<p>
218
218
</div>
219
219
<hr>
220
220
<div class="refsect2" lang="en">
221
 
<a name="id2609785"></a><h3>
 
221
<a name="id2610077"></a><h3>
222
222
<a name="gnome-keyring-access-control-copy"></a>gnome_keyring_access_control_copy ()</h3>
223
 
<a class="indexterm" name="id2609799"></a><pre class="programlisting"><a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a>* gnome_keyring_access_control_copy
 
223
<a class="indexterm" name="id2610091"></a><pre class="programlisting"><a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a>* gnome_keyring_access_control_copy
224
224
                                                        (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac);</pre>
225
225
<p>
226
226
Copy an access control for an item.</p>
246
246
</div>
247
247
<hr>
248
248
<div class="refsect2" lang="en">
249
 
<a name="id2609882"></a><h3>
 
249
<a name="id2608589"></a><h3>
250
250
<a name="gnome-keyring-access-control-free"></a>gnome_keyring_access_control_free ()</h3>
251
 
<a class="indexterm" name="id2564837"></a><pre class="programlisting">void                gnome_keyring_access_control_free   (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac);</pre>
 
251
<a class="indexterm" name="id2608602"></a><pre class="programlisting">void                gnome_keyring_access_control_free   (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac);</pre>
252
252
<p>
253
253
Free an access control for an item.</p>
254
254
<p>
265
265
</div>
266
266
<hr>
267
267
<div class="refsect2" lang="en">
268
 
<a name="id2564893"></a><h3>
 
268
<a name="id2608658"></a><h3>
269
269
<a name="gnome-keyring-acl-copy"></a>gnome_keyring_acl_copy ()</h3>
270
 
<a class="indexterm" name="id2564904"></a><pre class="programlisting">GList*              gnome_keyring_acl_copy              (GList *list);</pre>
 
270
<a class="indexterm" name="id2608670"></a><pre class="programlisting">GList*              gnome_keyring_acl_copy              (GList *list);</pre>
271
271
<p>
272
272
Copy an access control list.</p>
273
273
<p>
292
292
</div>
293
293
<hr>
294
294
<div class="refsect2" lang="en">
295
 
<a name="id2564987"></a><h3>
 
295
<a name="id2608752"></a><h3>
296
296
<a name="gnome-keyring-acl-free"></a>gnome_keyring_acl_free ()</h3>
297
 
<a class="indexterm" name="id2564998"></a><pre class="programlisting">void                gnome_keyring_acl_free              (GList *acl);</pre>
 
297
<a class="indexterm" name="id2608763"></a><pre class="programlisting">void                gnome_keyring_acl_free              (GList *acl);</pre>
298
298
<p>
299
299
Free an access control list.</p>
300
300
<p>
311
311
</div>
312
312
<hr>
313
313
<div class="refsect2" lang="en">
314
 
<a name="id2565054"></a><h3>
 
314
<a name="id2608820"></a><h3>
315
315
<a name="gnome-keyring-item-ac-get-display-name"></a>gnome_keyring_item_ac_get_display_name ()</h3>
316
 
<a class="indexterm" name="id2565068"></a><pre class="programlisting">char*               gnome_keyring_item_ac_get_display_name
 
316
<a class="indexterm" name="id2608833"></a><pre class="programlisting">char*               gnome_keyring_item_ac_get_display_name
317
317
                                                        (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac);</pre>
318
318
<p>
319
319
Get the access control application's display name.</p>
338
338
</div>
339
339
<hr>
340
340
<div class="refsect2" lang="en">
341
 
<a name="id2565137"></a><h3>
 
341
<a name="id2608902"></a><h3>
342
342
<a name="gnome-keyring-item-ac-set-display-name"></a>gnome_keyring_item_ac_set_display_name ()</h3>
343
 
<a class="indexterm" name="id2565151"></a><pre class="programlisting">void                gnome_keyring_item_ac_set_display_name
 
343
<a class="indexterm" name="id2608916"></a><pre class="programlisting">void                gnome_keyring_item_ac_set_display_name
344
344
                                                        (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac,
345
345
                                                         const char *value);</pre>
346
346
<p>
366
366
</div>
367
367
<hr>
368
368
<div class="refsect2" lang="en">
369
 
<a name="id2565231"></a><h3>
 
369
<a name="id2608996"></a><h3>
370
370
<a name="gnome-keyring-item-ac-get-path-name"></a>gnome_keyring_item_ac_get_path_name ()</h3>
371
 
<a class="indexterm" name="id2565245"></a><pre class="programlisting">char*               gnome_keyring_item_ac_get_path_name (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac);</pre>
 
371
<a class="indexterm" name="id2609010"></a><pre class="programlisting">char*               gnome_keyring_item_ac_get_path_name (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac);</pre>
372
372
<p>
373
373
Get the access control application's full path name.</p>
374
374
<p>
392
392
</div>
393
393
<hr>
394
394
<div class="refsect2" lang="en">
395
 
<a name="id2565312"></a><h3>
 
395
<a name="id2609077"></a><h3>
396
396
<a name="gnome-keyring-item-ac-set-path-name"></a>gnome_keyring_item_ac_set_path_name ()</h3>
397
 
<a class="indexterm" name="id2565326"></a><pre class="programlisting">void                gnome_keyring_item_ac_set_path_name (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac,
 
397
<a class="indexterm" name="id2609091"></a><pre class="programlisting">void                gnome_keyring_item_ac_set_path_name (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac,
398
398
                                                         const char *value);</pre>
399
399
<p>
400
400
Set the access control application's full path name.</p>
419
419
</div>
420
420
<hr>
421
421
<div class="refsect2" lang="en">
422
 
<a name="id2565404"></a><h3>
 
422
<a name="id2609169"></a><h3>
423
423
<a name="gnome-keyring-item-ac-get-access-type"></a>gnome_keyring_item_ac_get_access_type ()</h3>
424
 
<a class="indexterm" name="id2565418"></a><pre class="programlisting"><a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessType">GnomeKeyringAccessType</a> gnome_keyring_item_ac_get_access_type
 
424
<a class="indexterm" name="id2609183"></a><pre class="programlisting"><a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessType">GnomeKeyringAccessType</a> gnome_keyring_item_ac_get_access_type
425
425
                                                        (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac);</pre>
426
426
<p>
427
427
Get the application access rights for the access control.</p>
446
446
</div>
447
447
<hr>
448
448
<div class="refsect2" lang="en">
449
 
<a name="id2615657"></a><h3>
 
449
<a name="id2615693"></a><h3>
450
450
<a name="gnome-keyring-item-ac-set-access-type"></a>gnome_keyring_item_ac_set_access_type ()</h3>
451
 
<a class="indexterm" name="id2615670"></a><pre class="programlisting">void                gnome_keyring_item_ac_set_access_type
 
451
<a class="indexterm" name="id2615706"></a><pre class="programlisting">void                gnome_keyring_item_ac_set_access_type
452
452
                                                        (<a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessControl">GnomeKeyringAccessControl</a> *ac,
453
453
                                                         const <a href="gnome-keyring-gnome-keyring-acl.html#GnomeKeyringAccessType">GnomeKeyringAccessType</a> value);</pre>
454
454
<p>