pskc_init ()

int
pskc_init (pskc_t **container);

This function initializes the PSKC container handle. The memory allocate can be released by calling pskc_done().

pskc_done ()

void
pskc_done (pskc_t *container);

This function releases the resources associated with the PSKC container handle.

pskc_parse_from_memory ()

int
pskc_parse_from_memory (pskc_t *container,
                        size_t len,
                        const char *buffer);

This function will parse the XML data in buffer of len size into container . If PSKC_PARSE_ERROR is returned, parsing of some elements have failed but the container is still valid and contain partially parsed information. In this situation, you may continue but raise a warning.

pskc_get_signed_p ()

int
pskc_get_signed_p (pskc_t *container);

Check whether the container is signed or not (note that it does not validate the signature, merely checks whether there is one).

pskc_validate ()

int
pskc_validate (pskc_t *container,
               int *isvalid);

This function validate the PSKC container handle the PSKC XML Schema.

pskc_build_xml ()

int
pskc_build_xml (pskc_t *container,
                char **out,
                size_t *len);

This function builds a XML file from the data in container . As a convenience, it also converts the XML into a string placed in the newly allocated *out of length len using pskc_output() with PSKC_OUTPUT_XML.

pskc_sign_x509 ()

int
pskc_sign_x509 (pskc_t *container,
                const char *key_file,
                const char *cert_file);

Sign PSKC data using X.509 certificate and private key.

pskc_verify_x509crt ()

int
pskc_verify_x509crt (pskc_t *container,
                     const char *cert_file,
                     int *valid_signature);

Verify signature in PSKC data against trusted X.509 certificate.

pskc_get_version ()

const char *
pskc_get_version (pskc_t *container);

Get the PSKC KeyContainer Version attribute. Normally this string is always "1.0" and a missing field is a syntax error according to the PSKC schema.

pskc_set_version ()

void
pskc_set_version (pskc_t *container,
                  const char *version);

Set the PSKC KeyContainer Version attribute. Normally this string is always "1.0" and a missing field is a syntax error according to the PSKC schema.

The pointer is stored in container , not a copy of the data, so you must not deallocate the data before another call to this function or the last call to any function using container .

Since 2.2.0

pskc_get_id ()

const char *
pskc_get_id (pskc_t *container);

Get the PSKC KeyContainer Id attribute.

pskc_set_id ()

void
pskc_set_id (pskc_t *container,
             const char *id);

Set the PSKC KeyContainer Id attribute.

The pointer is stored in container , not a copy of the data, so you must not deallocate the data before another call to this function or the last call to any function using container .

Since 2.2.0

pskc_get_keypackage ()

pskc_key_t *
pskc_get_keypackage (pskc_t *container,
                     size_t i);

Get a PSKC keypackage pskc_key_t handle for the i 'th key package in container . i is zero-based, i.e., 0 refer to the first key package, 1 refer to the second key package, and so on.

pskc_add_keypackage ()

int
pskc_add_keypackage (pskc_t *container,
                     pskc_key_t **key);

Add a new a PSKC keypackage to the container and give back a pskc_key_t handle.

Since 2.2.0

pskc_output ()

int
pskc_output (pskc_t *container,
             pskc_output_formats_t format,
             char **out,
             size_t *len);

Convert PSKC data to a serialized string of the indicated type. This is usually used to convert the PSKC data to some human readable form.

enum pskc_output_formats_t

Enumeration of different PSKC output formats.