diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-28 07:33:12 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-28 07:33:12 +0000 |
commit | 36082a2fe36ecd800d784ae44c14f1f18c66a7e9 (patch) | |
tree | 6c68e0c0097987aff85a01dabddd34b862309a7c /doc/manpages/gnutls_pkcs7_sign.3 | |
parent | Initial commit. (diff) | |
download | gnutls28-36082a2fe36ecd800d784ae44c14f1f18c66a7e9.tar.xz gnutls28-36082a2fe36ecd800d784ae44c14f1f18c66a7e9.zip |
Adding upstream version 3.7.9.upstream/3.7.9upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'doc/manpages/gnutls_pkcs7_sign.3')
-rw-r--r-- | doc/manpages/gnutls_pkcs7_sign.3 | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/doc/manpages/gnutls_pkcs7_sign.3 b/doc/manpages/gnutls_pkcs7_sign.3 new file mode 100644 index 0000000..0085ec9 --- /dev/null +++ b/doc/manpages/gnutls_pkcs7_sign.3 @@ -0,0 +1,59 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. +.TH "gnutls_pkcs7_sign" 3 "3.7.9" "gnutls" "gnutls" +.SH NAME +gnutls_pkcs7_sign \- API function +.SH SYNOPSIS +.B #include <gnutls/pkcs7.h> +.sp +.BI "int gnutls_pkcs7_sign(gnutls_pkcs7_t " pkcs7 ", gnutls_x509_crt_t " signer ", gnutls_privkey_t " signer_key ", const gnutls_datum_t * " data ", gnutls_pkcs7_attrs_t " signed_attrs ", gnutls_pkcs7_attrs_t " unsigned_attrs ", gnutls_digest_algorithm_t " dig ", unsigned " flags ");" +.SH ARGUMENTS +.IP "gnutls_pkcs7_t pkcs7" 12 +should contain a \fBgnutls_pkcs7_t\fP type +.IP "gnutls_x509_crt_t signer" 12 +the certificate to sign the structure +.IP "gnutls_privkey_t signer_key" 12 +the key to sign the structure +.IP "const gnutls_datum_t * data" 12 +The data to be signed or \fBNULL\fP if the data are already embedded +.IP "gnutls_pkcs7_attrs_t signed_attrs" 12 +Any additional attributes to be included in the signed ones (or \fBNULL\fP) +.IP "gnutls_pkcs7_attrs_t unsigned_attrs" 12 +Any additional attributes to be included in the unsigned ones (or \fBNULL\fP) +.IP "gnutls_digest_algorithm_t dig" 12 +The digest algorithm to use for signing +.IP "unsigned flags" 12 +Should be zero or one of \fBGNUTLS_PKCS7\fP flags +.SH "DESCRIPTION" +This function will add a signature in the provided PKCS \fB7\fP structure +for the provided data. Multiple signatures can be made with different +signers. + +The available flags are: +\fBGNUTLS_PKCS7_EMBED_DATA\fP, \fBGNUTLS_PKCS7_INCLUDE_TIME\fP, \fBGNUTLS_PKCS7_INCLUDE_CERT\fP, +and \fBGNUTLS_PKCS7_WRITE_SPKI\fP. They are explained in the \fBgnutls_pkcs7_sign_flags\fP +definition. +.SH "RETURNS" +On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a +negative error value. +.SH "SINCE" +3.4.2 +.SH "REPORTING BUGS" +Report bugs to <bugs@gnutls.org>. +.br +Home page: https://www.gnutls.org + +.SH COPYRIGHT +Copyright \(co 2001- Free Software Foundation, Inc., and others. +.br +Copying and distribution of this file, with or without modification, +are permitted in any medium without royalty provided the copyright +notice and this notice are preserved. +.SH "SEE ALSO" +The full documentation for +.B gnutls +is maintained as a Texinfo manual. +If the /usr/share/doc/gnutls/ +directory does not contain the HTML form visit +.B +.IP https://www.gnutls.org/manual/ +.PP |