Blame doc/functions/gnutls_x509_crt_set_issuer_dn_by_oid

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_x509_crt_set_issuer_dn_by_oid} (gnutls_x509_crt_t @var{crt}, const char * @var{oid}, unsigned int @var{raw_flag}, const void * @var{name}, unsigned int @var{sizeof_name})
Packit Service 4684c1
@var{crt}: a certificate of type @code{gnutls_x509_crt_t} 
Packit Service 4684c1
Packit Service 4684c1
@var{oid}: holds an Object Identifier in a null terminated string
Packit Service 4684c1
Packit Service 4684c1
@var{raw_flag}: must be 0, or 1 if the data are DER encoded
Packit Service 4684c1
Packit Service 4684c1
@var{name}: a pointer to the name
Packit Service 4684c1
Packit Service 4684c1
@var{sizeof_name}: holds the size of  @code{name} 
Packit Service 4684c1
Packit Service 4684c1
This function will set the part of the name of the Certificate
Packit Service 4684c1
issuer, specified by the given OID.  The input string should be
Packit Service 4684c1
ASCII or UTF-8 encoded.
Packit Service 4684c1
Packit Service 4684c1
Some helper macros with popular OIDs can be found in gnutls/x509.h
Packit Service 4684c1
With this function you can only set the known OIDs. You can test
Packit Service 4684c1
for known OIDs using @code{gnutls_x509_dn_oid_known()} . For OIDs that are
Packit Service 4684c1
not known (by gnutls) you should properly DER encode your data,
Packit Service 4684c1
and call this function with  @code{raw_flag} set.
Packit Service 4684c1
Packit Service 4684c1
Normally you do not need to call this function, since the signing
Packit Service 4684c1
operation will copy the signer's name as the issuer of the
Packit Service 4684c1
certificate.
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
Packit Service 4684c1
negative error value.
Packit Service 4684c1
@end deftypefun