Commit 0e74d7ca authored by Rob Percival's avatar Rob Percival Committed by Matt Caswell
Browse files

Document the i2o and o2i SCT functions

parent a8d5d13a
Loading
Loading
Loading
Loading
+15 −3
Original line number Diff line number Diff line
@@ -18,20 +18,32 @@ decode and encode Signed Certificate Timestamp lists in TLS wire format

=head1 DESCRIPTION

The SCT_LIST and SCT functions are very similar to the i2d and d2i family of
functions, except that they convert to and from TLS wire format, as described in
RFC 6962. See L<d2i_SCT_LIST> for more information about how the parameters are
treated and the return values.

The SCT_signature functions are less similar. They still convert to and from
TLS wire format, but they require that an SCT is provided that the signature is
either taken from or inserted into.

=head1 NOTES


If an error occurs during a call to o2i_SCT_signature, the SCT may have its
signature NID updated but not the signature value.

=head1 RETURN VALUES


All of the functions have return values consist with those stated for
L<d2i_SCT_LIST>, except o2i_SCT_signature. The o2i_SCT_signature function
returns the number of bytes that were parsed, or a negative integer if an error
occurs.

=head1 SEE ALSO

L<ct(3)>,
L(d2i_SCT_LIST(3)>
L(d2i_SCT_LIST(3)>,
L(i2d_SCT_LIST(3)>

=head1 HISTORY