OpenBSD manual page server

Manual Page Search Parameters

TS_REQ_NEW(3) Library Functions Manual TS_REQ_NEW(3)

TS_REQ_new, TS_REQ_free, TS_RESP_new, TS_RESP_free, TS_STATUS_INFO_new, TS_STATUS_INFO_free, TS_TST_INFO_new, TS_TST_INFO_free, TS_ACCURACY_new, TS_ACCURACY_free, TS_MSG_IMPRINT_new, TS_MSG_IMPRINT_freeX.509 time-stamp protocol

#include <openssl/ts.h>

TS_REQ *
TS_REQ_new(void);

void
TS_REQ_free(TS_REQ *req);

TS_RESP *
TS_RESP_new(void);

void
TS_RESP_free(TS_RESP *resp);

TS_STATUS_INFO *
TS_STATUS_INFO_new(void);

void
TS_STATUS_INFO_free(TS_STATUS_INFO *status);

TS_TST_INFO *
TS_TST_INFO_new(void);

void
TS_TST_INFO_free(TS_TST_INFO *token);

TS_ACCURACY *
TS_ACCURACY_new(void);

void
TS_ACCURACY_free(TS_ACCURACY *accuracy);

TS_MSG_IMPRINT *
TS_MSG_IMPRINT_new(void);

void
TS_MSG_IMPRINT_free(TS_MSG_IMPRINT *imprint);

A time-stamping authority is a trusted third party which allows its clients to prove that specific data existed at a particular point in time. Clients send time-stamping requests to the time-stamping server, which returns time-stamp tokens to the clients.

() allocates and initializes an empty TS_REQ object, representing an ASN.1 TimeStampReq structure defined in RFC 3161 section 2.4.1. It can hold a hash of the datum to be time-stamped and some auxiliary, optional information. () frees req.

() allocates and initializes an empty TS_RESP object, representing an ASN.1 TimeStampResp structure defined in RFC 3161 section 2.4.2. It can hold status information and a time-stamp token. () frees resp.

() allocates and initializes an empty TS_STATUS_INFO object, representing an ASN.1 PKIStatusInfo structure defined in RFC 3161 section 2.4.2. It is used inside TS_RESP and describes the outcome of one time-stamp request. () frees status.

() allocates and initializes an empty TS_TST_INFO object, representing an ASN.1 TSTInfo structure defined in RFC 3161 section 2.4.2. It is the time-stamp token included in a TS_RESP object in case of success, and it can hold the hash of the datum copied from a request, the time of generation, and some auxiliary information. () frees token.

() allocates and initializes an empty TS_ACCURACY object, representing an ASN.1 Accuracy structure defined in RFC 3161 section 2.4.2. It can be used inside a TS_TST_INFO object and indicates the maximum error of the time stated in the token. () frees accuracy.

() allocates and initializes an empty TS_MSG_IMPRINT object, representing an ASN.1 MessageImprint structure defined in RFC 3161 section 2.4.1. It is used inside TS_REQ and TS_RESP objects. It specifies a hash algorithm and stores the hash value of the datum. () frees imprint.

TS_REQ_new(), TS_RESP_new(), TS_STATUS_INFO_new(), TS_TST_INFO_new(), TS_ACCURACY_new(), and TS_MSG_IMPRINT_new() return the new TS_REQ, TS_RESP, TS_STATUS_INFO, TS_TST_INFO, TS_ACCURACY, or TS_MSG_IMPRINT object, respectively, or NULL if an error occurred.

ACCESS_DESCRIPTION_new(3), ESS_SIGNING_CERT_new(3), X509_EXTENSION_new(3)

RFC 3161: Internet X.509 Public Key Infrastructure Time-Stamp Protocol

Note that RFC 3161 has been updated by RFC 5816: ESSCertIDv2 Update for RFC 3161. That update allows using the Signing Certificate Attribute Definition Version 2 according to RFC 5035, but the current implementation only supports the Signing Certificate Attribute Definition Version 1 according to RFC 2634, and hence only supports RFC 3161, but not RFC 5816 functionality.

These functions first appeared in OpenSSL 1.0.0 and have been available since OpenBSD 4.9.

June 6, 2019 OpenBSD-7.4