SMIME_write_CMS(3) Convertir une structure CMS au format S/MIME

SYNOPSIS

#include <openssl/cms.h>

int SMIME_write_CMS(BIO *out, CMS_ContentInfo *cms, BIO *data, int flags);

DESCRIPTION

SMIME_write_CMS() ajoute les en-têtes MIME appropriés à une structure CMS pour produire un message S/MIME.

out est le BIO où écrire les données. cms est la structure CMS_ContentInfo appropriée. Si le flux est activé, alors le contenu doit être fourni dans l'argument data. flags est un jeu d'attributs facultatif.

NOTES

Les attributs suivants peuvent être passés dans le paramètre flags.

Si CMS_DETACHED est défini, alors la signature en texte clair sera utilisée. Cette option n'a de sens que pour SignedData, où CMS_DETACHED est aussi défini quand CMS_sign() est appelée.

Si l'attribut CMS_TEXT est défini, les en-têtes MIME pour le type text/plain sont ajoutés au contenu. Cela n'a de sens que si CMS_DETACHED est aussi défini.

Si l'attribut CMS_STREAM est défini, un flux est réalisé. Cet attribut ne devrait être défini que si CMS_STREAM était aussi défini dans l'appel précédent d'une fonction de création de CMS_ContentInfo.

Si la signature en texte clair est utilisée et que CMS_STREAM n'est pas défini, alors les données doivent être lues deux fois : une fois pour calculer la signature dans CMS_sign(), et une fois pour afficher le message S/MIME.

Si un flux est réalisé, le contenu est affiché au format BER en utilisant un encodage construit de taille indéfinie, sauf dans le cas de données signées avec contenu détaché où le contenu est absent et alors le format DER est utilisé.

BOGUES

SMIME_write_CMS() encode toujours en base64 les structures CMS, il devrait y avoir une option permettant de désactiver cela.

VALEURS DE RETOUR

SMIME_write_CMS() renvoie 1 en cas de réussite et 0 en cas d'échec.

HISTORIQUE

SMIME_write_CMS() a été ajoutée dans OpenSSL 0.9.8

TRADUCTION

La traduction de cette page de manuel est maintenue par les membres de la liste <debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr-extra.