Module Name: src
Committed By: agc
Date: Sat Oct 20 06:01:57 UTC 2012
Modified Files:
src/crypto/external/bsd/netpgp/dist/src/libverify
[agc-netpgp-standalone]:
libnetpgpverify.3
Log Message:
document pgpv_get_verified(), which returns data and size of verified
data.
To generate a diff of this commit:
cvs rdiff -u -r1.1.2.2 -r1.1.2.3 \
src/crypto/external/bsd/netpgp/dist/src/libverify/libnetpgpverify.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/crypto/external/bsd/netpgp/dist/src/libverify/libnetpgpverify.3
diff -u src/crypto/external/bsd/netpgp/dist/src/libverify/libnetpgpverify.3:1.1.2.2 src/crypto/external/bsd/netpgp/dist/src/libverify/libnetpgpverify.3:1.1.2.3
--- src/crypto/external/bsd/netpgp/dist/src/libverify/libnetpgpverify.3:1.1.2.2 Sat Oct 20 04:59:53 2012
+++ src/crypto/external/bsd/netpgp/dist/src/libverify/libnetpgpverify.3 Sat Oct 20 06:01:57 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: libnetpgpverify.3,v 1.1.2.2 2012/10/20 04:59:53 agc Exp $
+.\" $NetBSD: libnetpgpverify.3,v 1.1.2.3 2012/10/20 06:01:57 agc Exp $
.\"
.\" Copyright (c) 2012 Alistair Crooks <[email protected]>
.\" All rights reserved.
@@ -23,7 +23,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd September 28, 2012
+.Dd October 20, 2012
.Dt LIBNETPGPVERIFY 3
.Os
.Sh NAME
@@ -41,9 +41,9 @@
.Fo pgpv_verify
.Fa "pgpv_cursor_t *cursor" "pgpv_t *pgp" "const void *ptr" "ssize_t size"
.Fc
-.Ft int
-.Fo pgpv_verify_print
-.Fa "pgpv_cursor_t *cursor"
+.Ft size_t
+.Fo pgpv_get_verified
+.Fa "pgpv_cursor_t *cursor" "unsigned entry" "char **ret"
.Fc
.Ft size_t
.Fo pgpv_get_entry
@@ -95,8 +95,17 @@ structure.
Occasionally, the memory or contents of the file which matched the signature
will be needed, rather than a boolean value of whether it was verified.
To do this, the
-.Fn pgpv_verify_print
+.Fn pgpv_get_verified
function is used.
+Arguments to
+.Fn pgpv_get_verified
+are the entry number of the verification, and the returned data and its size.
+If an error occurs, or the signature is not verified, a zero value is returned
+for the size.
+.Nm
+stores the starts of the data of all verified matches, and so the entry
+number argument is the index of the occurrence of verification.
+The first match will have an entry number of 0, the second 1, and so on.
.Pp
The
.Fn pgpv_close
