Blame docs/reference/gck/html/gck-GckAttribute.html

Packit Service f02b19
Packit Service f02b19
<html>
Packit Service f02b19
<head>
Packit Service f02b19
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit Service f02b19
<title>GckAttribute: Gck Library Reference Manual</title>
Packit Service f02b19
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
Packit Service f02b19
<link rel="home" href="index.html" title="Gck Library Reference Manual">
Packit Service f02b19
<link rel="up" href="reference.html" title="PKCS#11 GObject Bindings">
Packit Service f02b19
<link rel="prev" href="GckObject.html" title="GckObject">
Packit Service f02b19
<link rel="next" href="GckAttributes.html" title="GckAttributes">
Packit Service f02b19
<meta name="generator" content="GTK-Doc V1.27.1 (XML mode)">
Packit Service f02b19
<link rel="stylesheet" href="style.css" type="text/css">
Packit Service f02b19
</head>
Packit Service f02b19
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Top  | 
Packit Service f02b19
                  Description
Packit Service f02b19
Packit Service f02b19
Home
Packit Service f02b19
Up
Packit Service f02b19
Prev
Packit Service f02b19
Next
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

GckAttribute

Packit Service f02b19

GckAttribute — A PKCS11 attribute.

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Functions

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gboolean
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_is_invalid ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gboolean
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_get_boolean ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gulong
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_get_ulong ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gchar *
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_get_string ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_get_date ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
const guchar *
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_get_data ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_dump ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gboolean
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_equal ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
guint
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_hash ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_init ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_init_boolean ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_init_date ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_init_string ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_init_ulong ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_init_empty ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_init_invalid ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_init_copy ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
GckAttribute *
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_new ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
GckAttribute *
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_new_boolean ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
GckAttribute *
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_new_date ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
GckAttribute *
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_new_string ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
GckAttribute *
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_new_ulong ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
GckAttribute *
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_new_empty ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
GckAttribute *
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_new_invalid ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
GckAttribute *
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_dup ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_clear ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
void
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
gck_attribute_free ()
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Types and Values

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
struct
Packit Service f02b19
GckAttribute
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Description

Packit Service f02b19

This structure represents a PKCS11 CK_ATTRIBUTE. These attributes contain i

Packit Service f02b19
about a PKCS11 object. Use gck_object_get() or gck_object_set() to set and
Packit Service f02b19
attributes on an object.

Packit Service f02b19

Although you are free to allocate a GckAttribute in your own code, no functions in

Packit Service f02b19
this library will operate on such an attribute.

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Functions

Packit Service f02b19
Packit Service f02b19

gck_attribute_is_invalid ()

Packit Service f02b19
gboolean
Packit Service f02b19
gck_attribute_is_invalid (const GckAttribute *attr);
Packit Service f02b19

Check if the PKCS#11 attribute represents 'invalid' or 'not found'

Packit Service f02b19
according to the PKCS#11 spec. That is, having length
Packit Service f02b19
of (CK_ULONG)-1.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

The attribute to check.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

Whether the attribute represents invalid or not.

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_get_boolean ()

Packit Service f02b19
gboolean
Packit Service f02b19
gck_attribute_get_boolean (const GckAttribute *attr);
Packit Service f02b19

Get the CK_BBOOL of a PKCS#11 attribute. No conversion

Packit Service f02b19
is performed. It is an error to pass an attribute to this
Packit Service f02b19
function unless you're know it's supposed to contain a
Packit Service f02b19
boolean value.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

The attribute to retrieve value from.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

The boolean value of the attribute.

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_get_ulong ()

Packit Service f02b19
gulong
Packit Service f02b19
gck_attribute_get_ulong (const GckAttribute *attr);
Packit Service f02b19

Get the CK_ULONG value of a PKCS#11 attribute. No

Packit Service f02b19
conversion is performed. It is an error to pass an attribute
Packit Service f02b19
to this function unless you're know it's supposed to contain
Packit Service f02b19
a value of the right type.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

The attribute to retrieve value from.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

The ulong value of the attribute.

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_get_string ()

Packit Service f02b19
gchar *
Packit Service f02b19
gck_attribute_get_string (const GckAttribute *attr);
Packit Service f02b19

Get the string value of a PKCS#11 attribute. No

Packit Service f02b19
conversion is performed. It is an error to pass an attribute
Packit Service f02b19
to this function unless you're know it's supposed to contain
Packit Service f02b19
a value of the right type.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

The attribute to retrieve value from.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

a null terminated string, to be freed with

Packit Service f02b19
g_free(), or NULL if the value was invalid. 

Packit Service f02b19

[allow-none]

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_get_date ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_get_date (const GckAttribute *attr,
Packit Service f02b19
                        GDate *value);
Packit Service f02b19

Get the CK_DATE of a PKCS#11 attribute. No

Packit Service f02b19
conversion is performed. It is an error to pass an attribute
Packit Service f02b19
to this function unless you're know it's supposed to contain
Packit Service f02b19
a value of the right type.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

The attribute to retrieve value from.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

The date value to fill in with the parsed date.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_get_data ()

Packit Service f02b19
const guchar *
Packit Service f02b19
gck_attribute_get_data (const GckAttribute *attr,
Packit Service f02b19
                        gsize *length);
Packit Service f02b19

Get the raw value in the attribute.

Packit Service f02b19

This is useful from scripting languages. C callers will generally

Packit Service f02b19
access the GckAttribute struct directly.

Packit Service f02b19

This function will NULL if the attribute contains empty or invalid

Packit Service f02b19
data. The returned data must not be modified and is only valid
Packit Service f02b19
as long as this attribute
Packit Service f02b19
.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

an attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

length

Packit Service f02b19

the length of the returned data

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

the value data or NULL.

Packit Service f02b19

[transfer none][array length=length]

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_dump ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_dump (const GckAttribute *attr);
Packit Service f02b19

Dump the specified attribute using g_printerr().

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

The attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_equal ()

Packit Service f02b19
gboolean
Packit Service f02b19
gck_attribute_equal (gconstpointer attr1,
Packit Service f02b19
                     gconstpointer attr2);
Packit Service f02b19

Compare two attributes. Useful with GHashTable.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr1

Packit Service f02b19

first attribute to compare.

Packit Service f02b19
[type Gck.Attribute]
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr2

Packit Service f02b19

second attribute to compare.

Packit Service f02b19
[type Gck.Attribute]
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

TRUE if the attributes are equal.

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_hash ()

Packit Service f02b19
guint
Packit Service f02b19
gck_attribute_hash (gconstpointer attr);
Packit Service f02b19

Hash an attribute for use in GHashTable keys.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

attribute to hash.

Packit Service f02b19
[type Gck.Attribute]
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

the hash code

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_init ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_init (GckAttribute *attr,
Packit Service f02b19
                    gulong attr_type,
Packit Service f02b19
                    const guchar *value,
Packit Service f02b19
                    gsize length);
Packit Service f02b19

Initialize a PKCS#11 attribute. This copies the value memory

Packit Service f02b19
into an internal buffer.

Packit Service f02b19

When done with the attribute you should use gck_attribute_clear()

Packit Service f02b19
to free the internal memory.

Packit Service f02b19

[skip]

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

an uninitialized attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

The raw value of the attribute.

Packit Service f02b19
[array length=length]
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

length

Packit Service f02b19

The length of the raw value.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_init_boolean ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_init_boolean (GckAttribute *attr,
Packit Service f02b19
                            gulong attr_type,
Packit Service f02b19
                            gboolean value);
Packit Service f02b19

Initialize a PKCS#11 attribute to boolean. This will result

Packit Service f02b19
in a CK_BBOOL attribute from the PKCS#11 specs.

Packit Service f02b19

When done with the attribute you should use gck_attribute_clear()

Packit Service f02b19
to free the internal memory.

Packit Service f02b19

[skip]

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

an uninitialized attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

the boolean value of the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_init_date ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_init_date (GckAttribute *attr,
Packit Service f02b19
                         gulong attr_type,
Packit Service f02b19
                         const GDate *value);
Packit Service f02b19

Initialize a PKCS#11 attribute to a date. This will result

Packit Service f02b19
in a CK_DATE attribute from the PKCS#11 specs.

Packit Service f02b19

When done with the attribute you should use gck_attribute_clear()

Packit Service f02b19
to free the internal memory.

Packit Service f02b19

[skip]

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

an uninitialized attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

the date value of the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_init_string ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_init_string (GckAttribute *attr,
Packit Service f02b19
                           gulong attr_type,
Packit Service f02b19
                           const gchar *value);
Packit Service f02b19

Initialize a PKCS#11 attribute to a string. This will result

Packit Service f02b19
in an attribute containing the text, but not the null terminator.
Packit Service f02b19
The text in the attribute will be of the same encoding as you pass
Packit Service f02b19
to this function.

Packit Service f02b19

When done with the attribute you should use gck_attribute_clear()

Packit Service f02b19
to free the internal memory.

Packit Service f02b19

[skip]

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

an uninitialized attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

the null terminated string value of the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_init_ulong ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_init_ulong (GckAttribute *attr,
Packit Service f02b19
                          gulong attr_type,
Packit Service f02b19
                          gulong value);
Packit Service f02b19

Initialize a PKCS#11 attribute to a unsigned long. This will result

Packit Service f02b19
in a CK_ULONG attribute from the PKCS#11 specs.

Packit Service f02b19

When done with the attribute you should use gck_attribute_clear()

Packit Service f02b19
to free the internal memory.

Packit Service f02b19

[skip]

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

an uninitialized attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

the ulong value of the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_init_empty ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_init_empty (GckAttribute *attr,
Packit Service f02b19
                          gulong attr_type);
Packit Service f02b19

Initialize a PKCS#11 attribute to an empty state. The attribute

Packit Service f02b19
type will be set, but no data will be set.

Packit Service f02b19

When done with the attribute you should use gck_attribute_clear()

Packit Service f02b19
to free the internal memory.

Packit Service f02b19

[skip]

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

an uninitialized attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_init_invalid ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_init_invalid (GckAttribute *attr,
Packit Service f02b19
                            gulong attr_type);
Packit Service f02b19

Initialize a PKCS#11 attribute to an 'invalid' or 'not found'

Packit Service f02b19
state. Specifically this sets the value length to (CK_ULONG)-1
Packit Service f02b19
as specified in the PKCS#11 specification.

Packit Service f02b19

When done with the attribute you should use gck_attribute_clear()

Packit Service f02b19
to free the internal memory.

Packit Service f02b19

[skip]

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

an uninitialized attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_init_copy ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_init_copy (GckAttribute *dest,
Packit Service f02b19
                         const GckAttribute *src);
Packit Service f02b19

Initialize a PKCS#11 attribute as a copy of another attribute.

Packit Service f02b19
This copies the value memory as well.

Packit Service f02b19

When done with the copied attribute you should use

Packit Service f02b19
gck_attribute_clear() to free the internal memory.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

dest

Packit Service f02b19

An uninitialized attribute.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

src

Packit Service f02b19

An attribute to copy.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_new ()

Packit Service f02b19
GckAttribute *
Packit Service f02b19
gck_attribute_new (gulong attr_type,
Packit Service f02b19
                   const guchar *value,
Packit Service f02b19
                   gsize length);
Packit Service f02b19

Create a new PKCS#11 attribute. The value will be copied

Packit Service f02b19
into the new attribute.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

the raw value of the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

length

Packit Service f02b19

the length of the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

the new attribute; when done with the attribute

Packit Service f02b19
use gck_attribute_free() to free it. 

Packit Service f02b19

[transfer full]

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_new_boolean ()

Packit Service f02b19
GckAttribute *
Packit Service f02b19
gck_attribute_new_boolean (gulong attr_type,
Packit Service f02b19
                           gboolean value);
Packit Service f02b19

Initialize a PKCS#11 attribute to boolean. This will result

Packit Service f02b19
in a CK_BBOOL attribute from the PKCS#11 specs.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

the boolean value of the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

the new attribute; when done with the attribute u

Packit Service f02b19
gck_attribute_free() to free it. 

Packit Service f02b19

[transfer full]

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_new_date ()

Packit Service f02b19
GckAttribute *
Packit Service f02b19
gck_attribute_new_date (gulong attr_type,
Packit Service f02b19
                        const GDate *value);
Packit Service f02b19

Initialize a PKCS#11 attribute to a date. This will result

Packit Service f02b19
in a CK_DATE attribute from the PKCS#11 specs.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

the date value of the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

the new attribute; when done with the attribute u

Packit Service f02b19
gck_attribute_free() to free it. 

Packit Service f02b19

[transfer full]

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_new_string ()

Packit Service f02b19
GckAttribute *
Packit Service f02b19
gck_attribute_new_string (gulong attr_type,
Packit Service f02b19
                          const gchar *value);
Packit Service f02b19

Initialize a PKCS#11 attribute to a string. This will result

Packit Service f02b19
in an attribute containing the text, but not the null terminator.
Packit Service f02b19
The text in the attribute will be of the same encoding as you pass
Packit Service f02b19
to this function.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

the null-terminated string value of the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

the new attribute; when done with the attribute u

Packit Service f02b19
gck_attribute_free() to free it. 

Packit Service f02b19

[transfer full]

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_new_ulong ()

Packit Service f02b19
GckAttribute *
Packit Service f02b19
gck_attribute_new_ulong (gulong attr_type,
Packit Service f02b19
                         gulong value);
Packit Service f02b19

Initialize a PKCS#11 attribute to a unsigned long. This will result

Packit Service f02b19
in a CK_ULONG attribute from the PKCS#11 specs.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

value

Packit Service f02b19

the ulong value of the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

the new attribute; when done with the attribute u

Packit Service f02b19
gck_attribute_free() to free it. 

Packit Service f02b19

[transfer full]

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_new_empty ()

Packit Service f02b19
GckAttribute *
Packit Service f02b19
gck_attribute_new_empty (gulong attr_type);
Packit Service f02b19

Create a new PKCS#11 attribute with empty data.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

the new attribute; when done with the attribute

Packit Service f02b19
use gck_attribute_free() to free it. 

Packit Service f02b19

[transfer full]

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_new_invalid ()

Packit Service f02b19
GckAttribute *
Packit Service f02b19
gck_attribute_new_invalid (gulong attr_type);
Packit Service f02b19

Create a new PKCS#11 attribute as 'invalid' or 'not found'

Packit Service f02b19
state. Specifically this sets the value length to (CK_ULONG)-1
Packit Service f02b19
as specified in the PKCS#11 specification.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr_type

Packit Service f02b19

the PKCS#11 attribute type to set on the attribute

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

the new attribute; when done with the attribute

Packit Service f02b19
use gck_attribute_free() to free it. 

Packit Service f02b19

[transfer full]

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_dup ()

Packit Service f02b19
GckAttribute *
Packit Service f02b19
gck_attribute_dup (const GckAttribute *attr);
Packit Service f02b19

Duplicate the PKCS#11 attribute. All value memory is

Packit Service f02b19
also copied.

Packit Service f02b19

The attr

Packit Service f02b19
 must have been allocated or initialized by a Gck function or
Packit Service f02b19
the results of this function are undefined.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

the attribute to duplicate

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Returns

Packit Service f02b19

the duplicated attribute; use gck_attribute_free()

Packit Service f02b19
to free it. 

Packit Service f02b19

[transfer full]

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_clear ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_clear (GckAttribute *attr);
Packit Service f02b19

Clear allocated memory held by a GckAttribute.

Packit Service f02b19

This attribute must have been allocated by a Gck library function, or

Packit Service f02b19
the results of this method are undefined.

Packit Service f02b19

The type of the attribute will remain set.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

Attribute to clear.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Packit Service f02b19
Packit Service f02b19

gck_attribute_free ()

Packit Service f02b19
void
Packit Service f02b19
gck_attribute_free (gpointer attr);
Packit Service f02b19

Free an attribute and its allocated memory. These is usually

Packit Service f02b19
used with attributes that are allocated by gck_attribute_new()
Packit Service f02b19
or a similar function.

Packit Service f02b19
Packit Service f02b19

Parameters

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

attr

Packit Service f02b19

attribute to free.

Packit Service f02b19
[type Gck.Attribute]
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Types and Values

Packit Service f02b19
Packit Service f02b19

struct GckAttribute

Packit Service f02b19
struct GckAttribute {
Packit Service f02b19
	gulong type;
Packit Service f02b19
	guchar *value;
Packit Service f02b19
	gulong length;
Packit Service f02b19
};
Packit Service f02b19
Packit Service f02b19

This structure represents a PKCS11 CK_ATTRIBUTE.

Packit Service f02b19
Packit Service f02b19

Members

Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

gulong type;

Packit Service f02b19

The attribute type, such as CKA_LABEL.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

guchar *value;

Packit Service f02b19

The value of the attribute. May be NULL.

Packit Service f02b19
[array length=length]
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

gulong length;

Packit Service f02b19

The length of the attribute. May be GCK_INVALID if the attribute is invalid.

Packit Service f02b19
 
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19
Packit Service f02b19

Generated by GTK-Doc V1.27.1
Packit Service f02b19
</body>
Packit Service f02b19
</html>