diff options
author | Frank Ch. Eigler <fche@redhat.com> | 2023-04-11 23:35:25 -0400 |
---|---|---|
committer | Frank Ch. Eigler <fche@redhat.com> | 2023-04-12 16:29:34 -0400 |
commit | 64242dcba918ae33dcefed495783bbe8c032f9d2 (patch) | |
tree | 1528ce14b189ebb2f5e8edb8cd005d31dd85cace /doc/debuginfod-client-config.7 | |
parent | 6e9718089b05403947d8255423a849d425305925 (diff) | |
download | elfutils-users/fche/try-pr29472e.tar.gz |
PR29472: debuginfod: add metadata query webapi, C api, clientusers/fche/try-pr29472e
This patch extends the debuginfod API with a "metadata query"
operation. It allows clients to request an enumeration of file names
known to debuginfod servers, returning a JSON response including the
matching buildids. This lets clients later download debuginfo for a
range of versions of the same named binaries, in case they need to to
prospective work (like systemtap-based live-patching). It also lets
server operators implement prefetch triggering operations for popular
but slow debuginfo slivers like kernel vdso.debug files on fedora.
Implementation requires a modern enough json-c library.
% debuginfod-find metadata file /bin/ls
% debuginfod-find metadata glob "/usr/local/bin/c*"
Documentation and testing are included.
Signed-off-by: Ryan Goldberg <rgoldber@redhat.com>
Signed-off-by: Frank Ch. Eigler <fche@redhat.com>
Diffstat (limited to 'doc/debuginfod-client-config.7')
-rw-r--r-- | doc/debuginfod-client-config.7 | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/debuginfod-client-config.7 b/doc/debuginfod-client-config.7 index 53d82806..bc98d1e6 100644 --- a/doc/debuginfod-client-config.7 +++ b/doc/debuginfod-client-config.7 @@ -134,3 +134,11 @@ are short-circuited (returning an immediate failure instead of sending a new query to servers). This accelerates queries that probably would still fail. The default is 600, 10 minutes. 0 means "forget immediately". + +.TP +.B metadata_retention_s +This control file sets how long to remember the results of a metadata +query. New queries for the same artifacts within this time window are +short-circuited (repeating the same results). This accelerates +queries that probably would probably have the same results. The +default is 86400, 1 day. 0 means "do not retain". |