From 5eeae535ee0df981d8ae8b758b5bb0d190c7fd89 Mon Sep 17 00:00:00 2001 From: Werner Koch Date: Fri, 13 Dec 2019 15:10:51 +0100 Subject: core: Extend gpgme_user_id_t with uidhash member. * src/gpgme.h.in (struct _gpgme_user_id): Add field 'uidhash'. * src/key.c (gpgme_key_unref): Free it. * src/keylist.c (keylist_colon_handler): Set it. * tests/run-keylist.c (main): Print it. -- The uidhash value is part of gpg's output since the year 2005. This now adds support to gpgme. The application for uidhash is to select a user id in an edit interactor: Instead of giving the number of the user id, the uidhash value can be be used to avoid tracking the user id numbers. Signed-off-by: Werner Koch --- doc/gpgme.texi | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'doc') diff --git a/doc/gpgme.texi b/doc/gpgme.texi index 36c2b32b..88b5f2cd 100644 --- a/doc/gpgme.texi +++ b/doc/gpgme.texi @@ -3581,6 +3581,12 @@ Reserved for the origin of this user ID. Reserved for the time of the last update of this user ID. +@item char *uidhash; +A string used by gpg to identify a user ID. This string can be used +at certain prompts of @code{gpgme_op_edit} to select a user ID. Users +must be prepared to see a @code{NULL} value here. The format of the +value is not specified and may depend on the GPGME or GnuPG version. + @end table @end deftp -- cgit v1.2.3