~ubuntu-branches/ubuntu/trusty/gcr/trusty-proposed
» Revision
1
: docs/reference/gck/html/GckAttributes.html
« back to all changes in this revision
Viewing changes to docs/reference/gck/html/GckAttributes.html
- browse files at revision 1
- compare with another revision
- download diff
- download tarball
- view history from revision 1
- Committer: Package Import Robot
- Author(s): Jordi Mallach
- Date: 2012-05-03 10:18:39 UTC
- Revision ID: package-import@ubuntu.com-20120503101839-wuvloldm7gmdsnij
Tags: upstream-3.4.1
Import upstream version 3.4.1
- files added:
- build
- build/m4
- build/valgrind
- docs
- docs/reference
- docs/reference/gck
- docs/reference/gck/html
- docs/reference/gck/tmpl
- docs/reference/gcr
- docs/reference/gcr/html
- docs/reference/gcr/images
- docs/reference/gcr/tmpl
- egg
- egg/tests
- egg/tests/files
- gck
- gck/tests
- gcr
- gcr/icons
- gcr/icons/16x16
- gcr/icons/22x22
- gcr/icons/24x24
- gcr/icons/256x256
- gcr/icons/32x32
- gcr/icons/48x48
- gcr/icons/src
- gcr/tests
- gcr/tests/files
- gcr/tests/files/gnupg-homedir
- gcr/tests/files/gnupg-mock
- gcr/tests/files/prompt-tests
- po
- schema
- testing
- testing/ca-example
- testing/ca-example/certs
- testing/ca-example/keys
- testing/ca-example/profiles
- testing/ca-example/requests
added
removed
docs/reference/gck/html/GckAttributes.html
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html>
3
<head>
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<title>GckAttributes</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
<link rel="home" href="index.html" title="Gck Library Reference Manual">
8
<link rel="up" href="reference.html" title="PKCS#11 GObject Bindings">
9
<link rel="prev" href="gck-GckAttribute.html" title="GckAttribute">
10
<link rel="next" href="GckObjectCache.html" title="GckObjectCache">
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
</head>
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
<tr valign="middle">
17
<td><a accesskey="p" href="gck-GckAttribute.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
<td><a accesskey="u" href="reference.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
<th width="100%" align="center">Gck Library Reference Manual</th>
21
<td><a accesskey="n" href="GckObjectCache.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
</tr>
23
<tr><td colspan="5" class="shortcuts">
24
<a href="#GckAttributes.synopsis" class="shortcut">Top</a>
25
|
26
<a href="#GckAttributes.description" class="shortcut">Description</a>
27
|
28
<a href="#GckAttributes.object-hierarchy" class="shortcut">Object Hierarchy</a>
29
</td></tr>
30
</table>
31
<div class="refentry">
32
<a name="GckAttributes"></a><div class="titlepage"></div>
33
<div class="refnamediv"><table width="100%"><tr>
34
<td valign="top">
35
<h2><span class="refentrytitle"><a name="GckAttributes.top_of_page"></a>GckAttributes</span></h2>
36
<p>GckAttributes — A set of PKCS11 attributes.</p>
37
</td>
38
<td valign="top" align="right"></td>
39
</tr></table></div>
40
<div class="refsynopsisdiv">
41
<a name="GckAttributes.synopsis"></a><h2>Synopsis</h2>
42
<a name="GckBuilder"></a><pre class="synopsis"> <a class="link" href="GckAttributes.html#GckAttributes-struct" title="GckAttributes">GckAttributes</a>;
43
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-new-empty" title="gck_attributes_new_empty ()">gck_attributes_new_empty</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> first_type</code></em>,
44
<em class="parameter"><code>...</code></em>);
45
const <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-at" title="gck_attributes_at ()">gck_attributes_at</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
46
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);
47
const <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-find" title="gck_attributes_find ()">gck_attributes_find</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
48
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
49
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckAttributes.html#gck-attributes-find-boolean" title="gck_attributes_find_boolean ()">gck_attributes_find_boolean</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
50
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
51
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);
52
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckAttributes.html#gck-attributes-find-ulong" title="gck_attributes_find_ulong ()">gck_attributes_find_ulong</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
53
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
54
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *value</code></em>);
55
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckAttributes.html#gck-attributes-find-string" title="gck_attributes_find_string ()">gck_attributes_find_string</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
56
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
57
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>);
58
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckAttributes.html#gck-attributes-find-date" title="gck_attributes_find_date ()">gck_attributes_find_date</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
59
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
60
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);
61
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> <a class="link" href="GckAttributes.html#gck-attributes-count" title="gck_attributes_count ()">gck_attributes_count</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
62
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-ref" title="gck_attributes_ref ()">gck_attributes_ref</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
63
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-ref-sink" title="gck_attributes_ref_sink ()">gck_attributes_ref_sink</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
64
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-attributes-unref" title="gck_attributes_unref ()">gck_attributes_unref</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> attrs</code></em>);
65
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckAttributes.html#gck-attributes-contains" title="gck_attributes_contains ()">gck_attributes_contains</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
66
<em class="parameter"><code>const <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="type">GckAttribute</span></a> *match</code></em>);
67
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-to-string" title="gck_attributes_to_string ()">gck_attributes_to_string</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
68
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-attributes-dump" title="gck_attributes_dump ()">gck_attributes_dump</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
69
struct <a class="link" href="GckAttributes.html#GckBuilder-struct" title="struct GckBuilder">GckBuilder</a>;
70
enum <a class="link" href="GckAttributes.html#GckBuilderFlags" title="enum GckBuilderFlags">GckBuilderFlags</a>;
71
#define <a class="link" href="GckAttributes.html#GCK-BUILDER-INIT:CAPS" title="GCK_BUILDER_INIT">GCK_BUILDER_INIT</a>
72
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-init" title="gck_builder_init ()">gck_builder_init</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);
73
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-init-full" title="gck_builder_init_full ()">gck_builder_init_full</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
74
<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilderFlags" title="enum GckBuilderFlags"><span class="type">GckBuilderFlags</span></a> flags</code></em>);
75
<a class="link" href="GckAttributes.html#GckBuilder"><span class="returnvalue">GckBuilder</span></a> * <a class="link" href="GckAttributes.html#gck-builder-new" title="gck_builder_new ()">gck_builder_new</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilderFlags" title="enum GckBuilderFlags"><span class="type">GckBuilderFlags</span></a> flags</code></em>);
76
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-boolean" title="gck_builder_add_boolean ()">gck_builder_add_boolean</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
77
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
78
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);
79
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-set-boolean" title="gck_builder_set_boolean ()">gck_builder_set_boolean</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
80
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
81
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);
82
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-data" title="gck_builder_add_data ()">gck_builder_add_data</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
83
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
84
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *value</code></em>,
85
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);
86
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-set-data" title="gck_builder_set_data ()">gck_builder_set_data</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
87
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
88
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *value</code></em>,
89
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);
90
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-take-data" title="gck_builder_take_data ()">gck_builder_take_data</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
91
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
92
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *value</code></em>,
93
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);
94
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-date" title="gck_builder_add_date ()">gck_builder_add_date</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
95
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
96
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);
97
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-set-date" title="gck_builder_set_date ()">gck_builder_set_date</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
98
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
99
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);
100
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-string" title="gck_builder_add_string ()">gck_builder_add_string</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
101
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
102
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
103
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-set-string" title="gck_builder_set_string ()">gck_builder_set_string</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
104
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
105
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
106
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-ulong" title="gck_builder_add_ulong ()">gck_builder_add_ulong</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
107
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
108
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);
109
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-set-ulong" title="gck_builder_set_ulong ()">gck_builder_set_ulong</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
110
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
111
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);
112
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-empty" title="gck_builder_add_empty ()">gck_builder_add_empty</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
113
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
114
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-set-empty" title="gck_builder_set_empty ()">gck_builder_set_empty</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
115
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
116
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-invalid" title="gck_builder_add_invalid ()">gck_builder_add_invalid</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
117
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
118
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-set-invalid" title="gck_builder_set_invalid ()">gck_builder_set_invalid</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
119
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
120
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-attribute" title="gck_builder_add_attribute ()">gck_builder_add_attribute</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
121
<em class="parameter"><code>const <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="type">GckAttribute</span></a> *attr</code></em>);
122
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-all" title="gck_builder_add_all ()">gck_builder_add_all</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
123
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
124
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-set-all" title="gck_builder_set_all ()">gck_builder_set_all</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
125
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
126
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-except" title="gck_builder_add_except ()">gck_builder_add_except</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
127
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
128
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> except_type</code></em>,
129
<em class="parameter"><code>...</code></em>);
130
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-exceptv" title="gck_builder_add_exceptv ()">gck_builder_add_exceptv</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
131
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
132
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *except_types</code></em>,
133
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_except_types</code></em>);
134
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-only" title="gck_builder_add_only ()">gck_builder_add_only</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
135
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
136
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> only_type</code></em>,
137
<em class="parameter"><code>...</code></em>);
138
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-add-onlyv" title="gck_builder_add_onlyv ()">gck_builder_add_onlyv</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
139
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
140
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *only_types</code></em>,
141
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_only_types</code></em>);
142
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="GckAttributes.html#gck-builder-end" title="gck_builder_end ()">gck_builder_end</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);
143
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-clear" title="gck_builder_clear ()">gck_builder_clear</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);
144
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="GckAttributes.html#gck-builder-steal" title="gck_builder_steal ()">gck_builder_steal</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);
145
<a class="link" href="GckAttributes.html#GckBuilder"><span class="returnvalue">GckBuilder</span></a> * <a class="link" href="GckAttributes.html#gck-builder-ref" title="gck_builder_ref ()">gck_builder_ref</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);
146
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-builder-unref" title="gck_builder_unref ()">gck_builder_unref</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> builder</code></em>);
147
<a class="link" href="GckAttributes.html#GckBuilder"><span class="returnvalue">GckBuilder</span></a> * <a class="link" href="GckAttributes.html#gck-builder-copy" title="gck_builder_copy ()">gck_builder_copy</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);
148
const <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-builder-find" title="gck_builder_find ()">gck_builder_find</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
149
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
150
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckAttributes.html#gck-builder-find-boolean" title="gck_builder_find_boolean ()">gck_builder_find_boolean</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
151
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
152
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);
153
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckAttributes.html#gck-builder-find-date" title="gck_builder_find_date ()">gck_builder_find_date</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
154
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
155
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);
156
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckAttributes.html#gck-builder-find-string" title="gck_builder_find_string ()">gck_builder_find_string</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
157
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
158
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>);
159
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckAttributes.html#gck-builder-find-ulong" title="gck_builder_find_ulong ()">gck_builder_find_ulong</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
160
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
161
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *value</code></em>);
162
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-new" title="gck_attributes_new ()">gck_attributes_new</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> reserved</code></em>);
163
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-add" title="gck_attributes_add ()">gck_attributes_add</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
164
<em class="parameter"><code><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="type">GckAttribute</span></a> *attr</code></em>);
165
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-attributes-add-all" title="gck_attributes_add_all ()">gck_attributes_add_all</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
166
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *from</code></em>);
167
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-add-boolean" title="gck_attributes_add_boolean ()">gck_attributes_add_boolean</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
168
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
169
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);
170
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-add-data" title="gck_attributes_add_data ()">gck_attributes_add_data</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
171
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
172
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *value</code></em>,
173
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);
174
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-add-date" title="gck_attributes_add_date ()">gck_attributes_add_date</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
175
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
176
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);
177
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-add-empty" title="gck_attributes_add_empty ()">gck_attributes_add_empty</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
178
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
179
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-add-invalid" title="gck_attributes_add_invalid ()">gck_attributes_add_invalid</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
180
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
181
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-add-string" title="gck_attributes_add_string ()">gck_attributes_add_string</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
182
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
183
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
184
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-add-ulong" title="gck_attributes_add_ulong ()">gck_attributes_add_ulong</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
185
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
186
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);
187
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-dup" title="gck_attributes_dup ()">gck_attributes_dup</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
188
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="GckAttributes.html#gck-attributes-new-full" title="gck_attributes_new_full ()">gck_attributes_new_full</a> (<em class="parameter"><code><span class="type">GckAllocator</span> allocator</code></em>);
189
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-attributes-set" title="gck_attributes_set ()">gck_attributes_set</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
190
<em class="parameter"><code><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="type">GckAttribute</span></a> *attr</code></em>);
191
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-attributes-set-all" title="gck_attributes_set_all ()">gck_attributes_set_all</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
192
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *from</code></em>);
193
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-attributes-set-boolean" title="gck_attributes_set_boolean ()">gck_attributes_set_boolean</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
194
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
195
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);
196
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-attributes-set-date" title="gck_attributes_set_date ()">gck_attributes_set_date</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
197
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
198
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);
199
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-attributes-set-string" title="gck_attributes_set_string ()">gck_attributes_set_string</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
200
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
201
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
202
<span class="returnvalue">void</span> <a class="link" href="GckAttributes.html#gck-attributes-set-ulong" title="gck_attributes_set_ulong ()">gck_attributes_set_ulong</a> (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
203
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
204
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);
205
</pre>
206
</div>
207
<div class="refsect1">
208
<a name="GckAttributes.object-hierarchy"></a><h2>Object Hierarchy</h2>
209
<pre class="synopsis">
210
GBoxed
211
+----GckAttributes
212
</pre>
213
<pre class="synopsis">
214
GBoxed
215
+----GckBuilder
216
</pre>
217
</div>
218
<div class="refsect1">
219
<a name="GckAttributes.description"></a><h2>Description</h2>
220
<p>
221
A set of GckAttribute structures. These attributes contain information
222
about a PKCS11 object. Use <a class="link" href="GckObject.html#gck-object-get" title="gck_object_get ()"><code class="function">gck_object_get()</code></a> or <a class="link" href="GckObject.html#gck-object-set" title="gck_object_set ()"><code class="function">gck_object_set()</code></a> to set and retrieve
223
attributes on an object.
224
</p>
225
</div>
226
<div class="refsect1">
227
<a name="GckAttributes.details"></a><h2>Details</h2>
228
<div class="refsect2">
229
<a name="GckAttributes-struct"></a><h3>GckAttributes</h3>
230
<pre class="programlisting">typedef struct _GckAttributes GckAttributes;</pre>
231
<p>
232
A set of GckAttribute structures.
233
</p>
234
</div>
235
<hr>
236
<div class="refsect2">
237
<a name="gck-attributes-new-empty"></a><h3>gck_attributes_new_empty ()</h3>
238
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_attributes_new_empty (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> first_type</code></em>,
239
<em class="parameter"><code>...</code></em>);</pre>
240
<p>
241
Creates an GckAttributes array with empty attributes
242
</p>
243
<p>
244
Terminate the argument list with <a class="link" href="gck-Miscellaneous-Functions.html#GCK-INVALID:CAPS" title="GCK_INVALID"><code class="literal">GCK_INVALID</code></a>.
245
</p>
246
<p>
247
The returned set of attributes is floating, and should either be passed to
248
another gck library function which consumes this floating reference, or if
249
you wish to keep these attributes around you should ref them with
250
<a class="link" href="GckAttributes.html#gck-attributes-ref-sink" title="gck_attributes_ref_sink ()"><code class="function">gck_attributes_ref_sink()</code></a> and unref them later with <a class="link" href="GckAttributes.html#gck-attributes-unref" title="gck_attributes_unref ()"><code class="function">gck_attributes_unref()</code></a>.
251
</p>
252
<div class="variablelist"><table border="0">
253
<col align="left" valign="top">
254
<tbody>
255
<tr>
256
<td><p><span class="term"><em class="parameter"><code>first_type</code></em> :</span></p></td>
257
<td>the first empty attribute type</td>
258
</tr>
259
<tr>
260
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
261
<td>the other empty attribute types</td>
262
</tr>
263
<tr>
264
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
265
<td>a floating reference to an empty set of attributes. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
266
</td>
267
</tr>
268
</tbody>
269
</table></div>
270
</div>
271
<hr>
272
<div class="refsect2">
273
<a name="gck-attributes-at"></a><h3>gck_attributes_at ()</h3>
274
<pre class="programlisting">const <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_at (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
275
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
276
<p>
277
Get attribute at the specified index in the attribute array.
278
</p>
279
<p>
280
Use <a class="link" href="GckAttributes.html#gck-attributes-count" title="gck_attributes_count ()"><code class="function">gck_attributes_count()</code></a> to determine how many attributes are
281
in the array.
282
</p>
283
<div class="variablelist"><table border="0">
284
<col align="left" valign="top">
285
<tbody>
286
<tr>
287
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
288
<td>The attributes array.</td>
289
</tr>
290
<tr>
291
<td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
292
<td>The attribute index to retrieve.</td>
293
</tr>
294
<tr>
295
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
296
<td>the specified attribute. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
297
</td>
298
</tr>
299
</tbody>
300
</table></div>
301
</div>
302
<hr>
303
<div class="refsect2">
304
<a name="gck-attributes-find"></a><h3>gck_attributes_find ()</h3>
305
<pre class="programlisting">const <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_find (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
306
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
307
<p>
308
Find an attribute with the specified type in the array.
309
</p>
310
<div class="variablelist"><table border="0">
311
<col align="left" valign="top">
312
<tbody>
313
<tr>
314
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
315
<td>The attributes array to search.</td>
316
</tr>
317
<tr>
318
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
319
<td>The type of attribute to find.</td>
320
</tr>
321
<tr>
322
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
323
<td>the first attribute found with the specified type,
324
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
325
</td>
326
</tr>
327
</tbody>
328
</table></div>
329
</div>
330
<hr>
331
<div class="refsect2">
332
<a name="gck-attributes-find-boolean"></a><h3>gck_attributes_find_boolean ()</h3>
333
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_attributes_find_boolean (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
334
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
335
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);</pre>
336
<p>
337
Find an attribute with the specified type in the array.
338
</p>
339
<p>
340
The attribute (if found) must be of the right size to store
341
a boolean value (ie: CK_BBOOL). If the attribute is marked invalid
342
then it will be treated as not found.
343
</p>
344
<div class="variablelist"><table border="0">
345
<col align="left" valign="top">
346
<tbody>
347
<tr>
348
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
349
<td>The attributes array to search.</td>
350
</tr>
351
<tr>
352
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
353
<td>The type of attribute to find.</td>
354
</tr>
355
<tr>
356
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
357
<td>The resulting gboolean value.</td>
358
</tr>
359
<tr>
360
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
361
<td>Whether a value was found or not.</td>
362
</tr>
363
</tbody>
364
</table></div>
365
</div>
366
<hr>
367
<div class="refsect2">
368
<a name="gck-attributes-find-ulong"></a><h3>gck_attributes_find_ulong ()</h3>
369
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_attributes_find_ulong (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
370
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
371
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *value</code></em>);</pre>
372
<p>
373
Find an attribute with the specified type in the array.
374
</p>
375
<p>
376
The attribute (if found) must be of the right size to store
377
a unsigned long value (ie: CK_ULONG). If the attribute is marked invalid
378
then it will be treated as not found.
379
</p>
380
<div class="variablelist"><table border="0">
381
<col align="left" valign="top">
382
<tbody>
383
<tr>
384
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
385
<td>The attributes array to search.</td>
386
</tr>
387
<tr>
388
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
389
<td>The type of attribute to find.</td>
390
</tr>
391
<tr>
392
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
393
<td>The resulting gulong value.</td>
394
</tr>
395
<tr>
396
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
397
<td>Whether a value was found or not.</td>
398
</tr>
399
</tbody>
400
</table></div>
401
</div>
402
<hr>
403
<div class="refsect2">
404
<a name="gck-attributes-find-string"></a><h3>gck_attributes_find_string ()</h3>
405
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_attributes_find_string (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
406
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
407
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>);</pre>
408
<p>
409
Find an attribute with the specified type in the array.
410
</p>
411
<p>
412
If the attribute is marked invalid then it will be treated as not found.
413
The resulting string will be null-terminated, and must be freed by the caller
414
using <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
415
</p>
416
<div class="variablelist"><table border="0">
417
<col align="left" valign="top">
418
<tbody>
419
<tr>
420
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
421
<td>The attributes array to search.</td>
422
</tr>
423
<tr>
424
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
425
<td>The type of attribute to find.</td>
426
</tr>
427
<tr>
428
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
429
<td>The resulting string value.</td>
430
</tr>
431
<tr>
432
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
433
<td>Whether a value was found or not.</td>
434
</tr>
435
</tbody>
436
</table></div>
437
</div>
438
<hr>
439
<div class="refsect2">
440
<a name="gck-attributes-find-date"></a><h3>gck_attributes_find_date ()</h3>
441
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_attributes_find_date (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
442
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
443
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);</pre>
444
<p>
445
Find an attribute with the specified type in the array.
446
</p>
447
<p>
448
The attribute (if found) must be of the right size to store
449
a date value (ie: CK_DATE). If the attribute is marked invalid
450
then it will be treated as not found.
451
</p>
452
<div class="variablelist"><table border="0">
453
<col align="left" valign="top">
454
<tbody>
455
<tr>
456
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
457
<td>The attributes array to search.</td>
458
</tr>
459
<tr>
460
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
461
<td>The type of attribute to find.</td>
462
</tr>
463
<tr>
464
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
465
<td>The resulting GDate value.</td>
466
</tr>
467
<tr>
468
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
469
<td>Whether a value was found or not.</td>
470
</tr>
471
</tbody>
472
</table></div>
473
</div>
474
<hr>
475
<div class="refsect2">
476
<a name="gck-attributes-count"></a><h3>gck_attributes_count ()</h3>
477
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> gck_attributes_count (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
478
<p>
479
Get the number of attributes in this attribute array.
480
</p>
481
<div class="variablelist"><table border="0">
482
<col align="left" valign="top">
483
<tbody>
484
<tr>
485
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
486
<td>The attributes array to count.</td>
487
</tr>
488
<tr>
489
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
490
<td>The number of contained attributes.</td>
491
</tr>
492
</tbody>
493
</table></div>
494
</div>
495
<hr>
496
<div class="refsect2">
497
<a name="gck-attributes-ref"></a><h3>gck_attributes_ref ()</h3>
498
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_attributes_ref (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
499
<p>
500
Reference this attributes array.
501
</p>
502
<div class="variablelist"><table border="0">
503
<col align="left" valign="top">
504
<tbody>
505
<tr>
506
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
507
<td>An attribute array</td>
508
</tr>
509
<tr>
510
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
511
<td>the attributes</td>
512
</tr>
513
</tbody>
514
</table></div>
515
</div>
516
<hr>
517
<div class="refsect2">
518
<a name="gck-attributes-ref-sink"></a><h3>gck_attributes_ref_sink ()</h3>
519
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_attributes_ref_sink (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
520
<p>
521
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> uses a floating reference count system. <a class="link" href="GckAttributes.html#gck-builder-end" title="gck_builder_end ()"><code class="function">gck_builder_end()</code></a>
522
and <a class="link" href="GckAttributes.html#gck-attributes-new-empty" title="gck_attributes_new_empty ()"><code class="function">gck_attributes_new_empty()</code></a> both return floating references.
523
</p>
524
<p>
525
Calling <a class="link" href="GckAttributes.html#gck-attributes-ref-sink" title="gck_attributes_ref_sink ()"><code class="function">gck_attributes_ref_sink()</code></a> on a <a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> with a floating
526
reference will convert the floating reference into a full reference.
527
Calling <a class="link" href="GckAttributes.html#gck-attributes-ref-sink" title="gck_attributes_ref_sink ()"><code class="function">gck_attributes_ref_sink()</code></a> on a non-floating <a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> results
528
in an additional normal reference being added.
529
</p>
530
<p>
531
In other words, if the <em class="parameter"><code>attrs</code></em> is floating, then this call "assumes
532
ownership" of the floating reference, converting it to a normal
533
reference. If the <em class="parameter"><code>attrs</code></em> is not floating, then this call adds a
534
new normal reference increasing the reference count by one.
535
</p>
536
<p>
537
All Gck library functions that assume ownership of floating references
538
are documented as such. Essentially any Gck function that performs
539
an operation using a <a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> argument rather than operating on the
540
atributes themselves, will accept a floating reference.
541
</p>
542
<div class="variablelist"><table border="0">
543
<col align="left" valign="top">
544
<tbody>
545
<tr>
546
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
547
<td>an attribute array</td>
548
</tr>
549
<tr>
550
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
551
<td>the referenced attributes</td>
552
</tr>
553
</tbody>
554
</table></div>
555
</div>
556
<hr>
557
<div class="refsect2">
558
<a name="gck-attributes-unref"></a><h3>gck_attributes_unref ()</h3>
559
<pre class="programlisting"><span class="returnvalue">void</span> gck_attributes_unref (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> attrs</code></em>);</pre>
560
<p>
561
Unreference this attribute array.
562
</p>
563
<p>
564
When all outstanding references are gone, the array will be freed.
565
</p>
566
<div class="variablelist"><table border="0">
567
<col align="left" valign="top">
568
<tbody><tr>
569
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
570
<td>(type Gck.Attributes): An attribute array. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
571
</td>
572
</tr></tbody>
573
</table></div>
574
</div>
575
<hr>
576
<div class="refsect2">
577
<a name="gck-attributes-contains"></a><h3>gck_attributes_contains ()</h3>
578
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_attributes_contains (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
579
<em class="parameter"><code>const <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="type">GckAttribute</span></a> *match</code></em>);</pre>
580
<p>
581
Check whether the attributes contain a certain attribute.
582
</p>
583
<div class="variablelist"><table border="0">
584
<col align="left" valign="top">
585
<tbody>
586
<tr>
587
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
588
<td>The attributes to check</td>
589
</tr>
590
<tr>
591
<td><p><span class="term"><em class="parameter"><code>match</code></em> :</span></p></td>
592
<td>The attribute to find</td>
593
</tr>
594
<tr>
595
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
596
<td>
597
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attributes contain the attribute.</td>
598
</tr>
599
</tbody>
600
</table></div>
601
</div>
602
<hr>
603
<div class="refsect2">
604
<a name="gck-attributes-to-string"></a><h3>gck_attributes_to_string ()</h3>
605
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gck_attributes_to_string (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
606
<p>
607
Print out attributes to a string in aform that's useful for debugging
608
or logging.
609
</p>
610
<p>
611
The format of the string returned may change in the future.
612
</p>
613
<div class="variablelist"><table border="0">
614
<col align="left" valign="top">
615
<tbody>
616
<tr>
617
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
618
<td>the attributes</td>
619
</tr>
620
<tr>
621
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
622
<td>a newly allocated string</td>
623
</tr>
624
</tbody>
625
</table></div>
626
</div>
627
<hr>
628
<div class="refsect2">
629
<a name="gck-attributes-dump"></a><h3>gck_attributes_dump ()</h3>
630
<pre class="programlisting"><span class="returnvalue">void</span> gck_attributes_dump (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
631
<p>
632
Dump the attributes using <a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-printerr"><code class="function">g_printerr()</code></a>.
633
</p>
634
<div class="variablelist"><table border="0">
635
<col align="left" valign="top">
636
<tbody><tr>
637
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
638
<td>The attributes</td>
639
</tr></tbody>
640
</table></div>
641
</div>
642
<hr>
643
<div class="refsect2">
644
<a name="GckBuilder-struct"></a><h3>struct GckBuilder</h3>
645
<pre class="programlisting">struct GckBuilder {
646
};
647
</pre>
648
<p>
649
A builder for a set of attributes. Add attributes to a builder, and then use
650
<a class="link" href="GckAttributes.html#gck-builder-end" title="gck_builder_end ()"><code class="function">gck_builder_end()</code></a> to get the completed <a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a>.
651
</p>
652
<p>
653
The fields of <a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> are private and not to be accessed directly.
654
</p>
655
</div>
656
<hr>
657
<div class="refsect2">
658
<a name="GckBuilderFlags"></a><h3>enum GckBuilderFlags</h3>
659
<pre class="programlisting">typedef enum {
660
GCK_BUILDER_NONE,
661
GCK_BUILDER_SECURE_MEMORY = 1,
662
} GckBuilderFlags;
663
</pre>
664
<p>
665
Flags to be used with a <a class="link" href="GckAttributes.html#gck-builder-init-full" title="gck_builder_init_full ()"><code class="function">gck_builder_init_full()</code></a> and <a class="link" href="GckAttributes.html#gck-builder-new" title="gck_builder_new ()"><code class="function">gck_builder_new()</code></a>.
666
</p>
667
<div class="variablelist"><table border="0">
668
<col align="left" valign="top">
669
<tbody>
670
<tr>
671
<td><p><a name="GCK-BUILDER-NONE:CAPS"></a><span class="term"><code class="literal">GCK_BUILDER_NONE</code></span></p></td>
672
<td>no special flags
673
</td>
674
</tr>
675
<tr>
676
<td><p><a name="GCK-BUILDER-SECURE-MEMORY:CAPS"></a><span class="term"><code class="literal">GCK_BUILDER_SECURE_MEMORY</code></span></p></td>
677
<td>use non-pageable memory for the values of the attributes
678
</td>
679
</tr>
680
</tbody>
681
</table></div>
682
</div>
683
<hr>
684
<div class="refsect2">
685
<a name="GCK-BUILDER-INIT:CAPS"></a><h3>GCK_BUILDER_INIT</h3>
686
<pre class="programlisting">#define GCK_BUILDER_INIT { { 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 } }
687
</pre>
688
<p>
689
Values that can be assigned to a <a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> allocated on the stack.
690
</p>
691
<p>
692
</p>
693
<div class="informalexample">
694
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
695
<tbody>
696
<tr>
697
<td class="listing_lines" align="right"><pre>1</pre></td>
698
<td class="listing_code"><pre class="programlisting"><span class="usertype">GckBuilder</span><span class="normal"> builder </span><span class="symbol">=</span><span class="normal"> <a href="GckAttributes.html#GCK-BUILDER-INIT:CAPS">GCK_BUILDER_INIT</a></span><span class="symbol">;</span></pre></td>
699
</tr>
700
</tbody>
701
</table>
702
</div>
703
704
<p>
705
</p>
706
</div>
707
<hr>
708
<div class="refsect2">
709
<a name="gck-builder-init"></a><h3>gck_builder_init ()</h3>
710
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_init (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);</pre>
711
<p>
712
Initialize a stack allocated builder, with the default flags.
713
</p>
714
<p>
715
This is equivalent to initializing a builder variable with the
716
<a class="link" href="GckAttributes.html#GCK-BUILDER-INIT:CAPS" title="GCK_BUILDER_INIT"><code class="literal">GCK_BUILDER_INIT</code></a> constant, or setting it to zeroed memory.
717
</p>
718
<p>
719
</p>
720
<div class="informalexample">
721
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
722
<tbody>
723
<tr>
724
<td class="listing_lines" align="right"><pre>1
725
2
726
3
727
4
728
5
729
6
730
7
731
8</pre></td>
732
<td class="listing_code"><pre class="programlisting"><span class="comment">/* Equivalent ways of initializing a GckBuilder */</span>
733
<span class="usertype">GckBuilder</span><span class="normal"> builder </span><span class="symbol">=</span><span class="normal"> <a href="GckAttributes.html#GCK-BUILDER-INIT:CAPS">GCK_BUILDER_INIT</a></span><span class="symbol">;</span>
734
<span class="usertype">GckBuilder</span><span class="normal"> builder2</span><span class="symbol">;</span>
735
<span class="usertype">GckBuilder</span><span class="normal"> builder3</span><span class="symbol">;</span>
736
737
<span class="function"><a href="GckAttributes.html#gck-builder-init">gck_builder_init</a></span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">builder2</span><span class="symbol">);</span>
738
739
<span class="function">memset</span><span class="normal"> </span><span class="symbol">(&</span><span class="normal">builder3</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder3</span><span class="symbol">));</span></pre></td>
740
</tr>
741
</tbody>
742
</table>
743
</div>
744
745
<p>
746
</p>
747
<div class="variablelist"><table border="0">
748
<col align="left" valign="top">
749
<tbody><tr>
750
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
751
<td>the builder</td>
752
</tr></tbody>
753
</table></div>
754
</div>
755
<hr>
756
<div class="refsect2">
757
<a name="gck-builder-init-full"></a><h3>gck_builder_init_full ()</h3>
758
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_init_full (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
759
<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilderFlags" title="enum GckBuilderFlags"><span class="type">GckBuilderFlags</span></a> flags</code></em>);</pre>
760
<p>
761
Initialize a stack allocated builder, with the appropriate flags.
762
</p>
763
<p>
764
If the <a class="link" href="GckAttributes.html#GCK-BUILDER-SECURE-MEMORY:CAPS"><code class="literal">GCK_BUILDER_SECURE_MEMORY</code></a> flag is specified then non-pageable memory
765
will be used for the various values of the attributes in the builder
766
</p>
767
<div class="variablelist"><table border="0">
768
<col align="left" valign="top">
769
<tbody>
770
<tr>
771
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
772
<td>the builder</td>
773
</tr>
774
<tr>
775
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
776
<td>the flags for the new builder</td>
777
</tr>
778
</tbody>
779
</table></div>
780
</div>
781
<hr>
782
<div class="refsect2">
783
<a name="gck-builder-new"></a><h3>gck_builder_new ()</h3>
784
<pre class="programlisting"><a class="link" href="GckAttributes.html#GckBuilder"><span class="returnvalue">GckBuilder</span></a> * gck_builder_new (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilderFlags" title="enum GckBuilderFlags"><span class="type">GckBuilderFlags</span></a> flags</code></em>);</pre>
785
<p>
786
Create a new <a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> not allocated on the stack, so it can be shared
787
across a single scope, and referenced / unreferenced.
788
</p>
789
<p>
790
Normally a <a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> is created on the stack, and simply initialized.
791
</p>
792
<p>
793
If the <a class="link" href="GckAttributes.html#GCK-BUILDER-SECURE-MEMORY:CAPS"><code class="literal">GCK_BUILDER_SECURE_MEMORY</code></a> flag is specified then non-pageable memory
794
will be used for the various values of the attributes in the builder
795
</p>
796
<div class="variablelist"><table border="0">
797
<col align="left" valign="top">
798
<tbody>
799
<tr>
800
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
801
<td>flags for the new builder</td>
802
</tr>
803
<tr>
804
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
805
<td>a new builder, to be freed with <a class="link" href="GckAttributes.html#gck-builder-unref" title="gck_builder_unref ()"><code class="function">gck_builder_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
806
</td>
807
</tr>
808
</tbody>
809
</table></div>
810
</div>
811
<hr>
812
<div class="refsect2">
813
<a name="gck-builder-add-boolean"></a><h3>gck_builder_add_boolean ()</h3>
814
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_boolean (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
815
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
816
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);</pre>
817
<p>
818
Add a new attribute to the builder for the boolean <em class="parameter"><code>value</code></em>.
819
Unconditionally adds a new attribute, even if one with the same <em class="parameter"><code>attr_type</code></em>
820
already exists.
821
</p>
822
<div class="variablelist"><table border="0">
823
<col align="left" valign="top">
824
<tbody>
825
<tr>
826
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
827
<td>the builder</td>
828
</tr>
829
<tr>
830
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
831
<td>the new attribute type</td>
832
</tr>
833
<tr>
834
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
835
<td>the attribute value</td>
836
</tr>
837
</tbody>
838
</table></div>
839
</div>
840
<hr>
841
<div class="refsect2">
842
<a name="gck-builder-set-boolean"></a><h3>gck_builder_set_boolean ()</h3>
843
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_set_boolean (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
844
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
845
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);</pre>
846
<p>
847
Set an attribute on the builder for the boolean <em class="parameter"><code>value</code></em>.
848
If an attribute with <em class="parameter"><code>attr_type</code></em> already exists in the builder then it is
849
changed to the new value, otherwise an attribute is added.
850
</p>
851
<div class="variablelist"><table border="0">
852
<col align="left" valign="top">
853
<tbody>
854
<tr>
855
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
856
<td>the builder</td>
857
</tr>
858
<tr>
859
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
860
<td>the new attribute type</td>
861
</tr>
862
<tr>
863
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
864
<td>the attribute value</td>
865
</tr>
866
</tbody>
867
</table></div>
868
</div>
869
<hr>
870
<div class="refsect2">
871
<a name="gck-builder-add-data"></a><h3>gck_builder_add_data ()</h3>
872
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_data (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
873
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
874
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *value</code></em>,
875
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
876
<p>
877
Add a new attribute to the builder with an arbitrary value. Unconditionally
878
adds a new attribute, even if one with the same <em class="parameter"><code>attr_type</code></em> already exists.
879
</p>
880
<p>
881
The memory in <em class="parameter"><code>value</code></em> is copied by the builder.
882
</p>
883
<p>
884
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be specified for the <em class="parameter"><code>value</code></em> argument, in which case an empty
885
attribute is created. GCK_INVALID may be specified for the length, in
886
which case an invalid attribute is created in the PKCS#11 style.
887
</p>
888
<div class="variablelist"><table border="0">
889
<col align="left" valign="top">
890
<tbody>
891
<tr>
892
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
893
<td>the builder</td>
894
</tr>
895
<tr>
896
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
897
<td>the new attribute type</td>
898
</tr>
899
<tr>
900
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
901
<td>(allow-none): the new attribute memory. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
902
</td>
903
</tr>
904
<tr>
905
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
906
<td>the length of the memory</td>
907
</tr>
908
</tbody>
909
</table></div>
910
</div>
911
<hr>
912
<div class="refsect2">
913
<a name="gck-builder-set-data"></a><h3>gck_builder_set_data ()</h3>
914
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_set_data (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
915
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
916
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *value</code></em>,
917
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
918
<p>
919
Set a new attribute to the builder with an arbitrary value. If an attribute
920
with <em class="parameter"><code>attr_type</code></em> already exists in the builder then it is changed to the new
921
value, otherwise an attribute is added.
922
</p>
923
<p>
924
The memory in <em class="parameter"><code>value</code></em> is copied by the builder.
925
</p>
926
<p>
927
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be specified for the <em class="parameter"><code>value</code></em> argument, in which case an empty
928
attribute is created. GCK_INVALID may be specified for the length, in
929
which case an invalid attribute is created in the PKCS#11 style.
930
</p>
931
<div class="variablelist"><table border="0">
932
<col align="left" valign="top">
933
<tbody>
934
<tr>
935
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
936
<td>the builder</td>
937
</tr>
938
<tr>
939
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
940
<td>the attribute type</td>
941
</tr>
942
<tr>
943
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
944
<td>(allow-none): the new attribute memory. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
945
</td>
946
</tr>
947
<tr>
948
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
949
<td>the length of the memory</td>
950
</tr>
951
</tbody>
952
</table></div>
953
</div>
954
<hr>
955
<div class="refsect2">
956
<a name="gck-builder-take-data"></a><h3>gck_builder_take_data ()</h3>
957
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_take_data (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
958
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
959
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *value</code></em>,
960
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
961
<p>
962
Add a new attribute to the builder with an arbitrary value. Unconditionally
963
adds a new attribute, even if one with the same <em class="parameter"><code>attr_type</code></em> already exists.
964
</p>
965
<p>
966
Ownership of the <em class="parameter"><code>value</code></em> memory is taken by the builder, may be reallocated,
967
and is eventually freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. The memory must have been allocated
968
using the standard GLib memory allocation routines.
969
</p>
970
<p>
971
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> may be specified for the <em class="parameter"><code>value</code></em> argument, in which case an empty
972
attribute is created. GCK_INVALID may be specified for the length, in
973
which case an invalid attribute is created in the PKCS#11 style.
974
</p>
975
<div class="variablelist"><table border="0">
976
<col align="left" valign="top">
977
<tbody>
978
<tr>
979
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
980
<td>the builder</td>
981
</tr>
982
<tr>
983
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
984
<td>the new attribute type</td>
985
</tr>
986
<tr>
987
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
988
<td>(array length=length): (allow-none): the new
989
attribute memory. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
990
</td>
991
</tr>
992
<tr>
993
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
994
<td>the length of the memory</td>
995
</tr>
996
</tbody>
997
</table></div>
998
</div>
999
<hr>
1000
<div class="refsect2">
1001
<a name="gck-builder-add-date"></a><h3>gck_builder_add_date ()</h3>
1002
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_date (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1003
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
1004
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);</pre>
1005
<p>
1006
Add a new attribute to the builder for the date <em class="parameter"><code>value</code></em>.
1007
Unconditionally adds a new attribute, even if one with the same <em class="parameter"><code>attr_type</code></em>
1008
already exists.
1009
</p>
1010
<div class="variablelist"><table border="0">
1011
<col align="left" valign="top">
1012
<tbody>
1013
<tr>
1014
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1015
<td>the builder</td>
1016
</tr>
1017
<tr>
1018
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1019
<td>the new attribute type</td>
1020
</tr>
1021
<tr>
1022
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1023
<td>the attribute value</td>
1024
</tr>
1025
</tbody>
1026
</table></div>
1027
</div>
1028
<hr>
1029
<div class="refsect2">
1030
<a name="gck-builder-set-date"></a><h3>gck_builder_set_date ()</h3>
1031
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_set_date (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1032
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
1033
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);</pre>
1034
<p>
1035
Set an attribute on the builder for the date <em class="parameter"><code>value</code></em>.
1036
If an attribute with <em class="parameter"><code>attr_type</code></em> already exists in the builder then it is
1037
changed to the new value, otherwise an attribute is added.
1038
</p>
1039
<div class="variablelist"><table border="0">
1040
<col align="left" valign="top">
1041
<tbody>
1042
<tr>
1043
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1044
<td>the builder</td>
1045
</tr>
1046
<tr>
1047
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1048
<td>the new attribute type</td>
1049
</tr>
1050
<tr>
1051
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1052
<td>the attribute value</td>
1053
</tr>
1054
</tbody>
1055
</table></div>
1056
</div>
1057
<hr>
1058
<div class="refsect2">
1059
<a name="gck-builder-add-string"></a><h3>gck_builder_add_string ()</h3>
1060
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_string (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1061
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
1062
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1063
<p>
1064
Add a new attribute to the builder for the string <em class="parameter"><code>value</code></em> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
1065
Unconditionally adds a new attribute, even if one with the same <em class="parameter"><code>attr_type</code></em>
1066
already exists.
1067
</p>
1068
<div class="variablelist"><table border="0">
1069
<col align="left" valign="top">
1070
<tbody>
1071
<tr>
1072
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1073
<td>the builder</td>
1074
</tr>
1075
<tr>
1076
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1077
<td>the new attribute type</td>
1078
</tr>
1079
<tr>
1080
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1081
<td>the attribute value. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1082
</td>
1083
</tr>
1084
</tbody>
1085
</table></div>
1086
</div>
1087
<hr>
1088
<div class="refsect2">
1089
<a name="gck-builder-set-string"></a><h3>gck_builder_set_string ()</h3>
1090
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_set_string (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1091
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
1092
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1093
<p>
1094
Set an attribute on the builder for the string <em class="parameter"><code>value</code></em> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
1095
If an attribute with <em class="parameter"><code>attr_type</code></em> already exists in the builder then it is
1096
changed to the new value, otherwise an attribute is added.
1097
</p>
1098
<div class="variablelist"><table border="0">
1099
<col align="left" valign="top">
1100
<tbody>
1101
<tr>
1102
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1103
<td>the builder</td>
1104
</tr>
1105
<tr>
1106
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1107
<td>the new attribute type</td>
1108
</tr>
1109
<tr>
1110
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1111
<td>the attribute value</td>
1112
</tr>
1113
</tbody>
1114
</table></div>
1115
</div>
1116
<hr>
1117
<div class="refsect2">
1118
<a name="gck-builder-add-ulong"></a><h3>gck_builder_add_ulong ()</h3>
1119
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_ulong (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1120
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
1121
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);</pre>
1122
<p>
1123
Add a new attribute to the builder for the unsigned long <em class="parameter"><code>value</code></em>.
1124
Unconditionally adds a new attribute, even if one with the same <em class="parameter"><code>attr_type</code></em>
1125
already exists.
1126
</p>
1127
<div class="variablelist"><table border="0">
1128
<col align="left" valign="top">
1129
<tbody>
1130
<tr>
1131
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1132
<td>the builder</td>
1133
</tr>
1134
<tr>
1135
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1136
<td>the new attribute type</td>
1137
</tr>
1138
<tr>
1139
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1140
<td>the attribute value</td>
1141
</tr>
1142
</tbody>
1143
</table></div>
1144
</div>
1145
<hr>
1146
<div class="refsect2">
1147
<a name="gck-builder-set-ulong"></a><h3>gck_builder_set_ulong ()</h3>
1148
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_set_ulong (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1149
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
1150
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);</pre>
1151
<p>
1152
Set an attribute on the builder for the unsigned long <em class="parameter"><code>value</code></em>.
1153
If an attribute with <em class="parameter"><code>attr_type</code></em> already exists in the builder then it is
1154
changed to the new value, otherwise an attribute is added.
1155
</p>
1156
<div class="variablelist"><table border="0">
1157
<col align="left" valign="top">
1158
<tbody>
1159
<tr>
1160
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1161
<td>the builder</td>
1162
</tr>
1163
<tr>
1164
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1165
<td>the new attribute type</td>
1166
</tr>
1167
<tr>
1168
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1169
<td>the attribute value</td>
1170
</tr>
1171
</tbody>
1172
</table></div>
1173
</div>
1174
<hr>
1175
<div class="refsect2">
1176
<a name="gck-builder-add-empty"></a><h3>gck_builder_add_empty ()</h3>
1177
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_empty (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1178
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
1179
<p>
1180
Add a new attribute to the builder that is empty. Unconditionally
1181
adds a new attribute, even if one with the same <em class="parameter"><code>attr_type</code></em> already exists.
1182
</p>
1183
<div class="variablelist"><table border="0">
1184
<col align="left" valign="top">
1185
<tbody>
1186
<tr>
1187
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1188
<td>the builder</td>
1189
</tr>
1190
<tr>
1191
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1192
<td>the new attribute type</td>
1193
</tr>
1194
</tbody>
1195
</table></div>
1196
</div>
1197
<hr>
1198
<div class="refsect2">
1199
<a name="gck-builder-set-empty"></a><h3>gck_builder_set_empty ()</h3>
1200
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_set_empty (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1201
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
1202
<p>
1203
Set an attribute on the builder that is empty. If an attribute
1204
with <em class="parameter"><code>attr_type</code></em> already exists in the builder then it is changed to the new
1205
value, otherwise an attribute is added.
1206
</p>
1207
<div class="variablelist"><table border="0">
1208
<col align="left" valign="top">
1209
<tbody>
1210
<tr>
1211
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1212
<td>the builder</td>
1213
</tr>
1214
<tr>
1215
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1216
<td>the attribute type</td>
1217
</tr>
1218
</tbody>
1219
</table></div>
1220
</div>
1221
<hr>
1222
<div class="refsect2">
1223
<a name="gck-builder-add-invalid"></a><h3>gck_builder_add_invalid ()</h3>
1224
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_invalid (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1225
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
1226
<p>
1227
Add a new attribute to the builder that is invalid in the PKCS#11 sense.
1228
Unconditionally adds a new attribute, even if one with the same <em class="parameter"><code>attr_type</code></em>
1229
already exists.
1230
</p>
1231
<div class="variablelist"><table border="0">
1232
<col align="left" valign="top">
1233
<tbody>
1234
<tr>
1235
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1236
<td>the builder</td>
1237
</tr>
1238
<tr>
1239
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1240
<td>the new attribute type</td>
1241
</tr>
1242
</tbody>
1243
</table></div>
1244
</div>
1245
<hr>
1246
<div class="refsect2">
1247
<a name="gck-builder-set-invalid"></a><h3>gck_builder_set_invalid ()</h3>
1248
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_set_invalid (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1249
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
1250
<p>
1251
Set an attribute on the builder that is invalid in the PKCS#11 sense.
1252
If an attribute with <em class="parameter"><code>attr_type</code></em> already exists in the builder then it is
1253
changed to the new value, otherwise an attribute is added.
1254
</p>
1255
<div class="variablelist"><table border="0">
1256
<col align="left" valign="top">
1257
<tbody>
1258
<tr>
1259
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1260
<td>the builder</td>
1261
</tr>
1262
<tr>
1263
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1264
<td>the attribute type</td>
1265
</tr>
1266
</tbody>
1267
</table></div>
1268
</div>
1269
<hr>
1270
<div class="refsect2">
1271
<a name="gck-builder-add-attribute"></a><h3>gck_builder_add_attribute ()</h3>
1272
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_attribute (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1273
<em class="parameter"><code>const <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="type">GckAttribute</span></a> *attr</code></em>);</pre>
1274
<p>
1275
Add an attribute to the builder. The attribute is added unconditionally whether
1276
or not an attribute with the same type already exists on the builder.
1277
</p>
1278
<p>
1279
The <em class="parameter"><code>attr</code></em> attribute must have been created or owned by the Gck library.
1280
If you call this function on an arbitrary <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="type">GckAttribute</span></a> that is allocated on
1281
the stack or elsewhere, then this will result in undefined behavior.
1282
</p>
1283
<p>
1284
As an optimization, the attribute memory value is automatically shared
1285
between the attribute and the builder.
1286
</p>
1287
<div class="variablelist"><table border="0">
1288
<col align="left" valign="top">
1289
<tbody>
1290
<tr>
1291
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1292
<td>the builder</td>
1293
</tr>
1294
<tr>
1295
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
1296
<td>the attribute to add</td>
1297
</tr>
1298
</tbody>
1299
</table></div>
1300
</div>
1301
<hr>
1302
<div class="refsect2">
1303
<a name="gck-builder-add-all"></a><h3>gck_builder_add_all ()</h3>
1304
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_all (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1305
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
1306
<p>
1307
Add all the <em class="parameter"><code>attrs</code></em> attributes to the builder. The attributes are added
1308
uncondititionally whether or not attributes with the same types already
1309
exist in the builder.
1310
</p>
1311
<p>
1312
As an optimization, the attribute memory values are automatically shared
1313
between the attributes and the builder.
1314
</p>
1315
<div class="variablelist"><table border="0">
1316
<col align="left" valign="top">
1317
<tbody>
1318
<tr>
1319
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1320
<td>the builder</td>
1321
</tr>
1322
<tr>
1323
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
1324
<td>the attributes to add</td>
1325
</tr>
1326
</tbody>
1327
</table></div>
1328
</div>
1329
<hr>
1330
<div class="refsect2">
1331
<a name="gck-builder-set-all"></a><h3>gck_builder_set_all ()</h3>
1332
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_set_all (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1333
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
1334
<p>
1335
Set all the <em class="parameter"><code>attrs</code></em> attributes to the builder. If any attributes with the
1336
same types are already present in the builder, then those attributes are
1337
changed to the new values.
1338
</p>
1339
<p>
1340
As an optimization, the attribute memory values are automatically shared
1341
between the attributes and the builder.
1342
</p>
1343
<div class="variablelist"><table border="0">
1344
<col align="left" valign="top">
1345
<tbody>
1346
<tr>
1347
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1348
<td>the builder</td>
1349
</tr>
1350
<tr>
1351
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
1352
<td>the attributes to set</td>
1353
</tr>
1354
</tbody>
1355
</table></div>
1356
</div>
1357
<hr>
1358
<div class="refsect2">
1359
<a name="gck-builder-add-except"></a><h3>gck_builder_add_except ()</h3>
1360
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_except (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1361
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
1362
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> except_type</code></em>,
1363
<em class="parameter"><code>...</code></em>);</pre>
1364
<p>
1365
Add the attributes in <em class="parameter"><code>attrs</code></em> to the builder, with the exception of those
1366
in the argument list. The attributes are added uncondititionally whether or
1367
not attributes with the same types already exist in the builder.
1368
</p>
1369
<p>
1370
The variable arguments must be unsigned longs.
1371
</p>
1372
<p>
1373
</p>
1374
<div class="informalexample">
1375
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1376
<tbody>
1377
<tr>
1378
<td class="listing_lines" align="right"><pre>1
1379
2</pre></td>
1380
<td class="listing_code"><pre class="programlisting"><span class="comment">/* Add all attributes in attrs except CKA_CLASS to the builder */</span>
1381
<span class="function"><a href="GckAttributes.html#gck-builder-add-except">gck_builder_add_except</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">,</span><span class="normal"> attrs</span><span class="symbol">,</span><span class="normal"> CKA_CLASS</span><span class="symbol">,</span><span class="normal"> <a href="gck-Miscellaneous-Functions.html#GCK-INVALID:CAPS">GCK_INVALID</a></span><span class="symbol">);</span></pre></td>
1382
</tr>
1383
</tbody>
1384
</table>
1385
</div>
1386
1387
<p>
1388
</p>
1389
<p>
1390
As an optimization, the attribute memory values are automatically shared
1391
between the attributes and the builder.
1392
</p>
1393
<div class="variablelist"><table border="0">
1394
<col align="left" valign="top">
1395
<tbody>
1396
<tr>
1397
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1398
<td>the builder</td>
1399
</tr>
1400
<tr>
1401
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
1402
<td>the attributes to add</td>
1403
</tr>
1404
<tr>
1405
<td><p><span class="term"><em class="parameter"><code>except_type</code></em> :</span></p></td>
1406
<td>the first type of attribute to to exclude</td>
1407
</tr>
1408
<tr>
1409
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1410
<td>the remaining attribute types to exclude, ending with <a class="link" href="gck-Miscellaneous-Functions.html#GCK-INVALID:CAPS" title="GCK_INVALID"><code class="literal">GCK_INVALID</code></a>
1411
</td>
1412
</tr>
1413
</tbody>
1414
</table></div>
1415
</div>
1416
<hr>
1417
<div class="refsect2">
1418
<a name="gck-builder-add-exceptv"></a><h3>gck_builder_add_exceptv ()</h3>
1419
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_exceptv (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1420
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
1421
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *except_types</code></em>,
1422
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_except_types</code></em>);</pre>
1423
<p>
1424
Add the attributes in <em class="parameter"><code>attrs</code></em> to the builder, with the exception of those
1425
whose types are specified in <em class="parameter"><code>except_types</code></em>. The attributes are added
1426
uncondititionally whether or not attributes with the same types already
1427
exist in the builder.
1428
</p>
1429
<p>
1430
</p>
1431
<div class="informalexample">
1432
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1433
<tbody>
1434
<tr>
1435
<td class="listing_lines" align="right"><pre>1
1436
2
1437
3</pre></td>
1438
<td class="listing_code"><pre class="programlisting"><span class="comment">/* Add all attributes in attrs except CKA_CLASS to the builder */</span>
1439
<span class="usertype">gulong</span><span class="normal"> except_types</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> CKA_CLASS </span><span class="cbracket">}</span><span class="symbol">;</span>
1440
<span class="function"><a href="GckAttributes.html#gck-builder-add-exceptv">gck_builder_add_exceptv</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">,</span><span class="normal"> attrs</span><span class="symbol">,</span><span class="normal"> except_types</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span></pre></td>
1441
</tr>
1442
</tbody>
1443
</table>
1444
</div>
1445
1446
<p>
1447
</p>
1448
<p>
1449
As an optimization, the attribute memory values are automatically shared
1450
between the attributes and the builder.
1451
</p>
1452
<div class="variablelist"><table border="0">
1453
<col align="left" valign="top">
1454
<tbody>
1455
<tr>
1456
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1457
<td>the builder</td>
1458
</tr>
1459
<tr>
1460
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
1461
<td>the attributes to add</td>
1462
</tr>
1463
<tr>
1464
<td><p><span class="term"><em class="parameter"><code>except_types</code></em> :</span></p></td>
1465
<td>the except types. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_except_types]</span>
1466
</td>
1467
</tr>
1468
<tr>
1469
<td><p><span class="term"><em class="parameter"><code>n_except_types</code></em> :</span></p></td>
1470
<td>the number of except types</td>
1471
</tr>
1472
</tbody>
1473
</table></div>
1474
</div>
1475
<hr>
1476
<div class="refsect2">
1477
<a name="gck-builder-add-only"></a><h3>gck_builder_add_only ()</h3>
1478
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_only (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1479
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
1480
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> only_type</code></em>,
1481
<em class="parameter"><code>...</code></em>);</pre>
1482
<p>
1483
Add the attributes specified in the argument list from <em class="parameter"><code>attrs</code></em> to the
1484
builder. The attributes are added uncondititionally whether or not
1485
attributes with the same types already exist in the builder.
1486
</p>
1487
<p>
1488
The variable arguments must be unsigned longs.
1489
</p>
1490
<p>
1491
</p>
1492
<div class="informalexample">
1493
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1494
<tbody>
1495
<tr>
1496
<td class="listing_lines" align="right"><pre>1
1497
2</pre></td>
1498
<td class="listing_code"><pre class="programlisting"><span class="comment">/* Add the CKA_ID and CKA_CLASS attributes from attrs to builder */</span>
1499
<span class="function"><a href="GckAttributes.html#gck-builder-add-only">gck_builder_add_only</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">,</span><span class="normal"> attrs</span><span class="symbol">,</span><span class="normal"> CKA_ID</span><span class="symbol">,</span><span class="normal"> CKA_CLASS</span><span class="symbol">,</span><span class="normal"> <a href="gck-Miscellaneous-Functions.html#GCK-INVALID:CAPS">GCK_INVALID</a></span><span class="symbol">);</span></pre></td>
1500
</tr>
1501
</tbody>
1502
</table>
1503
</div>
1504
1505
<p>
1506
</p>
1507
<p>
1508
As an optimization, the attribute memory values are automatically shared
1509
between the attributes and the builder.
1510
</p>
1511
<div class="variablelist"><table border="0">
1512
<col align="left" valign="top">
1513
<tbody>
1514
<tr>
1515
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1516
<td>the builder</td>
1517
</tr>
1518
<tr>
1519
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
1520
<td>the attributes to add</td>
1521
</tr>
1522
<tr>
1523
<td><p><span class="term"><em class="parameter"><code>only_type</code></em> :</span></p></td>
1524
<td>the first type of attribute to add</td>
1525
</tr>
1526
<tr>
1527
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1528
<td>the remaining attribute types to add, ending with <a class="link" href="gck-Miscellaneous-Functions.html#GCK-INVALID:CAPS" title="GCK_INVALID"><code class="literal">GCK_INVALID</code></a>
1529
</td>
1530
</tr>
1531
</tbody>
1532
</table></div>
1533
</div>
1534
<hr>
1535
<div class="refsect2">
1536
<a name="gck-builder-add-onlyv"></a><h3>gck_builder_add_onlyv ()</h3>
1537
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_add_onlyv (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1538
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
1539
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *only_types</code></em>,
1540
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_only_types</code></em>);</pre>
1541
<p>
1542
Add the attributes with the types in <em class="parameter"><code>only_types</code></em> from <em class="parameter"><code>attrs</code></em> to the
1543
builder. The attributes are added uncondititionally whether or not
1544
attributes with the same types already exist in the builder.
1545
</p>
1546
<p>
1547
</p>
1548
<div class="informalexample">
1549
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1550
<tbody>
1551
<tr>
1552
<td class="listing_lines" align="right"><pre>1
1553
2
1554
3</pre></td>
1555
<td class="listing_code"><pre class="programlisting"><span class="comment">/* Add the CKA_ID and CKA_CLASS attributes from attrs to builder */</span>
1556
<span class="usertype">gulong</span><span class="normal"> only</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> CKA_ID</span><span class="symbol">,</span><span class="normal"> CKA_CLASS </span><span class="cbracket">}</span><span class="symbol">;</span>
1557
<span class="function"><a href="GckAttributes.html#gck-builder-add-onlyv">gck_builder_add_onlyv</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">builder</span><span class="symbol">,</span><span class="normal"> attrs</span><span class="symbol">,</span><span class="normal"> only</span><span class="symbol">,</span><span class="normal"> </span><span class="number">2</span><span class="symbol">);</span></pre></td>
1558
</tr>
1559
</tbody>
1560
</table>
1561
</div>
1562
1563
<p>
1564
</p>
1565
<p>
1566
As an optimization, the attribute memory values are automatically shared
1567
between the attributes and the builder.
1568
</p>
1569
<p>
1570
Rename to: gck_builder_add_only
1571
</p>
1572
<div class="variablelist"><table border="0">
1573
<col align="left" valign="top">
1574
<tbody>
1575
<tr>
1576
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1577
<td>the builder</td>
1578
</tr>
1579
<tr>
1580
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
1581
<td>the attributes to add</td>
1582
</tr>
1583
<tr>
1584
<td><p><span class="term"><em class="parameter"><code>only_types</code></em> :</span></p></td>
1585
<td>the types of attributes to add. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_only_types]</span>
1586
</td>
1587
</tr>
1588
<tr>
1589
<td><p><span class="term"><em class="parameter"><code>n_only_types</code></em> :</span></p></td>
1590
<td>the number of attributes</td>
1591
</tr>
1592
</tbody>
1593
</table></div>
1594
</div>
1595
<hr>
1596
<div class="refsect2">
1597
<a name="gck-builder-end"></a><h3>gck_builder_end ()</h3>
1598
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_builder_end (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);</pre>
1599
<p>
1600
Complete the <a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a>, and return the attributes contained in the builder.
1601
The <a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> will be cleared after this function call, and it is no
1602
longer necessary to use <a class="link" href="GckAttributes.html#gck-builder-clear" title="gck_builder_clear ()"><code class="function">gck_builder_clear()</code></a> on it, although it is also
1603
permitted. The builder may be used again to build another set of attributes
1604
after this function call.
1605
</p>
1606
<p>
1607
The returned set of attributes is floating, and should either be passed to
1608
another gck library function which consumes this floating reference, or if
1609
you wish to keep these attributes around you should ref them with
1610
<a class="link" href="GckAttributes.html#gck-attributes-ref-sink" title="gck_attributes_ref_sink ()"><code class="function">gck_attributes_ref_sink()</code></a> and unref them later with <a class="link" href="GckAttributes.html#gck-attributes-unref" title="gck_attributes_unref ()"><code class="function">gck_attributes_unref()</code></a>.
1611
</p>
1612
<div class="variablelist"><table border="0">
1613
<col align="left" valign="top">
1614
<tbody>
1615
<tr>
1616
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1617
<td>the builder</td>
1618
</tr>
1619
<tr>
1620
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1621
<td>a floating reference to the attributes created
1622
in the builder. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1623
</td>
1624
</tr>
1625
</tbody>
1626
</table></div>
1627
</div>
1628
<hr>
1629
<div class="refsect2">
1630
<a name="gck-builder-clear"></a><h3>gck_builder_clear ()</h3>
1631
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_clear (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);</pre>
1632
<p>
1633
Clear the builder and release all allocated memory. The builder may be used
1634
again to build another set of attributes after this function call.
1635
</p>
1636
<p>
1637
If memory is shared between this builder and other attributes, then that
1638
memory is only freed when both of them are cleared or unreferenced.
1639
</p>
1640
<div class="variablelist"><table border="0">
1641
<col align="left" valign="top">
1642
<tbody><tr>
1643
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1644
<td>the builder</td>
1645
</tr></tbody>
1646
</table></div>
1647
</div>
1648
<hr>
1649
<div class="refsect2">
1650
<a name="gck-builder-steal"></a><h3>gck_builder_steal ()</h3>
1651
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_builder_steal (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);</pre>
1652
<p>
1653
Take the attributes that have been built in the <a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a>. The builder
1654
will no longer contain any attributes after this function call.
1655
</p>
1656
<p>
1657
The returned set of attributes is a full reference, not floating.
1658
</p>
1659
<div class="variablelist"><table border="0">
1660
<col align="left" valign="top">
1661
<tbody>
1662
<tr>
1663
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1664
<td>the builder</td>
1665
</tr>
1666
<tr>
1667
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1668
<td>the stolen attributes, which should be freed with
1669
<a class="link" href="GckAttributes.html#gck-attributes-unref" title="gck_attributes_unref ()"><code class="function">gck_attributes_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1670
</td>
1671
</tr>
1672
</tbody>
1673
</table></div>
1674
</div>
1675
<hr>
1676
<div class="refsect2">
1677
<a name="gck-builder-ref"></a><h3>gck_builder_ref ()</h3>
1678
<pre class="programlisting"><a class="link" href="GckAttributes.html#GckBuilder"><span class="returnvalue">GckBuilder</span></a> * gck_builder_ref (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);</pre>
1679
<p>
1680
Add a reference to a builder that was created with <a class="link" href="GckAttributes.html#gck-builder-new" title="gck_builder_new ()"><code class="function">gck_builder_new()</code></a>. The
1681
builder must later be unreferenced again with <a class="link" href="GckAttributes.html#gck-builder-unref" title="gck_builder_unref ()"><code class="function">gck_builder_unref()</code></a>.
1682
</p>
1683
<p>
1684
It is an error to use this function on builders that were allocated on the
1685
stack.
1686
</p>
1687
<div class="variablelist"><table border="0">
1688
<col align="left" valign="top">
1689
<tbody>
1690
<tr>
1691
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1692
<td>the builder</td>
1693
</tr>
1694
<tr>
1695
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1696
<td>the builder</td>
1697
</tr>
1698
</tbody>
1699
</table></div>
1700
</div>
1701
<hr>
1702
<div class="refsect2">
1703
<a name="gck-builder-unref"></a><h3>gck_builder_unref ()</h3>
1704
<pre class="programlisting"><span class="returnvalue">void</span> gck_builder_unref (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> builder</code></em>);</pre>
1705
<p>
1706
Unreferences a builder. If this was the last reference then the builder
1707
is freed.
1708
</p>
1709
<p>
1710
It is an error to use this function on builders that were allocated on the
1711
stack.
1712
</p>
1713
<div class="variablelist"><table border="0">
1714
<col align="left" valign="top">
1715
<tbody><tr>
1716
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1717
<td>the builder</td>
1718
</tr></tbody>
1719
</table></div>
1720
</div>
1721
<hr>
1722
<div class="refsect2">
1723
<a name="gck-builder-copy"></a><h3>gck_builder_copy ()</h3>
1724
<pre class="programlisting"><a class="link" href="GckAttributes.html#GckBuilder"><span class="returnvalue">GckBuilder</span></a> * gck_builder_copy (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>);</pre>
1725
<p>
1726
Make a copy of the builder and its state. The new builder is allocated
1727
with <a class="link" href="GckAttributes.html#gck-builder-new" title="gck_builder_new ()"><code class="function">gck_builder_new()</code></a> and should be freed with <a class="link" href="GckAttributes.html#gck-builder-unref" title="gck_builder_unref ()"><code class="function">gck_builder_unref()</code></a>.
1728
</p>
1729
<p>
1730
Attribute value memory is automatically shared between the two builders,
1731
and is only freed when both are gone.
1732
</p>
1733
<div class="variablelist"><table border="0">
1734
<col align="left" valign="top">
1735
<tbody>
1736
<tr>
1737
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1738
<td>the builder to copy</td>
1739
</tr>
1740
<tr>
1741
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1742
<td>the builder copy, which should be freed with
1743
<a class="link" href="GckAttributes.html#gck-builder-unref" title="gck_builder_unref ()"><code class="function">gck_builder_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1744
</td>
1745
</tr>
1746
</tbody>
1747
</table></div>
1748
</div>
1749
<hr>
1750
<div class="refsect2">
1751
<a name="gck-builder-find"></a><h3>gck_builder_find ()</h3>
1752
<pre class="programlisting">const <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_builder_find (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1753
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
1754
<p>
1755
Find an attribute in the builder. Both valid and invalid attributes (in
1756
the PKCS#11 sense) are returned. If multiple attributes exist for the given
1757
attribute type, then the first one is returned.
1758
</p>
1759
<p>
1760
The returned <a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="type">GckAttribute</span></a> is owned by the builder and may not be modified
1761
in any way. It is only valid until another attribute is added to or set on
1762
the builder, or until the builder is cleared or unreferenced.
1763
</p>
1764
<div class="variablelist"><table border="0">
1765
<col align="left" valign="top">
1766
<tbody>
1767
<tr>
1768
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1769
<td>the builder</td>
1770
</tr>
1771
<tr>
1772
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1773
<td>the type of attribute to find</td>
1774
</tr>
1775
<tr>
1776
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1777
<td>the attribute or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not found</td>
1778
</tr>
1779
</tbody>
1780
</table></div>
1781
</div>
1782
<hr>
1783
<div class="refsect2">
1784
<a name="gck-builder-find-boolean"></a><h3>gck_builder_find_boolean ()</h3>
1785
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_builder_find_boolean (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1786
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
1787
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);</pre>
1788
<p>
1789
Find a boolean attribute in the builder that has the type <em class="parameter"><code>attr_type</code></em>, is
1790
of the correct boolean size, and is not invalid in the PKCS#11 sense.
1791
If multiple attributes exist for the given attribute type, then the first\
1792
one is returned.
1793
</p>
1794
<div class="variablelist"><table border="0">
1795
<col align="left" valign="top">
1796
<tbody>
1797
<tr>
1798
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1799
<td>the builder</td>
1800
</tr>
1801
<tr>
1802
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1803
<td>the type of attribute to find</td>
1804
</tr>
1805
<tr>
1806
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1807
<td>the location to place the found value. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1808
</td>
1809
</tr>
1810
<tr>
1811
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1812
<td>whether a valid boolean attribute was found</td>
1813
</tr>
1814
</tbody>
1815
</table></div>
1816
</div>
1817
<hr>
1818
<div class="refsect2">
1819
<a name="gck-builder-find-date"></a><h3>gck_builder_find_date ()</h3>
1820
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_builder_find_date (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1821
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
1822
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);</pre>
1823
<p>
1824
Find a date attribute in the builder that has the type <em class="parameter"><code>attr_type</code></em>, is of
1825
the correct date size, and is not invalid in the PKCS#11 sense.
1826
If multiple attributes exist for the given attribute type, then the first
1827
one is returned.
1828
</p>
1829
<div class="variablelist"><table border="0">
1830
<col align="left" valign="top">
1831
<tbody>
1832
<tr>
1833
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1834
<td>the builder</td>
1835
</tr>
1836
<tr>
1837
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1838
<td>the type of attribute to find</td>
1839
</tr>
1840
<tr>
1841
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1842
<td>the location to place the found value. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1843
</td>
1844
</tr>
1845
<tr>
1846
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1847
<td>whether a valid date attribute was found</td>
1848
</tr>
1849
</tbody>
1850
</table></div>
1851
</div>
1852
<hr>
1853
<div class="refsect2">
1854
<a name="gck-builder-find-string"></a><h3>gck_builder_find_string ()</h3>
1855
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_builder_find_string (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1856
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
1857
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>);</pre>
1858
<p>
1859
Find a string attribute in the builder that has the type <em class="parameter"><code>attr_type</code></em>, has a
1860
non <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value pointer, and is not invalid in the PKCS#11 sense.
1861
If multiple attributes exist for the given attribute type, then the first
1862
one is returned.
1863
</p>
1864
<div class="variablelist"><table border="0">
1865
<col align="left" valign="top">
1866
<tbody>
1867
<tr>
1868
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1869
<td>the builder</td>
1870
</tr>
1871
<tr>
1872
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1873
<td>the type of attribute to find</td>
1874
</tr>
1875
<tr>
1876
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1877
<td>the location to place the found value. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1878
</td>
1879
</tr>
1880
<tr>
1881
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1882
<td>whether a valid string attribute was found</td>
1883
</tr>
1884
</tbody>
1885
</table></div>
1886
</div>
1887
<hr>
1888
<div class="refsect2">
1889
<a name="gck-builder-find-ulong"></a><h3>gck_builder_find_ulong ()</h3>
1890
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_builder_find_ulong (<em class="parameter"><code><a class="link" href="GckAttributes.html#GckBuilder"><span class="type">GckBuilder</span></a> *builder</code></em>,
1891
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
1892
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *value</code></em>);</pre>
1893
<p>
1894
Find a unsigned long attribute in the builder that has the type <em class="parameter"><code>attr_type</code></em>,
1895
is of the correct unsigned long size, and is not invalid in the PKCS#11 sense.
1896
If multiple attributes exist for the given attribute type, then the first\
1897
one is returned.
1898
</p>
1899
<div class="variablelist"><table border="0">
1900
<col align="left" valign="top">
1901
<tbody>
1902
<tr>
1903
<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
1904
<td>the builder</td>
1905
</tr>
1906
<tr>
1907
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
1908
<td>the type of attribute to find</td>
1909
</tr>
1910
<tr>
1911
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1912
<td>the location to place the found value. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1913
</td>
1914
</tr>
1915
<tr>
1916
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1917
<td>whether a valid unsigned long attribute was found</td>
1918
</tr>
1919
</tbody>
1920
</table></div>
1921
</div>
1922
<hr>
1923
<div class="refsect2">
1924
<a name="gck-attributes-new"></a><h3>gck_attributes_new ()</h3>
1925
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_attributes_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> reserved</code></em>);</pre>
1926
<p>
1927
Create a new empty GckAttributes array.
1928
</p>
1929
<p>
1930
The returned set of attributes is floating, and should either be passed to
1931
another gck library function which consumes this floating reference, or if
1932
you wish to keep these attributes around you should ref them with
1933
<a class="link" href="GckAttributes.html#gck-attributes-ref-sink" title="gck_attributes_ref_sink ()"><code class="function">gck_attributes_ref_sink()</code></a> and unref them later with <a class="link" href="GckAttributes.html#gck-attributes-unref" title="gck_attributes_unref ()"><code class="function">gck_attributes_unref()</code></a>.
1934
</p>
1935
<div class="variablelist"><table border="0">
1936
<col align="left" valign="top">
1937
<tbody>
1938
<tr>
1939
<td><p><span class="term"><em class="parameter"><code>reserved</code></em> :</span></p></td>
1940
<td>Should be set to always be GCK_INVALID</td>
1941
</tr>
1942
<tr>
1943
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1944
<td>a floating reference to the new attributes array;
1945
when done with the array release it with <a class="link" href="GckAttributes.html#gck-attributes-unref" title="gck_attributes_unref ()"><code class="function">gck_attributes_unref()</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1946
</td>
1947
</tr>
1948
</tbody>
1949
</table></div>
1950
</div>
1951
<hr>
1952
<div class="refsect2">
1953
<a name="gck-attributes-add"></a><h3>gck_attributes_add ()</h3>
1954
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
1955
<em class="parameter"><code><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="type">GckAttribute</span></a> *attr</code></em>);</pre>
1956
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1957
<h3 class="title">Warning</h3>
1958
<p><code class="literal">gck_attributes_add</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-set-all" title="gck_builder_set_all ()"><code class="function">gck_builder_set_all()</code></a> instead.</p>
1959
</div>
1960
<p>
1961
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
1962
</p>
1963
<div class="variablelist"><table border="0">
1964
<col align="left" valign="top">
1965
<tbody>
1966
<tr>
1967
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
1968
<td>the attributes array to add to</td>
1969
</tr>
1970
<tr>
1971
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
1972
<td>the attribute to add</td>
1973
</tr>
1974
<tr>
1975
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1976
<td>returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1977
</td>
1978
</tr>
1979
</tbody>
1980
</table></div>
1981
</div>
1982
<hr>
1983
<div class="refsect2">
1984
<a name="gck-attributes-add-all"></a><h3>gck_attributes_add_all ()</h3>
1985
<pre class="programlisting"><span class="returnvalue">void</span> gck_attributes_add_all (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
1986
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *from</code></em>);</pre>
1987
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1988
<h3 class="title">Warning</h3>
1989
<p><code class="literal">gck_attributes_add_all</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-add-all" title="gck_builder_add_all ()"><code class="function">gck_builder_add_all()</code></a> instead.</p>
1990
</div>
1991
<p>
1992
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
1993
</p>
1994
<div class="variablelist"><table border="0">
1995
<col align="left" valign="top">
1996
<tbody>
1997
<tr>
1998
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
1999
<td>a set of attributes</td>
2000
</tr>
2001
<tr>
2002
<td><p><span class="term"><em class="parameter"><code>from</code></em> :</span></p></td>
2003
<td>attributes to add</td>
2004
</tr>
2005
</tbody>
2006
</table></div>
2007
</div>
2008
<hr>
2009
<div class="refsect2">
2010
<a name="gck-attributes-add-boolean"></a><h3>gck_attributes_add_boolean ()</h3>
2011
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_boolean (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2012
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
2013
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);</pre>
2014
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2015
<h3 class="title">Warning</h3>
2016
<p><code class="literal">gck_attributes_add_boolean</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-add-boolean" title="gck_builder_add_boolean ()"><code class="function">gck_builder_add_boolean()</code></a> instead.</p>
2017
</div>
2018
<p>
2019
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2020
</p>
2021
<div class="variablelist"><table border="0">
2022
<col align="left" valign="top">
2023
<tbody>
2024
<tr>
2025
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2026
<td>the attributes array to add to</td>
2027
</tr>
2028
<tr>
2029
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2030
<td>the type of attribute to add</td>
2031
</tr>
2032
<tr>
2033
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2034
<td>the boolean value to add</td>
2035
</tr>
2036
<tr>
2037
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2038
<td>returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2039
</td>
2040
</tr>
2041
</tbody>
2042
</table></div>
2043
</div>
2044
<hr>
2045
<div class="refsect2">
2046
<a name="gck-attributes-add-data"></a><h3>gck_attributes_add_data ()</h3>
2047
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_data (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2048
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
2049
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *value</code></em>,
2050
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
2051
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2052
<h3 class="title">Warning</h3>
2053
<p><code class="literal">gck_attributes_add_data</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-add-data" title="gck_builder_add_data ()"><code class="function">gck_builder_add_data()</code></a> instead.</p>
2054
</div>
2055
<p>
2056
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2057
</p>
2058
<div class="variablelist"><table border="0">
2059
<col align="left" valign="top">
2060
<tbody>
2061
<tr>
2062
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2063
<td>The attributes array to add to.</td>
2064
</tr>
2065
<tr>
2066
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2067
<td>The type of attribute to add.</td>
2068
</tr>
2069
<tr>
2070
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2071
<td>the raw memory of the attribute value. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
2072
</td>
2073
</tr>
2074
<tr>
2075
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
2076
<td>The length of the attribute value.</td>
2077
</tr>
2078
<tr>
2079
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2080
<td>returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2081
</td>
2082
</tr>
2083
</tbody>
2084
</table></div>
2085
</div>
2086
<hr>
2087
<div class="refsect2">
2088
<a name="gck-attributes-add-date"></a><h3>gck_attributes_add_date ()</h3>
2089
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_date (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2090
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
2091
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);</pre>
2092
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2093
<h3 class="title">Warning</h3>
2094
<p><code class="literal">gck_attributes_add_date</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-add-date" title="gck_builder_add_date ()"><code class="function">gck_builder_add_date()</code></a> instead.</p>
2095
</div>
2096
<p>
2097
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2098
</p>
2099
<div class="variablelist"><table border="0">
2100
<col align="left" valign="top">
2101
<tbody>
2102
<tr>
2103
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2104
<td>the attributes array to add to</td>
2105
</tr>
2106
<tr>
2107
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2108
<td>the type of attribute to add</td>
2109
</tr>
2110
<tr>
2111
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2112
<td>the GDate value to add</td>
2113
</tr>
2114
<tr>
2115
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2116
<td>returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2117
</td>
2118
</tr>
2119
</tbody>
2120
</table></div>
2121
</div>
2122
<hr>
2123
<div class="refsect2">
2124
<a name="gck-attributes-add-empty"></a><h3>gck_attributes_add_empty ()</h3>
2125
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_empty (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2126
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
2127
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2128
<h3 class="title">Warning</h3>
2129
<p><code class="literal">gck_attributes_add_empty</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-add-empty" title="gck_builder_add_empty ()"><code class="function">gck_builder_add_empty()</code></a> instead.</p>
2130
</div>
2131
<p>
2132
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2133
</p>
2134
<div class="variablelist"><table border="0">
2135
<col align="left" valign="top">
2136
<tbody>
2137
<tr>
2138
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2139
<td>The attributes array to add.</td>
2140
</tr>
2141
<tr>
2142
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2143
<td>The type of attribute to add.</td>
2144
</tr>
2145
<tr>
2146
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2147
<td>returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2148
</td>
2149
</tr>
2150
</tbody>
2151
</table></div>
2152
</div>
2153
<hr>
2154
<div class="refsect2">
2155
<a name="gck-attributes-add-invalid"></a><h3>gck_attributes_add_invalid ()</h3>
2156
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_invalid (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2157
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
2158
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2159
<h3 class="title">Warning</h3>
2160
<p><code class="literal">gck_attributes_add_invalid</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-add-invalid" title="gck_builder_add_invalid ()"><code class="function">gck_builder_add_invalid()</code></a> instead</p>
2161
</div>
2162
<p>
2163
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2164
</p>
2165
<div class="variablelist"><table border="0">
2166
<col align="left" valign="top">
2167
<tbody>
2168
<tr>
2169
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2170
<td>The attributes array to add to.</td>
2171
</tr>
2172
<tr>
2173
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2174
<td>The type of attribute to add.</td>
2175
</tr>
2176
<tr>
2177
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2178
<td>returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2179
</td>
2180
</tr>
2181
</tbody>
2182
</table></div>
2183
</div>
2184
<hr>
2185
<div class="refsect2">
2186
<a name="gck-attributes-add-string"></a><h3>gck_attributes_add_string ()</h3>
2187
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_string (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2188
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
2189
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
2190
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2191
<h3 class="title">Warning</h3>
2192
<p><code class="literal">gck_attributes_add_string</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-add-string" title="gck_builder_add_string ()"><code class="function">gck_builder_add_string()</code></a> instead.</p>
2193
</div>
2194
<p>
2195
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2196
</p>
2197
<div class="variablelist"><table border="0">
2198
<col align="left" valign="top">
2199
<tbody>
2200
<tr>
2201
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2202
<td>the attributes array to add to</td>
2203
</tr>
2204
<tr>
2205
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2206
<td>the type of attribute to add</td>
2207
</tr>
2208
<tr>
2209
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2210
<td>the null terminated string value to add</td>
2211
</tr>
2212
<tr>
2213
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2214
<td>returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2215
</td>
2216
</tr>
2217
</tbody>
2218
</table></div>
2219
</div>
2220
<hr>
2221
<div class="refsect2">
2222
<a name="gck-attributes-add-ulong"></a><h3>gck_attributes_add_ulong ()</h3>
2223
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_ulong (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2224
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
2225
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);</pre>
2226
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2227
<h3 class="title">Warning</h3>
2228
<p><code class="literal">gck_attributes_add_ulong</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-add-ulong" title="gck_builder_add_ulong ()"><code class="function">gck_builder_add_ulong()</code></a> instead.</p>
2229
</div>
2230
<p>
2231
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2232
</p>
2233
<div class="variablelist"><table border="0">
2234
<col align="left" valign="top">
2235
<tbody>
2236
<tr>
2237
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2238
<td>the attributes array to add to</td>
2239
</tr>
2240
<tr>
2241
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2242
<td>the type of attribute to add</td>
2243
</tr>
2244
<tr>
2245
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2246
<td>the gulong value to add</td>
2247
</tr>
2248
<tr>
2249
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2250
<td>returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2251
</td>
2252
</tr>
2253
</tbody>
2254
</table></div>
2255
</div>
2256
<hr>
2257
<div class="refsect2">
2258
<a name="gck-attributes-dup"></a><h3>gck_attributes_dup ()</h3>
2259
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_attributes_dup (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
2260
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2261
<h3 class="title">Warning</h3>
2262
<p><code class="literal">gck_attributes_dup</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-attributes-ref" title="gck_attributes_ref ()"><code class="function">gck_attributes_ref()</code></a> or <a class="link" href="GckAttributes.html#gck-builder-add-all" title="gck_builder_add_all ()"><code class="function">gck_builder_add_all()</code></a> instead.</p>
2263
</div>
2264
<p>
2265
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable, and can be used in mulitple places.
2266
</p>
2267
<div class="variablelist"><table border="0">
2268
<col align="left" valign="top">
2269
<tbody>
2270
<tr>
2271
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2272
<td>set of attributes to copy</td>
2273
</tr>
2274
<tr>
2275
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2276
<td>a new floating <a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2277
</td>
2278
</tr>
2279
</tbody>
2280
</table></div>
2281
</div>
2282
<hr>
2283
<div class="refsect2">
2284
<a name="gck-attributes-new-full"></a><h3>gck_attributes_new_full ()</h3>
2285
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_attributes_new_full (<em class="parameter"><code><span class="type">GckAllocator</span> allocator</code></em>);</pre>
2286
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2287
<h3 class="title">Warning</h3>
2288
<p><code class="literal">gck_attributes_new_full</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-set-all" title="gck_builder_set_all ()"><code class="function">gck_builder_set_all()</code></a> instead.</p>
2289
</div>
2290
<p>
2291
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2292
</p>
2293
<div class="variablelist"><table border="0">
2294
<col align="left" valign="top">
2295
<tbody>
2296
<tr>
2297
<td><p><span class="term"><em class="parameter"><code>allocator</code></em> :</span></p></td>
2298
<td>memory allocator for attribute data, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for default</td>
2299
</tr>
2300
<tr>
2301
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2302
<td>returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2303
</td>
2304
</tr>
2305
</tbody>
2306
</table></div>
2307
</div>
2308
<hr>
2309
<div class="refsect2">
2310
<a name="gck-attributes-set"></a><h3>gck_attributes_set ()</h3>
2311
<pre class="programlisting"><span class="returnvalue">void</span> gck_attributes_set (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2312
<em class="parameter"><code><a class="link" href="gck-GckAttribute.html#GckAttribute" title="struct GckAttribute"><span class="type">GckAttribute</span></a> *attr</code></em>);</pre>
2313
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2314
<h3 class="title">Warning</h3>
2315
<p><code class="literal">gck_attributes_set</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-set-data" title="gck_builder_set_data ()"><code class="function">gck_builder_set_data()</code></a> instead.</p>
2316
</div>
2317
<p>
2318
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2319
</p>
2320
<div class="variablelist"><table border="0">
2321
<col align="left" valign="top">
2322
<tbody>
2323
<tr>
2324
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2325
<td>attributes array to add to</td>
2326
</tr>
2327
<tr>
2328
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
2329
<td>attribute to set</td>
2330
</tr>
2331
</tbody>
2332
</table></div>
2333
</div>
2334
<hr>
2335
<div class="refsect2">
2336
<a name="gck-attributes-set-all"></a><h3>gck_attributes_set_all ()</h3>
2337
<pre class="programlisting"><span class="returnvalue">void</span> gck_attributes_set_all (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2338
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *from</code></em>);</pre>
2339
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2340
<h3 class="title">Warning</h3>
2341
<p><code class="literal">gck_attributes_set_all</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-set-all" title="gck_builder_set_all ()"><code class="function">gck_builder_set_all()</code></a> instead.</p>
2342
</div>
2343
<p>
2344
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2345
</p>
2346
<div class="variablelist"><table border="0">
2347
<col align="left" valign="top">
2348
<tbody>
2349
<tr>
2350
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2351
<td>set of attributes</td>
2352
</tr>
2353
<tr>
2354
<td><p><span class="term"><em class="parameter"><code>from</code></em> :</span></p></td>
2355
<td>attributes to add</td>
2356
</tr>
2357
</tbody>
2358
</table></div>
2359
</div>
2360
<hr>
2361
<div class="refsect2">
2362
<a name="gck-attributes-set-boolean"></a><h3>gck_attributes_set_boolean ()</h3>
2363
<pre class="programlisting"><span class="returnvalue">void</span> gck_attributes_set_boolean (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2364
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
2365
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);</pre>
2366
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2367
<h3 class="title">Warning</h3>
2368
<p><code class="literal">gck_attributes_set_boolean</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-set-boolean" title="gck_builder_set_boolean ()"><code class="function">gck_builder_set_boolean()</code></a> instead.</p>
2369
</div>
2370
<p>
2371
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2372
</p>
2373
<div class="variablelist"><table border="0">
2374
<col align="left" valign="top">
2375
<tbody>
2376
<tr>
2377
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2378
<td>the attributes</td>
2379
</tr>
2380
<tr>
2381
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2382
<td>the type of attribute to set</td>
2383
</tr>
2384
<tr>
2385
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2386
<td>boolean value to set</td>
2387
</tr>
2388
</tbody>
2389
</table></div>
2390
</div>
2391
<hr>
2392
<div class="refsect2">
2393
<a name="gck-attributes-set-date"></a><h3>gck_attributes_set_date ()</h3>
2394
<pre class="programlisting"><span class="returnvalue">void</span> gck_attributes_set_date (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2395
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
2396
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);</pre>
2397
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2398
<h3 class="title">Warning</h3>
2399
<p><code class="literal">gck_attributes_set_date</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-set-date" title="gck_builder_set_date ()"><code class="function">gck_builder_set_date()</code></a> instead.</p>
2400
</div>
2401
<p>
2402
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2403
</p>
2404
<div class="variablelist"><table border="0">
2405
<col align="left" valign="top">
2406
<tbody>
2407
<tr>
2408
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2409
<td>the attributes</td>
2410
</tr>
2411
<tr>
2412
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2413
<td>the type of attribute to set</td>
2414
</tr>
2415
<tr>
2416
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2417
<td>date value to set</td>
2418
</tr>
2419
</tbody>
2420
</table></div>
2421
</div>
2422
<hr>
2423
<div class="refsect2">
2424
<a name="gck-attributes-set-string"></a><h3>gck_attributes_set_string ()</h3>
2425
<pre class="programlisting"><span class="returnvalue">void</span> gck_attributes_set_string (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2426
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
2427
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
2428
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2429
<h3 class="title">Warning</h3>
2430
<p><code class="literal">gck_attributes_set_string</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-set-string" title="gck_builder_set_string ()"><code class="function">gck_builder_set_string()</code></a> instead.</p>
2431
</div>
2432
<p>
2433
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2434
</p>
2435
<div class="variablelist"><table border="0">
2436
<col align="left" valign="top">
2437
<tbody>
2438
<tr>
2439
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2440
<td>the attributes</td>
2441
</tr>
2442
<tr>
2443
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2444
<td>the type of attribute to set</td>
2445
</tr>
2446
<tr>
2447
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2448
<td>null terminated string value to set</td>
2449
</tr>
2450
</tbody>
2451
</table></div>
2452
</div>
2453
<hr>
2454
<div class="refsect2">
2455
<a name="gck-attributes-set-ulong"></a><h3>gck_attributes_set_ulong ()</h3>
2456
<pre class="programlisting"><span class="returnvalue">void</span> gck_attributes_set_ulong (<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
2457
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
2458
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);</pre>
2459
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2460
<h3 class="title">Warning</h3>
2461
<p><code class="literal">gck_attributes_set_ulong</code> has been deprecated since version 3.4 and should not be used in newly-written code. Use <a class="link" href="GckAttributes.html#gck-builder-set-ulong" title="gck_builder_set_ulong ()"><code class="function">gck_builder_set_ulong()</code></a> instead.</p>
2462
</div>
2463
<p>
2464
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> are now immutable. This method no longer does anything.
2465
</p>
2466
<div class="variablelist"><table border="0">
2467
<col align="left" valign="top">
2468
<tbody>
2469
<tr>
2470
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
2471
<td>the attributes</td>
2472
</tr>
2473
<tr>
2474
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
2475
<td>the type of attribute to set</td>
2476
</tr>
2477
<tr>
2478
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2479
<td>gulong value to set</td>
2480
</tr>
2481
</tbody>
2482
</table></div>
2483
</div>
2484
</div>
2485
</div>
2486
<div class="footer">
2487
<hr>
2488
Generated by GTK-Doc V1.18</div>
2489
</body>
2490
</html>
b'\\ No newline at end of file'
Loggerhead is a web-based interface for Breezy
Version: 2.0.1