mirror of
https://github.com/yuzu-emu/mbedtls.git
synced 2024-11-23 08:05:37 +01:00
Merge remote-tracking branch 'upstream-public/pr/1984' into mbedtls-2.7
This commit is contained in:
commit
6ef6efbd8e
@ -175,19 +175,34 @@ int mbedtls_x509_crt_parse_der( mbedtls_x509_crt *chain, const unsigned char *bu
|
|||||||
size_t buflen );
|
size_t buflen );
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* \brief Parse one or more certificates and add them
|
* \brief Parse one DER-encoded or one or more concatenated PEM-encoded
|
||||||
* to the chained list. Parses permissively. If some
|
* certificates and add them to the chained list.
|
||||||
* certificates can be parsed, the result is the number
|
|
||||||
* of failed certificates it encountered. If none complete
|
|
||||||
* correctly, the first error is returned.
|
|
||||||
*
|
*
|
||||||
* \param chain points to the start of the chain
|
* For CRTs in PEM encoding, the function parses permissively:
|
||||||
* \param buf buffer holding the certificate data in PEM or DER format
|
* if at least one certificate can be parsed, the function
|
||||||
* \param buflen size of the buffer
|
* returns the number of certificates for which parsing failed
|
||||||
* (including the terminating null byte for PEM data)
|
* (hence \c 0 if all certificates were parsed successfully).
|
||||||
|
* If no certificate could be parsed, the function returns
|
||||||
|
* the first (negative) error encountered during parsing.
|
||||||
|
*
|
||||||
|
* PEM encoded certificates may be interleaved by other data
|
||||||
|
* such as human readable descriptions of their content, as
|
||||||
|
* long as the certificates are enclosed in the PEM specific
|
||||||
|
* '-----{BEGIN/END} CERTIFICATE-----' delimiters.
|
||||||
|
*
|
||||||
|
* \param chain The chain to which to add the parsed certificates.
|
||||||
|
* \param buf The buffer holding the certificate data in PEM or DER format.
|
||||||
|
* For certificates in PEM encoding, this may be a concatenation
|
||||||
|
* of multiple certificates; for DER encoding, the buffer must
|
||||||
|
* comprise exactly one certificate.
|
||||||
|
* \param buflen The size of \p buf, including the terminating \c NULL byte
|
||||||
|
* in case of PEM encoded data.
|
||||||
|
*
|
||||||
|
* \return \c 0 if all certificates were parsed successfully.
|
||||||
|
* \return The (positive) number of certificates that couldn't
|
||||||
|
* be parsed if parsing was partly successful (see above).
|
||||||
|
* \return A negative X509 or PEM error code otherwise.
|
||||||
*
|
*
|
||||||
* \return 0 if all certificates parsed successfully, a positive number
|
|
||||||
* if partly successful or a specific X509 or PEM error code
|
|
||||||
*/
|
*/
|
||||||
int mbedtls_x509_crt_parse( mbedtls_x509_crt *chain, const unsigned char *buf, size_t buflen );
|
int mbedtls_x509_crt_parse( mbedtls_x509_crt *chain, const unsigned char *buf, size_t buflen );
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user