All of lore.kernel.org
 help / color / mirror / Atom feed
From: Gilad Ben-Yossef <gilad-6S/DczAoZh3WXxRugSxzZg@public.gmane.org>
To: Herbert Xu
	<herbert-lOAM2aK0SrRLBo1qDEOMRrpzq4S04n8Q@public.gmane.org>,
	"David S. Miller" <davem-fT/PcQaiUtIeIZ0/mPfg9Q@public.gmane.org>,
	Jonathan Corbet <corbet-T1hC0tSOHrs@public.gmane.org>,
	David Howells <dhowells-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>,
	Tom Lendacky <thomas.lendacky-5C7GfCeVMHo@public.gmane.org>,
	Gary Hook <gary.hook-5C7GfCeVMHo@public.gmane.org>,
	Boris Brezillon
	<boris.brezillon-wi1+55ScJUtKEb57/3fJTNBPR1lH4CV8@public.gmane.org>,
	Arnaud Ebalard <arno-LkuqDEemtHBg9hUCZPvPmw@public.gmane.org>,
	Matthias Brugger
	<matthias.bgg-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>,
	Alasdair Kergon <agk-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>,
	Mike Snitzer <snitzer-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>,
	dm-devel-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org,
	Shaohua Li <shli-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>,
	Steve French <sfrench-eUNUBHrolfbYtjvyW6yDsg@public.gmane.org>,
	"Theodore Y. Ts'o" <tytso-3s7WtUTddSA@public.gmane.org>,
	Jaegeuk Kim <jaegeuk-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>,
	Mimi Zohar
	<zohar-23VcF4HTsmIX0ybBhKVfKdBPR1lH4CV8@public.gmane.org>,
	Dmitry Kasatkin
	<dmitry.kasatkin-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>,
	James Morris
	<james.l.morris-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org>,
	"Serge E. Hallyn" <serge-A9i7LUbDfNHQT0dZR+AlfA@public.gmane.org>,
	linux-crypto@v
Cc: Ofir Drang <ofir.drang-5wv7dgnIgG8@public.gmane.org>
Subject: [PATCH v5 07/19] crypto: move pub key to generic async completion
Date: Mon, 14 Aug 2017 18:21:17 +0300	[thread overview]
Message-ID: <1502724094-23305-8-git-send-email-gilad__33225.9730705575$1502724613$gmane$org@benyossef.com> (raw)
In-Reply-To: <1502724094-23305-1-git-send-email-gilad-6S/DczAoZh3WXxRugSxzZg@public.gmane.org>

public_key_verify_signature() is starting an async crypto op and
waiting for it to complete. Move it over to generic code doing
the same.

Signed-off-by: Gilad Ben-Yossef <gilad-6S/DczAoZh3WXxRugSxzZg@public.gmane.org>
---
 crypto/asymmetric_keys/public_key.c | 28 ++++------------------------
 1 file changed, 4 insertions(+), 24 deletions(-)

diff --git a/crypto/asymmetric_keys/public_key.c b/crypto/asymmetric_keys/public_key.c
index 3cd6e12..d916235 100644
--- a/crypto/asymmetric_keys/public_key.c
+++ b/crypto/asymmetric_keys/public_key.c
@@ -57,29 +57,13 @@ static void public_key_destroy(void *payload0, void *payload3)
 	public_key_signature_free(payload3);
 }
 
-struct public_key_completion {
-	struct completion completion;
-	int err;
-};
-
-static void public_key_verify_done(struct crypto_async_request *req, int err)
-{
-	struct public_key_completion *compl = req->data;
-
-	if (err == -EINPROGRESS)
-		return;
-
-	compl->err = err;
-	complete(&compl->completion);
-}
-
 /*
  * Verify a signature using a public key.
  */
 int public_key_verify_signature(const struct public_key *pkey,
 				const struct public_key_signature *sig)
 {
-	struct public_key_completion compl;
+	struct crypto_wait cwait;
 	struct crypto_akcipher *tfm;
 	struct akcipher_request *req;
 	struct scatterlist sig_sg, digest_sg;
@@ -131,20 +115,16 @@ int public_key_verify_signature(const struct public_key *pkey,
 	sg_init_one(&digest_sg, output, outlen);
 	akcipher_request_set_crypt(req, &sig_sg, &digest_sg, sig->s_size,
 				   outlen);
-	init_completion(&compl.completion);
+	crypto_init_wait(&cwait);
 	akcipher_request_set_callback(req, CRYPTO_TFM_REQ_MAY_BACKLOG |
 				      CRYPTO_TFM_REQ_MAY_SLEEP,
-				      public_key_verify_done, &compl);
+				      crypto_req_done, &cwait);
 
 	/* Perform the verification calculation.  This doesn't actually do the
 	 * verification, but rather calculates the hash expected by the
 	 * signature and returns that to us.
 	 */
-	ret = crypto_akcipher_verify(req);
-	if ((ret == -EINPROGRESS) || (ret == -EBUSY)) {
-		wait_for_completion(&compl.completion);
-		ret = compl.err;
-	}
+	ret = crypto_wait_req(crypto_akcipher_verify(req), &cwait);
 	if (ret < 0)
 		goto out_free_output;
 
-- 
2.1.4

  parent reply	other threads:[~2017-08-14 15:21 UTC|newest]

Thread overview: 211+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2017-08-14 15:21 [PATCH v5 00/19] simplify crypto wait for async op Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 01/19] crypto: change transient busy return code to -EAGAIN Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 02/19] crypto: ccp: use -EAGAIN for transient busy indication Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 16:55   ` Gary R Hook
2017-08-14 16:55     ` Gary R Hook
2017-08-14 16:55     ` Gary R Hook
2017-08-14 16:55     ` Gary R Hook
2017-08-14 16:55     ` Gary R Hook
2017-08-14 16:55     ` Gary R Hook
2017-08-14 16:55   ` Gary R Hook
2017-08-14 16:55   ` Gary R Hook
2017-08-14 16:55   ` Gary R Hook
     [not found]   ` <1502724094-23305-3-git-send-email-gilad-6S/DczAoZh3WXxRugSxzZg@public.gmane.org>
2017-08-14 16:55     ` Gary R Hook
2017-08-14 16:55       ` Gary R Hook
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 03/19] crypto: remove redundant backlog checks on EBUSY Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 04/19] crypto: marvell/cesa: " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-15  8:16   ` Boris Brezillon
2017-08-15  8:16     ` Boris Brezillon
2017-08-15  8:16     ` Boris Brezillon
2017-08-15  8:16     ` Boris Brezillon
2017-08-15  8:16     ` Boris Brezillon
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 05/19] crypto: introduce crypto wait for async op Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-15  2:23   ` Jonathan Cameron
2017-08-15  2:23     ` Jonathan Cameron
2017-08-15  2:23     ` Jonathan Cameron
2017-08-15  2:23     ` Jonathan Cameron
2017-08-15  2:23     ` Jonathan Cameron
2017-08-15  2:23     ` Jonathan Cameron
2017-08-21 12:49     ` Gilad Ben-Yossef
2017-08-21 12:49       ` Gilad Ben-Yossef
2017-08-21 12:49       ` Gilad Ben-Yossef
2017-08-21 12:49       ` Gilad Ben-Yossef
2017-08-21 12:49       ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 06/19] crypto: move algif to generic async completion Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 07/19] crypto: move pub key " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 08/19] crypto: move drbg " Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 09/19] crypto: move gcm " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
     [not found] ` <1502724094-23305-1-git-send-email-gilad-6S/DczAoZh3WXxRugSxzZg@public.gmane.org>
2017-08-14 15:21   ` [PATCH v5 01/19] crypto: change transient busy return code to -EAGAIN Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21     ` Gilad Ben-Yossef
2017-08-14 15:21     ` Gilad Ben-Yossef
2017-08-14 15:21     ` Gilad Ben-Yossef
2017-08-14 15:21     ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 02/19] crypto: ccp: use -EAGAIN for transient busy indication Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 03/19] crypto: remove redundant backlog checks on EBUSY Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 04/19] crypto: marvell/cesa: " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 05/19] crypto: introduce crypto wait for async op Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 06/19] crypto: move algif to generic async completion Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef [this message]
2017-08-14 15:21   ` [PATCH v5 08/19] crypto: move drbg " Gilad Ben-Yossef
2017-08-14 15:21     ` Gilad Ben-Yossef
2017-08-14 15:21     ` Gilad Ben-Yossef
2017-08-14 15:21     ` Gilad Ben-Yossef
2017-08-14 15:21     ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 09/19] crypto: move gcm " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 10/19] crypto: move testmgr " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 11/19] fscrypt: move " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 12/19] dm: move dm-verity " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 13/19] cifs: move " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 14/19] ima: " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 15/19] crypto: tcrypt: " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 16/19] crypto: talitos: " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 17/19] crypto: qce: " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 18/19] crypto: mediatek: " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` [PATCH v5 19/19] crypto: adapt api sample to use async. op wait Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 09/19] crypto: move gcm to generic async completion Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 10/19] crypto: move testmgr " Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 11/19] fscrypt: move " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 12/19] dm: move dm-verity " Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-19 20:08   ` [dm-devel] " Mikulas Patocka
2017-08-19 20:08     ` Mikulas Patocka
2017-08-19 20:08     ` Mikulas Patocka
2017-08-19 20:08     ` Mikulas Patocka
2017-08-19 20:08     ` Mikulas Patocka
     [not found]     ` <alpine.LRH.2.02.1708191605370.2380-Hpncn10jQN4oNljnaZt3ZvA+iT7yCHsGwRM8/txMwJMAicBL8TP8PQ@public.gmane.org>
2017-08-21 12:48       ` Gilad Ben-Yossef
2017-08-21 12:48         ` Gilad Ben-Yossef
2017-08-21 12:48         ` Gilad Ben-Yossef
2017-08-21 12:48         ` Gilad Ben-Yossef
2017-08-21 12:48         ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 13/19] cifs: move " Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 14/19] ima: " Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 15/19] crypto: tcrypt: " Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 16/19] crypto: talitos: " Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 17/19] crypto: qce: " Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21 ` [PATCH v5 18/19] crypto: mediatek: " Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
     [not found]   ` <1502724094-23305-19-git-send-email-gilad-6S/DczAoZh3WXxRugSxzZg@public.gmane.org>
2017-08-15  5:13     ` Ryder Lee
2017-08-15  5:13       ` Ryder Lee
2017-08-15  5:13       ` Ryder Lee
2017-08-15  5:13       ` Ryder Lee
2017-08-15  5:13       ` Ryder Lee
2017-08-15  5:13       ` Ryder Lee
2017-08-15  5:13       ` Ryder Lee
2017-08-14 15:21 ` [PATCH v5 19/19] crypto: adapt api sample to use async. op wait Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21 ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef
2017-08-14 15:21   ` Gilad Ben-Yossef

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='1502724094-23305-8-git-send-email-gilad__33225.9730705575$1502724613$gmane$org@benyossef.com' \
    --to=gilad-6s/dczaozh3wxxrugsxzzg@public.gmane.org \
    --cc=agk-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org \
    --cc=arno-LkuqDEemtHBg9hUCZPvPmw@public.gmane.org \
    --cc=boris.brezillon-wi1+55ScJUtKEb57/3fJTNBPR1lH4CV8@public.gmane.org \
    --cc=corbet-T1hC0tSOHrs@public.gmane.org \
    --cc=davem-fT/PcQaiUtIeIZ0/mPfg9Q@public.gmane.org \
    --cc=dhowells-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org \
    --cc=dm-devel-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org \
    --cc=dmitry.kasatkin-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org \
    --cc=gary.hook-5C7GfCeVMHo@public.gmane.org \
    --cc=herbert-lOAM2aK0SrRLBo1qDEOMRrpzq4S04n8Q@public.gmane.org \
    --cc=jaegeuk-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org \
    --cc=james.l.morris-QHcLZuEGTsvQT0dZR+AlfA@public.gmane.org \
    --cc=linux-crypto@v \
    --cc=matthias.bgg-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org \
    --cc=ofir.drang-5wv7dgnIgG8@public.gmane.org \
    --cc=serge-A9i7LUbDfNHQT0dZR+AlfA@public.gmane.org \
    --cc=sfrench-eUNUBHrolfbYtjvyW6yDsg@public.gmane.org \
    --cc=shli-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org \
    --cc=snitzer-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org \
    --cc=thomas.lendacky-5C7GfCeVMHo@public.gmane.org \
    --cc=tytso-3s7WtUTddSA@public.gmane.org \
    --cc=zohar-23VcF4HTsmIX0ybBhKVfKdBPR1lH4CV8@public.gmane.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.