From: Simon Josefsson Date: Sun, 6 Feb 2005 14:13:39 +0000 (+0000) Subject: Doc fix. X-Git-Tag: gnutls_1_2_1~73 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=0fa6dc21e87feeed2fdcd4e4fa587403bab2f34f;p=thirdparty%2Fgnutls.git Doc fix. --- diff --git a/lib/x509/crq.c b/lib/x509/crq.c index 5d81d62077..c35fbe832c 100644 --- a/lib/x509/crq.c +++ b/lib/x509/crq.c @@ -672,22 +672,25 @@ int gnutls_x509_crq_sign(gnutls_x509_crq_t crq, gnutls_x509_privkey_t key) } /** - * gnutls_x509_crq_export - This function will export the generated certificate request + * gnutls_x509_crq_export - This function will export the + * generated certificate request * @crq: Holds the request * @format: the format of output params. One of PEM or DER. * @output_data: will contain a certificate request PEM or DER encoded - * @output_data_size: holds the size of output_data (and will be replaced by the actual size of parameters) + * @output_data_size: holds the size of output_data (and will be + * replaced by the actual size of parameters) * * This function will export the certificate request to a PKCS10 * * If the buffer provided is not long enough to hold the output, then - * GNUTLS_E_SHORT_MEMORY_BUFFER will be returned and &output_data_size will be updated. + * GNUTLS_E_SHORT_MEMORY_BUFFER will be returned and + * *output_data_size will be updated. * - * If the structure is PEM encoded, it will have a header - * of "BEGIN NEW CERTIFICATE REQUEST". + * If the structure is PEM encoded, it will have a header of "BEGIN + * NEW CERTIFICATE REQUEST". * - * In case of failure a negative value will be returned, and - * 0 on success. + * Return value: In case of failure a negative value will be + * returned, and 0 on success. * **/ int gnutls_x509_crq_export(gnutls_x509_crq_t crq, diff --git a/lib/x509/dn.c b/lib/x509/dn.c index 7bd8ec82c7..552753f74b 100644 --- a/lib/x509/dn.c +++ b/lib/x509/dn.c @@ -889,13 +889,13 @@ int _gnutls_x509_set_dn_oid(ASN1_TYPE asn1_struct, * @buf: a pointer to a structure to hold the peer's name * @sizeof_buf: holds the size of @buf * - * This function will return the name of the given RDN sequence. - * The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described - * in RFC2253. + * This function will return the name of the given RDN sequence. The + * name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in + * RFC2253. * - * If the provided buffer is not long enough, returns GNUTLS_E_SHORT_MEMORY_BUFFER - * and &sizeof_buf will be updated. - * On success 0 is returned. + * If the provided buffer is not long enough, returns + * GNUTLS_E_SHORT_MEMORY_BUFFER and *sizeof_buf will be updated. On + * success 0 is returned. * **/ int gnutls_x509_rdn_get(const gnutls_datum_t * idn, @@ -939,17 +939,18 @@ int gnutls_x509_rdn_get(const gnutls_datum_t * idn, * gnutls_x509_rdn_get_by_oid - This function parses an RDN sequence and returns a string * @idn: should contain a DER encoded RDN sequence * @oid: an Object Identifier - * @indx: In case multiple same OIDs exist in the RDN indicates which to send. Use 0 for the first one. + * @indx: In case multiple same OIDs exist in the RDN indicates which + * to send. Use 0 for the first one. * @raw_flag: If non zero then the raw DER data are returned. * @buf: a pointer to a structure to hold the peer's name * @sizeof_buf: holds the size of @buf * - * This function will return the name of the given Object identifier, - * of the RDN sequence. - * The name will be encoded using the rules from RFC2253. + * This function will return the name of the given Object identifier, + * of the RDN sequence. The name will be encoded using the rules + * from RFC2253. * - * Returns GNUTLS_E_SHORT_MEMORY_BUFFER and updates &sizeof_buf if the provided buffer is not long enough, - * and 0 on success. + * Returns GNUTLS_E_SHORT_MEMORY_BUFFER and updates *sizeof_buf if + * the provided buffer is not long enough, and 0 on success. * **/ int gnutls_x509_rdn_get_by_oid(const gnutls_datum_t * idn, const char *oid, @@ -994,11 +995,11 @@ int gnutls_x509_rdn_get_by_oid(const gnutls_datum_t * idn, const char *oid, * @oid: a pointer to a structure to hold the peer's name OID * @sizeof_oid: holds the size of @oid * - * This function will return the specified Object identifier, - * of the RDN sequence. + * This function will return the specified Object identifier, of the + * RDN sequence. * - * Returns GNUTLS_E_SHORT_MEMORY_BUFFER and updates &sizeof_buf if the provided buffer is not long enough, - * and 0 on success. + * Returns GNUTLS_E_SHORT_MEMORY_BUFFER and updates *sizeof_buf if + * the provided buffer is not long enough, and 0 on success. * **/ int gnutls_x509_rdn_get_oid(const gnutls_datum_t * idn, diff --git a/lib/x509/pkcs12.c b/lib/x509/pkcs12.c index 6fcb18dc9d..4620ae5a78 100644 --- a/lib/x509/pkcs12.c +++ b/lib/x509/pkcs12.c @@ -237,18 +237,20 @@ int gnutls_pkcs12_import(gnutls_pkcs12_t pkcs12, * @pkcs12: Holds the pkcs12 structure * @format: the format of output params. One of PEM or DER. * @output_data: will contain a structure PEM or DER encoded - * @output_data_size: holds the size of output_data (and will be replaced by the actual size of parameters) + * @output_data_size: holds the size of output_data (and will be + * replaced by the actual size of parameters) * * This function will export the pkcs12 structure to DER or PEM format. * * If the buffer provided is not long enough to hold the output, then - * &output_data_size will be updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. + * *output_data_size will be updated and GNUTLS_E_SHORT_MEMORY_BUFFER + * will be returned. * * If the structure is PEM encoded, it will have a header * of "BEGIN PKCS12". * - * In case of failure a negative value will be returned, and - * 0 on success. + * Return value: In case of failure a negative value will be + * returned, and 0 on success. * **/ int gnutls_pkcs12_export(gnutls_pkcs12_t pkcs12, diff --git a/lib/x509/pkcs7.c b/lib/x509/pkcs7.c index 3d01faedf7..29c8d1dd96 100644 --- a/lib/x509/pkcs7.c +++ b/lib/x509/pkcs7.c @@ -389,18 +389,20 @@ int gnutls_pkcs7_get_crt_count(gnutls_pkcs7_t pkcs7) * @pkcs7: Holds the pkcs7 structure * @format: the format of output params. One of PEM or DER. * @output_data: will contain a structure PEM or DER encoded - * @output_data_size: holds the size of output_data (and will be replaced by the actual size of parameters) + * @output_data_size: holds the size of output_data (and will be + * replaced by the actual size of parameters) * * This function will export the pkcs7 structure to DER or PEM format. * * If the buffer provided is not long enough to hold the output, then - * &output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. + * *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will + * be returned. * * If the structure is PEM encoded, it will have a header * of "BEGIN PKCS7". * - * In case of failure a negative value will be returned, and - * 0 on success. + * Return value: In case of failure a negative value will be + * returned, and 0 on success. * **/ int gnutls_pkcs7_export(gnutls_pkcs7_t pkcs7, diff --git a/lib/x509/privkey.c b/lib/x509/privkey.c index 3725cf4623..4774fc31b5 100644 --- a/lib/x509/privkey.c +++ b/lib/x509/privkey.c @@ -621,20 +621,22 @@ int gnutls_x509_privkey_get_pk_algorithm(gnutls_x509_privkey_t key) * @key: Holds the key * @format: the format of output params. One of PEM or DER. * @output_data: will contain a private key PEM or DER encoded - * @output_data_size: holds the size of output_data (and will be replaced by the actual size of parameters) + * @output_data_size: holds the size of output_data (and will be + * replaced by the actual size of parameters) * - * This function will export the private key to a PKCS1 structure for RSA keys, - * or an integer sequence for DSA keys. The DSA keys are in the same format - * with the parameters used by openssl. + * This function will export the private key to a PKCS1 structure for + * RSA keys, or an integer sequence for DSA keys. The DSA keys are in + * the same format with the parameters used by openssl. * * If the buffer provided is not long enough to hold the output, then - * &output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. + * *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will + * be returned. * * If the structure is PEM encoded, it will have a header * of "BEGIN RSA PRIVATE KEY". * - * In case of failure a negative value will be returned, and - * 0 on success. + * Return value: In case of failure a negative value will be + * returned, and 0 on success. * **/ int gnutls_x509_privkey_export(gnutls_x509_privkey_t key, @@ -1245,22 +1247,25 @@ int gnutls_x509_privkey_generate(gnutls_x509_privkey_t key, } /** - * gnutls_x509_privkey_get_key_id - This function will return a unique ID of the key's parameters + * gnutls_x509_privkey_get_key_id - This function will return a unique ID + * of the key's parameters * @key: Holds the key * @flags: should be 0 for now * @output_data: will contain the key ID - * @output_data_size: holds the size of output_data (and will be replaced by the actual size of parameters) + * @output_data_size: holds the size of output_data (and will be + * replaced by the actual size of parameters) * * This function will return a unique ID the depends on the public key * parameters. This ID can be used in checking whether a certificate * corresponds to the given key. * * If the buffer provided is not long enough to hold the output, then - * &output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. The output will normally - * be a SHA-1 hash output, which is 20 bytes. + * *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will + * be returned. The output will normally be a SHA-1 hash output, + * which is 20 bytes. * - * In case of failure a negative value will be returned, and - * 0 on success. + * Return value: In case of failure a negative value will be + * returned, and 0 on success. * **/ int gnutls_x509_privkey_get_key_id(gnutls_x509_privkey_t key, @@ -1331,15 +1336,17 @@ int gnutls_x509_privkey_get_key_id(gnutls_x509_privkey_t key, * @flags: should be 0 for now * @data: holds the data to be signed * @signature: will contain the signature - * @signature_size: holds the size of signature (and will be replaced by the new size) + * @signature_size: holds the size of signature (and will be replaced + * by the new size) * - * This function will sign the given data using a signature algorithm supported by - * the private key. Signature algorithms are always used together with a hash functions. - * Different hash functions may be used for the RSA algorithm, but only - * SHA-1 for the DSA keys. + * This function will sign the given data using a signature algorithm + * supported by the private key. Signature algorithms are always used + * together with a hash functions. Different hash functions may be + * used for the RSA algorithm, but only SHA-1 for the DSA keys. * * If the buffer provided is not long enough to hold the output, then - * &signature_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. + * *signature_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will + * be returned. * * In case of failure a negative value will be returned, and * 0 on success. diff --git a/lib/x509/privkey_pkcs8.c b/lib/x509/privkey_pkcs8.c index 8e571d3202..a42478e2d2 100644 --- a/lib/x509/privkey_pkcs8.c +++ b/lib/x509/privkey_pkcs8.c @@ -381,7 +381,8 @@ int encode_to_pkcs8_key(schema_id schema, const gnutls_datum_t * der_key, * @password: the password that will be used to encrypt the key. * @flags: an ORed sequence of gnutls_pkcs_encrypt_flags_t * @output_data: will contain a private key PEM or DER encoded - * @output_data_size: holds the size of output_data (and will be replaced by the actual size of parameters) + * @output_data_size: holds the size of output_data (and will be + * replaced by the actual size of parameters) * * This function will export the private key to a PKCS8 structure. * Currently only RSA keys can be exported since there is no documented @@ -393,14 +394,15 @@ int encode_to_pkcs8_key(schema_id schema, const gnutls_datum_t * der_key, * encryption schemas, or ASCII for the PKCS12 schemas. * * If the buffer provided is not long enough to hold the output, then - * &output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. + * *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will + * be returned. * * If the structure is PEM encoded, it will have a header * of "BEGIN ENCRYPTED PRIVATE KEY" or "BEGIN PRIVATE KEY" if * encryption is not used. * - * In case of failure a negative value will be returned, and - * 0 on success. + * Return value: In case of failure a negative value will be + * returned, and 0 on success. * **/ int gnutls_x509_privkey_export_pkcs8(gnutls_x509_privkey_t key, diff --git a/lib/x509/x509.c b/lib/x509/x509.c index 1fbe15e14d..aff8709cd5 100644 --- a/lib/x509/x509.c +++ b/lib/x509/x509.c @@ -228,15 +228,16 @@ int gnutls_x509_crt_import(gnutls_x509_crt_t cert, * @buf: a pointer to a structure to hold the name (may be null) * @sizeof_buf: initially holds the size of @buf * - * This function will copy the name of the Certificate issuer in the provided buffer. The name - * will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output - * string will be ASCII or UTF-8 encoded, depending on the certificate data. + * This function will copy the name of the Certificate issuer in the + * provided buffer. The name will be in the form + * "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string + * will be ASCII or UTF-8 encoded, depending on the certificate data. * * If @buf is null then only the size will be filled. * - * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and - * in that case the &sizeof_buf will be updated with the required size. - * On success 0 is returned. + * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not + * long enough, and in that case the *sizeof_buf will be updated with + * the required size. On success 0 is returned. * **/ int gnutls_x509_crt_get_issuer_dn(gnutls_x509_crt_t cert, char *buf, @@ -261,20 +262,22 @@ int gnutls_x509_crt_get_issuer_dn(gnutls_x509_crt_t cert, char *buf, * @buf: a pointer to a structure to hold the name (may be null) * @sizeof_buf: initially holds the size of @buf * - * This function will extract the part of the name of the Certificate issuer specified - * by the given OID. The output will be encoded as described in RFC2253. The output - * string will be ASCII or UTF-8 encoded, depending on the certificate data. + * This function will extract the part of the name of the Certificate + * issuer specified by the given OID. The output will be encoded as + * described in RFC2253. The output string will be ASCII or UTF-8 + * encoded, depending on the certificate data. * * Some helper macros with popular OIDs can be found in gnutls/x509.h - * If raw flag is zero, this function will only return known OIDs as text. Other OIDs - * will be DER encoded, as described in RFC2253 -- in hex format with a '\#' prefix. - * You can check about known OIDs using gnutls_x509_dn_oid_known(). + * If raw flag is zero, this function will only return known OIDs as + * text. Other OIDs will be DER encoded, as described in RFC2253 -- + * in hex format with a '\#' prefix. You can check about known OIDs + * using gnutls_x509_dn_oid_known(). * * If @buf is null then only the size will be filled. * - * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and - * in that case the &sizeof_buf will be updated with the required size. - * On success 0 is returned. + * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not + * long enough, and in that case the *sizeof_buf will be updated with + * the required size. On success 0 is returned. * **/ int gnutls_x509_crt_get_issuer_dn_by_oid(gnutls_x509_crt_t cert, @@ -299,14 +302,14 @@ int gnutls_x509_crt_get_issuer_dn_by_oid(gnutls_x509_crt_t cert, * @oid: a pointer to a buffer to hold the OID (may be null) * @sizeof_oid: initially holds the size of @oid * - * This function will extract the OIDs of the name of the Certificate issuer specified - * by the given index. + * This function will extract the OIDs of the name of the Certificate + * issuer specified by the given index. * * If @oid is null then only the size will be filled. * - * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and - * in that case the &sizeof_oid will be updated with the required size. - * On success 0 is returned. + * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not + * long enough, and in that case the *sizeof_oid will be updated with + * the required size. On success 0 is returned. * **/ int gnutls_x509_crt_get_issuer_dn_oid(gnutls_x509_crt_t cert, @@ -329,15 +332,16 @@ int gnutls_x509_crt_get_issuer_dn_oid(gnutls_x509_crt_t cert, * @buf: a pointer to a structure to hold the name (may be null) * @sizeof_buf: initially holds the size of @buf * - * This function will copy the name of the Certificate in the provided buffer. The name - * will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output - * string will be ASCII or UTF-8 encoded, depending on the certificate data. + * This function will copy the name of the Certificate in the + * provided buffer. The name will be in the form + * "C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string + * will be ASCII or UTF-8 encoded, depending on the certificate data. * * If @buf is null then only the size will be filled. * - * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and - * in that case the &sizeof_buf will be updated with the required size. - * On success 0 is returned. + * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not + * long enough, and in that case the *sizeof_buf will be updated with + * the required size. On success 0 is returned. * **/ int gnutls_x509_crt_get_dn(gnutls_x509_crt_t cert, char *buf, @@ -362,20 +366,21 @@ int gnutls_x509_crt_get_dn(gnutls_x509_crt_t cert, char *buf, * @buf: a pointer to a structure to hold the name (may be null) * @sizeof_buf: initially holds the size of @buf * - * This function will extract the part of the name of the Certificate subject, specified - * by the given OID. The output - * string will be ASCII or UTF-8 encoded, depending on the certificate data. + * This function will extract the part of the name of the Certificate + * subject, specified by the given OID. The output string will be + * ASCII or UTF-8 encoded, depending on the certificate data. * * Some helper macros with popular OIDs can be found in gnutls/x509.h - * If raw flag is zero, this function will only return known OIDs as text. Other OIDs - * will be DER encoded, as described in RFC2253 -- in hex format with a '\#' prefix. - * You can check about known OIDs using gnutls_x509_dn_oid_known(). + * If raw flag is zero, this function will only return known OIDs as + * text. Other OIDs will be DER encoded, as described in RFC2253 -- + * in hex format with a '\#' prefix. You can check about known OIDs + * using gnutls_x509_dn_oid_known(). * * If @buf is null then only the size will be filled. * - * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and - * in that case the &sizeof_buf will be updated with the required size. - * On success 0 is returned. + * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not + * long enough, and in that case the *sizeof_buf will be updated with + * the required size. On success 0 is returned. * **/ int gnutls_x509_crt_get_dn_by_oid(gnutls_x509_crt_t cert, const char *oid, @@ -399,14 +404,14 @@ int gnutls_x509_crt_get_dn_by_oid(gnutls_x509_crt_t cert, const char *oid, * @oid: a pointer to a buffer to hold the OID (may be null) * @sizeof_oid: initially holds the size of @oid * - * This function will extract the OIDs of the name of the Certificate subject specified - * by the given index. + * This function will extract the OIDs of the name of the Certificate + * subject specified by the given index. * * If oid is null then only the size will be filled. * - * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and - * in that case the &sizeof_oid will be updated with the required size. - * On success 0 is returned. + * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not + * long enough, and in that case the *sizeof_oid will be updated with + * the required size. On success 0 is returned. * **/ int gnutls_x509_crt_get_dn_oid(gnutls_x509_crt_t cert, @@ -1227,9 +1232,9 @@ int _gnutls_x509_crt_get_raw_dn(gnutls_x509_crt_t cert, * * If the buffer is null then only the size will be filled. * - * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and - * in that case the &sizeof_buf will be updated with the required size. - * On success 0 is returned. + * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not + * long enough, and in that case the *sizeof_buf will be updated with + * the required size. On success 0 is returned. * **/ int gnutls_x509_crt_get_fingerprint(gnutls_x509_crt_t cert, @@ -1277,18 +1282,20 @@ int gnutls_x509_crt_get_fingerprint(gnutls_x509_crt_t cert, * @cert: Holds the certificate * @format: the format of output params. One of PEM or DER. * @output_data: will contain a certificate PEM or DER encoded - * @output_data_size: holds the size of output_data (and will be replaced by the actual size of parameters) + * @output_data_size: holds the size of output_data (and will be + * replaced by the actual size of parameters) * * This function will export the certificate to DER or PEM format. * * If the buffer provided is not long enough to hold the output, then - * &output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. + * *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will + * be returned. * * If the structure is PEM encoded, it will have a header * of "BEGIN CERTIFICATE". * - * In case of failure a negative value will be returned, and - * 0 on success. + * Return value: In case of failure a negative value will be + * returned, and 0 on success. * **/ int gnutls_x509_crt_export(gnutls_x509_crt_t cert, @@ -1307,22 +1314,25 @@ int gnutls_x509_crt_export(gnutls_x509_crt_t cert, /** - * gnutls_x509_crt_get_key_id - This function will return a unique ID of the public key's parameters + * gnutls_x509_crt_get_key_id - This function will return a unique ID of + * the public key's parameters * @crt: Holds the certificate * @flags: should be 0 for now * @output_data: will contain the key ID - * @output_data_size: holds the size of output_data (and will be replaced by the actual size of parameters) + * @output_data_size: holds the size of output_data (and will be + * replaced by the actual size of parameters) * * This function will return a unique ID the depends on the public key * parameters. This ID can be used in checking whether a certificate * corresponds to the given private key. * * If the buffer provided is not long enough to hold the output, then - * &output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be returned. - * The output will normally be a SHA-1 hash output, which is 20 bytes. + * *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will + * be returned. The output will normally be a SHA-1 hash output, + * which is 20 bytes. * - * In case of failure a negative value will be returned, and - * 0 on success. + * Return value: In case of failure a negative value will be + * returned, and 0 on success. * **/ int gnutls_x509_crt_get_key_id(gnutls_x509_crt_t crt, unsigned int flags, @@ -1666,15 +1676,16 @@ int gnutls_x509_crt_get_crl_dist_points(gnutls_x509_crt_t cert, * @oid: a pointer to a buffer to hold the OID (may be null) * @sizeof_oid: initially holds the size of @oid * - * This function will extract the key purpose OIDs of the Certificate specified - * by the given index. These are stored in the Extended Key Usage extension (2.5.29.37) - * See the GNUTLS_KP_* definitions for human readable names. + * This function will extract the key purpose OIDs of the Certificate + * specified by the given index. These are stored in the Extended Key + * Usage extension (2.5.29.37) See the GNUTLS_KP_* definitions for + * human readable names. * * If @oid is null then only the size will be filled. * - * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough, and - * in that case the &sizeof_oid will be updated with the required size. - * On success 0 is returned. + * Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not + * long enough, and in that case the *sizeof_oid will be updated with + * the required size. On success 0 is returned. * **/ int gnutls_x509_crt_get_key_purpose_oid(gnutls_x509_crt_t cert,