From: sashiko-bot@kernel.org
To: "Ian Rogers" <irogers@google.com>
Cc: linux-perf-users@vger.kernel.org
Subject: Re: [PATCH v11 14/19] perf env: Refactor perf_env__arch_strerrno
Date: Tue, 02 Jun 2026 07:00:29 +0000 [thread overview]
Message-ID: <20260602070029.DA2931F00893@smtp.kernel.org> (raw)
In-Reply-To: <20260602062452.2583619-15-irogers@google.com>
Thank you for your contribution! Sashiko AI review found 2 potential issue(s) to consider:
- [Medium] The commit message claims to hide the declaration if libtraceevent is not present, but the code removes the conditional compilation, exposing it unconditionally.
- [Low] Generated C code uses newer ELF machine constants (e.g., EM_LOONGARCH, EM_CSKY) without fallback definitions, breaking the build on systems with older glibc.
--
commit 39cf4406b4f1694948ce536342e5558e9e7d0701
Author: Ian Rogers <irogers@google.com>
perf env: Refactor perf_env__arch_strerrno
This commit refactors perf_env__arch_strerrno to take an e_machine and an
errno value instead of an architecture string. It updates arch_errno_names.sh
to generate an e_machine to function mapping and alters the call sites
in builtin-trace.c to use the newly available e_machine.
> perf_env__arch_strerrno is only available with libtraceevent so hide
> the declaration if no libtraceevent.
[Severity: Medium]
The commit message mentions hiding the declaration when libtraceevent is
missing, but the patch actually removes the HAVE_LIBTRACEEVENT guards. Could
the commit message be more precise about the intent?
> diff --git a/tools/perf/trace/beauty/arch_errno_names.sh b/tools/perf/trace/beauty/arch_errno_names.sh
> index d48d8561a7bb4..aae3d92a7893a 100755
> --- a/tools/perf/trace/beauty/arch_errno_names.sh
> +++ b/tools/perf/trace/beauty/arch_errno_names.sh
[ ... ]
> @@ -52,21 +52,50 @@ process_arch()
> |IFS=, create_errno_lookup_func "$arch"
> }
>
> +arch_to_e_machine()
> +{
> + case "$1" in
> + alpha) printf '\tcase EM_ALPHA:\n' ;;
> + arc) printf '\tcase EM_ARC:\n' ;;
> + arm) printf '\tcase EM_ARM:\n' ;;
> + arm64) printf '\tcase EM_AARCH64:\n' ;;
> + csky) printf '\tcase EM_CSKY:\n' ;;
> + hexagon) printf '\tcase EM_HEXAGON:\n' ;;
> + loongarch) printf '\tcase EM_LOONGARCH:\n' ;;
[ ... ]
> @@ -74,6 +103,8 @@ cat <<EoHEADER
> /* SPDX-License-Identifier: GPL-2.0 */
>
> #include <string.h>
> +#include <stdint.h>
> +#include <elf.h>
>
> EoHEADER
[Severity: Low]
Can this cause a build failure on systems with older glibc versions?
The script unconditionally outputs cases for newer ELF machine constants
like EM_CSKY and EM_LOONGARCH into the generated C code, relying solely
on the system elf.h.
If a host has an older glibc where these constants are not yet defined,
it would result in undeclared identifier errors. Is a fallback definition
or internal header needed here?
> diff --git a/tools/perf/util/env.c b/tools/perf/util/env.c
> index fae70b07ba8de..b41562fb06c63 100644
> --- a/tools/perf/util/env.c
> +++ b/tools/perf/util/env.c
[ ... ]
> @@ -851,16 +851,11 @@ const char *perf_env__arch(struct perf_env *env)
> return arch;
> }
>
> -const char *perf_env__arch_strerrno(struct perf_env *env __maybe_unused, int err __maybe_unused)
> -{
> -#if defined(HAVE_LIBTRACEEVENT)
> - if (env->arch_strerrno == NULL)
> - env->arch_strerrno = arch_syscalls__strerrno_function(perf_env__arch(env));
> +const char *arch_syscalls__strerrno(uint16_t e_machine, int err);
>
> - return env->arch_strerrno ? env->arch_strerrno(err) : "no arch specific strerrno function";
> -#else
> - return "!HAVE_LIBTRACEEVENT";
> -#endif
> +const char *perf_env__arch_strerrno(uint16_t e_machine, int err)
> +{
> + return arch_syscalls__strerrno(e_machine, err);
> }
[Severity: Medium]
Does this unintentionally expose perf_env__arch_strerrno unconditionally?
The commit message states the intent is to hide the declaration if there
is no libtraceevent, but this code removes the HAVE_LIBTRACEEVENT guards
entirely.
--
Sashiko AI review · https://sashiko.dev/#/patchset/20260602062452.2583619-1-irogers@google.com?part=14
next prev parent reply other threads:[~2026-06-02 7:00 UTC|newest]
Thread overview: 194+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-02-19 11:38 [PATCH v2] perf symbol: Remove psw_idle() from list of idle symbols Thomas Richter
2026-02-19 11:55 ` Jan Polensky
2026-02-23 21:46 ` Namhyung Kim
2026-02-23 23:14 ` Arnaldo Melo
2026-03-02 18:43 ` Arnaldo Carvalho de Melo
2026-03-02 19:44 ` Ian Rogers
2026-03-04 14:34 ` Arnaldo Carvalho de Melo
2026-03-02 23:43 ` [PATCH v1] perf symbol: Lazily compute idle and use the perf_env Ian Rogers
2026-03-24 17:14 ` Ian Rogers
2026-03-25 6:58 ` Namhyung Kim
2026-03-25 15:58 ` Ian Rogers
2026-03-25 16:18 ` [PATCH v2] " Ian Rogers
2026-03-26 7:20 ` Honglei Wang
2026-03-26 15:11 ` Ian Rogers
2026-03-26 17:45 ` [PATCH v3 0/2] perf symbol/env: ELF machine clean up and lazy idle computation Ian Rogers
2026-03-26 17:45 ` [PATCH v3 1/2] perf env: Add perf_env__e_machine helper and use in perf_env__arch Ian Rogers
2026-03-26 17:45 ` [PATCH v3 2/2] perf symbol: Lazily compute idle and use the perf_env Ian Rogers
2026-03-27 6:56 ` Honglei Wang
2026-03-27 4:50 ` [PATCH v4 0/2] perf symbol/env: ELF machine clean up and lazy idle computation Ian Rogers
2026-03-27 4:50 ` [PATCH v4 1/2] perf env: Add perf_env__e_machine helper and use in perf_env__arch Ian Rogers
2026-04-06 5:05 ` Namhyung Kim
2026-04-06 15:36 ` Ian Rogers
2026-03-27 4:50 ` [PATCH v4 2/2] perf symbol: Lazily compute idle and use the perf_env Ian Rogers
2026-04-06 5:10 ` Namhyung Kim
2026-04-06 16:11 ` Ian Rogers
2026-04-06 17:09 ` [PATCH v5 0/3] perf symbol/env: ELF machine clean up and lazy idle computation Ian Rogers
2026-04-06 17:09 ` [PATCH v5 1/3] perf env: Add perf_env__e_machine helper and use in perf_env__arch Ian Rogers
2026-04-06 17:09 ` [PATCH v5 2/3] perf env: Add helper to lazily compute the os_release Ian Rogers
2026-04-06 17:09 ` [PATCH v5 3/3] perf symbol: Lazily compute idle and use the perf_env Ian Rogers
2026-04-09 23:06 ` [PATCH v6 0/3] perf symbol/env: ELF machine clean up and lazy idle computation Ian Rogers
2026-04-09 23:06 ` [PATCH v6 1/3] perf env: Add perf_env__e_machine helper and use in perf_env__arch Ian Rogers
2026-04-09 23:37 ` sashiko-bot
2026-05-01 18:20 ` [PATCH v7 0/4] perf symbol/env: ELF machine clean up and lazy idle computation Ian Rogers
2026-05-01 18:20 ` [PATCH v7 1/4] perf env: Add perf_env__e_machine helper and use in perf_env__arch Ian Rogers
2026-05-01 18:56 ` sashiko-bot
2026-05-01 18:20 ` [PATCH v7 2/4] perf env: Add helper to lazily compute the os_release Ian Rogers
2026-05-01 19:20 ` sashiko-bot
2026-05-01 18:20 ` [PATCH v7 3/4] perf symbol: Add setters for bitfields sharing a byte to avoid concurrent update issues Ian Rogers
2026-05-01 19:42 ` sashiko-bot
2026-05-01 18:20 ` [PATCH v7 4/4] perf symbol: Lazily compute idle and use a global lock for updates Ian Rogers
2026-05-01 20:13 ` sashiko-bot
2026-05-02 6:59 ` [PATCH v8 00/17] perf symbol/env: ELF machine clean up and lazy idle computation Ian Rogers
2026-05-02 6:59 ` [PATCH v8 01/17] perf env: Add perf_env__e_machine helper and use in perf_env__arch Ian Rogers
2026-05-02 7:56 ` sashiko-bot
2026-05-02 6:59 ` [PATCH v8 02/17] perf tests topology: Switch env->arch use to env->e_machine Ian Rogers
2026-05-02 6:59 ` [PATCH v8 03/17] perf capstone: Determine architecture from e_machine Ian Rogers
2026-05-02 7:58 ` sashiko-bot
2026-05-02 6:59 ` [PATCH v8 04/17] perf print_insn: Use e_machine for fallback IP length check Ian Rogers
2026-05-02 7:55 ` sashiko-bot
2026-05-02 6:59 ` [PATCH v8 05/17] perf machine: Use perf_env e_machine rather than arch Ian Rogers
2026-05-02 7:11 ` sashiko-bot
2026-05-02 6:59 ` [PATCH v8 06/17] perf sample-raw: " Ian Rogers
2026-05-02 6:59 ` [PATCH v8 07/17] perf sort: " Ian Rogers
2026-05-02 6:59 ` [PATCH v8 08/17] perf symbol: Avoid use of machine__is Ian Rogers
2026-05-02 7:17 ` sashiko-bot
2026-05-02 6:59 ` [PATCH v8 09/17] perf arch common: Use perf_env e_machine rather than arch Ian Rogers
2026-05-02 7:59 ` sashiko-bot
2026-05-02 6:59 ` [PATCH v8 10/17] perf header: In print_pmu_caps use perf_env e_machine Ian Rogers
2026-05-02 6:59 ` [PATCH v8 11/17] perf c2c: Use perf_env e_machine rather than arch Ian Rogers
2026-05-02 7:44 ` sashiko-bot
2026-05-02 6:59 ` [PATCH v8 12/17] perf lock-contention: " Ian Rogers
2026-05-02 6:59 ` [PATCH v8 13/17] perf env: Refactor perf_env__arch_strerrno Ian Rogers
2026-05-02 6:59 ` [PATCH v8 14/17] perf env: Remove unused perf_env__raw_arch Ian Rogers
2026-05-02 6:59 ` [PATCH v8 15/17] perf env: Add helper to lazily compute the os_release Ian Rogers
2026-05-02 7:53 ` sashiko-bot
2026-05-02 6:59 ` [PATCH v8 16/17] perf symbol: Add setters for bitfields sharing a byte to avoid concurrent update issues Ian Rogers
2026-05-02 7:55 ` sashiko-bot
2026-05-02 6:59 ` [PATCH v8 17/17] perf symbol: Lazily compute idle and use a global lock for updates Ian Rogers
2026-05-03 0:22 ` [PATCH v9 00/18] perf symbol/env: ELF machine clean up and lazy idle computation Ian Rogers
2026-05-03 0:22 ` [PATCH v9 01/18] perf env: Add perf_env__e_machine helper and use in perf_env__arch Ian Rogers
2026-05-03 0:52 ` sashiko-bot
2026-05-04 1:35 ` Namhyung Kim
2026-05-03 0:22 ` [PATCH v9 02/18] perf tests topology: Switch env->arch use to env->e_machine Ian Rogers
2026-05-03 0:22 ` [PATCH v9 03/18] perf env, dso, thread: Add _endian variants for e_machine helpers Ian Rogers
2026-05-03 0:39 ` sashiko-bot
2026-05-03 0:22 ` [PATCH v9 04/18] perf capstone: Determine architecture from e_machine Ian Rogers
2026-05-03 0:50 ` sashiko-bot
2026-05-03 0:22 ` [PATCH v9 05/18] perf print_insn: Use e_machine for fallback IP length check Ian Rogers
2026-05-03 0:22 ` [PATCH v9 06/18] perf symbol: Avoid use of machine__is Ian Rogers
2026-05-03 0:51 ` sashiko-bot
2026-05-03 0:22 ` [PATCH v9 07/18] perf machine: Use perf_env e_machine rather than arch Ian Rogers
2026-05-03 1:00 ` sashiko-bot
2026-05-03 0:22 ` [PATCH v9 08/18] perf sample-raw: " Ian Rogers
2026-05-03 0:22 ` [PATCH v9 09/18] perf sort: " Ian Rogers
2026-05-03 0:22 ` [PATCH v9 10/18] perf arch common: " Ian Rogers
2026-05-03 0:38 ` sashiko-bot
2026-05-03 0:22 ` [PATCH v9 11/18] perf header: In print_pmu_caps use perf_env e_machine Ian Rogers
2026-05-03 0:22 ` [PATCH v9 12/18] perf c2c: Use perf_env e_machine rather than arch Ian Rogers
2026-05-03 0:22 ` [PATCH v9 13/18] perf lock-contention: " Ian Rogers
2026-05-03 0:22 ` [PATCH v9 14/18] perf env: Refactor perf_env__arch_strerrno Ian Rogers
2026-05-03 1:11 ` sashiko-bot
2026-05-03 0:22 ` [PATCH v9 15/18] perf env: Remove unused perf_env__raw_arch Ian Rogers
2026-05-03 0:22 ` [PATCH v9 16/18] perf env: Add helper to lazily compute the os_release Ian Rogers
2026-05-03 1:00 ` sashiko-bot
2026-05-03 0:22 ` [PATCH v9 17/18] perf symbol: Add setters for bitfields sharing a byte to avoid concurrent update issues Ian Rogers
2026-05-03 0:59 ` sashiko-bot
2026-05-03 0:22 ` [PATCH v9 18/18] perf symbol: Lazily compute idle Ian Rogers
2026-05-03 1:11 ` sashiko-bot
2026-06-01 6:53 ` [PATCH v10 00/18] Add perf_env__e_machine and migrate arch string comparisons to e_machine Ian Rogers
2026-06-01 6:53 ` [PATCH v10 01/18] perf env: Add perf_env__e_machine helper and use in perf_env__arch Ian Rogers
2026-06-01 7:08 ` sashiko-bot
2026-06-01 6:53 ` [PATCH v10 02/18] perf tests topology: Switch env->arch use to env->e_machine Ian Rogers
2026-06-01 6:53 ` [PATCH v10 03/18] perf env, dso, thread: Add _endian variants for e_machine helpers Ian Rogers
2026-06-01 7:07 ` sashiko-bot
2026-06-01 6:53 ` [PATCH v10 04/18] perf capstone: Determine architecture from e_machine Ian Rogers
2026-06-01 7:08 ` sashiko-bot
2026-06-01 6:53 ` [PATCH v10 05/18] perf print_insn: Use e_machine for fallback IP length check Ian Rogers
2026-06-01 6:53 ` [PATCH v10 06/18] perf symbol: Avoid use of machine__is Ian Rogers
2026-06-01 6:53 ` [PATCH v10 07/18] perf machine: Use perf_env e_machine rather than arch Ian Rogers
2026-06-01 6:53 ` [PATCH v10 08/18] perf sample-raw: " Ian Rogers
2026-06-01 6:53 ` [PATCH v10 09/18] perf sort: " Ian Rogers
2026-06-01 6:53 ` [PATCH v10 10/18] perf arch common: " Ian Rogers
2026-06-01 7:08 ` sashiko-bot
2026-06-01 6:54 ` [PATCH v10 11/18] perf header: In print_pmu_caps use perf_env e_machine Ian Rogers
2026-06-01 6:54 ` [PATCH v10 12/18] perf c2c: Use perf_env e_machine rather than arch Ian Rogers
2026-06-01 6:54 ` [PATCH v10 13/18] perf lock-contention: " Ian Rogers
2026-06-01 6:54 ` [PATCH v10 14/18] perf env: Refactor perf_env__arch_strerrno Ian Rogers
2026-06-01 7:34 ` sashiko-bot
2026-06-01 6:54 ` [PATCH v10 15/18] perf env: Remove unused perf_env__raw_arch Ian Rogers
2026-06-01 6:54 ` [PATCH v10 16/18] perf env: Add helper to lazily compute the os_release Ian Rogers
2026-06-01 7:17 ` sashiko-bot
2026-06-01 6:54 ` [PATCH v10 17/18] perf symbol: Add setters for bitfields sharing a byte to avoid concurrent update issues Ian Rogers
2026-06-01 7:19 ` sashiko-bot
2026-06-01 6:54 ` [PATCH v10 18/18] perf symbol: Lazily compute idle Ian Rogers
2026-06-01 7:19 ` sashiko-bot
2026-06-02 6:24 ` [PATCH v11 00/19] perf: Use e_machine and lazily compute symbols Ian Rogers
2026-06-02 6:24 ` [PATCH v11 01/19] perf env: Add perf_env__e_machine helper and use in perf_env__arch Ian Rogers
2026-06-02 6:41 ` sashiko-bot
2026-06-02 6:24 ` [PATCH v11 02/19] perf tests topology: Switch env->arch use to env->e_machine Ian Rogers
2026-06-02 6:24 ` [PATCH v11 03/19] perf env, dso, thread: Add _endian variants for e_machine helpers Ian Rogers
2026-06-02 6:41 ` sashiko-bot
2026-06-02 6:24 ` [PATCH v11 04/19] perf capstone: Determine architecture from e_machine Ian Rogers
2026-06-02 6:38 ` sashiko-bot
2026-06-02 6:24 ` [PATCH v11 05/19] perf print_insn: Use e_machine for fallback IP length check Ian Rogers
2026-06-02 6:46 ` sashiko-bot
2026-06-02 6:24 ` [PATCH v11 06/19] perf symbol: Avoid use of machine__is Ian Rogers
2026-06-02 6:41 ` sashiko-bot
2026-06-02 6:24 ` [PATCH v11 07/19] perf machine: Use perf_env e_machine rather than arch Ian Rogers
2026-06-02 6:24 ` [PATCH v11 08/19] perf sample-raw: " Ian Rogers
2026-06-02 6:24 ` [PATCH v11 09/19] perf sort: " Ian Rogers
2026-06-02 6:24 ` [PATCH v11 10/19] perf arch common: " Ian Rogers
2026-06-02 6:41 ` sashiko-bot
2026-06-02 6:24 ` [PATCH v11 11/19] perf header: In print_pmu_caps use perf_env e_machine Ian Rogers
2026-06-02 6:24 ` [PATCH v11 12/19] perf c2c: Use perf_env e_machine rather than arch Ian Rogers
2026-06-02 6:24 ` [PATCH v11 13/19] perf lock-contention: " Ian Rogers
2026-06-02 6:42 ` sashiko-bot
2026-06-02 6:24 ` [PATCH v11 14/19] perf env: Refactor perf_env__arch_strerrno Ian Rogers
2026-06-02 7:00 ` sashiko-bot [this message]
2026-06-02 6:24 ` [PATCH v11 15/19] perf env: Remove unused perf_env__raw_arch Ian Rogers
2026-06-02 6:24 ` [PATCH v11 16/19] perf env: Add mutex to protect lazy environment initialization Ian Rogers
2026-06-02 6:45 ` sashiko-bot
2026-06-02 6:24 ` [PATCH v11 17/19] perf env: Add helper to lazily compute the os_release Ian Rogers
2026-06-02 6:50 ` sashiko-bot
2026-06-02 6:24 ` [PATCH v11 18/19] perf symbol: Add setters for bitfields sharing a byte to avoid concurrent update issues Ian Rogers
2026-06-02 6:24 ` [PATCH v11 19/19] perf symbol: Lazily compute idle Ian Rogers
2026-06-02 15:24 ` [PATCH v12 00/19] perf: Use e_machine and lazily compute symbols Ian Rogers
2026-06-02 15:24 ` [PATCH v12 01/19] perf env: Add perf_env__e_machine helper and use in perf_env__arch Ian Rogers
2026-06-02 15:43 ` sashiko-bot
2026-06-02 15:24 ` [PATCH v12 02/19] perf tests topology: Switch env->arch use to env->e_machine Ian Rogers
2026-06-02 15:25 ` [PATCH v12 03/19] perf env, dso, thread: Add _endian variants for e_machine helpers Ian Rogers
2026-06-02 15:42 ` sashiko-bot
2026-06-02 15:25 ` [PATCH v12 04/19] perf capstone: Determine architecture from e_machine Ian Rogers
2026-06-02 15:42 ` sashiko-bot
2026-06-02 15:25 ` [PATCH v12 05/19] perf print_insn: Use e_machine for fallback IP length check Ian Rogers
2026-06-02 15:25 ` [PATCH v12 06/19] perf symbol: Avoid use of machine__is Ian Rogers
2026-06-02 15:43 ` sashiko-bot
2026-06-02 15:25 ` [PATCH v12 07/19] perf machine: Use perf_env e_machine rather than arch Ian Rogers
2026-06-02 15:25 ` [PATCH v12 08/19] perf sample-raw: " Ian Rogers
2026-06-02 15:25 ` [PATCH v12 09/19] perf sort: " Ian Rogers
2026-06-02 15:25 ` [PATCH v12 10/19] perf arch common: " Ian Rogers
2026-06-02 15:25 ` [PATCH v12 11/19] perf header: In print_pmu_caps use perf_env e_machine Ian Rogers
2026-06-02 15:25 ` [PATCH v12 12/19] perf c2c: Use perf_env e_machine rather than arch Ian Rogers
2026-06-02 15:25 ` [PATCH v12 13/19] perf lock-contention: " Ian Rogers
2026-06-02 15:25 ` [PATCH v12 14/19] perf env: Refactor perf_env__arch_strerrno Ian Rogers
2026-06-02 15:25 ` [PATCH v12 15/19] perf env: Remove unused perf_env__raw_arch Ian Rogers
2026-06-02 15:25 ` [PATCH v12 16/19] perf env: Add mutex to protect lazy environment initialization Ian Rogers
2026-06-02 15:57 ` sashiko-bot
2026-06-02 15:25 ` [PATCH v12 17/19] perf env: Add helper to lazily compute the os_release Ian Rogers
2026-06-02 15:55 ` sashiko-bot
2026-06-02 15:25 ` [PATCH v12 18/19] perf symbol: Add setters for bitfields sharing a byte to avoid concurrent update issues Ian Rogers
2026-06-02 15:25 ` [PATCH v12 19/19] perf symbol: Lazily compute idle Ian Rogers
2026-06-02 16:53 ` [PATCH v12 00/19] perf: Use e_machine and lazily compute symbols Ian Rogers
2026-06-03 5:39 ` Namhyung Kim
2026-06-03 19:47 ` Arnaldo Carvalho de Melo
2026-06-03 21:41 ` Arnaldo Carvalho de Melo
2026-06-03 21:45 ` Arnaldo Carvalho de Melo
2026-04-09 23:06 ` [PATCH v6 2/3] perf env: Add helper to lazily compute the os_release Ian Rogers
2026-04-09 23:50 ` sashiko-bot
2026-04-09 23:06 ` [PATCH v6 3/3] perf symbol: Lazily compute idle and use the perf_env Ian Rogers
2026-04-10 0:11 ` sashiko-bot
2026-03-27 6:00 ` [PATCH v2] perf tests task-analyzer: Write test files to tmpdir Ian Rogers
2026-03-31 7:22 ` Namhyung Kim
2026-03-31 17:58 ` Ian Rogers
2026-04-01 3:41 ` Namhyung Kim
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=20260602070029.DA2931F00893@smtp.kernel.org \
--to=sashiko-bot@kernel.org \
--cc=irogers@google.com \
--cc=linux-perf-users@vger.kernel.org \
--cc=sashiko-reviews@lists.linux.dev \
/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.