diff options
Diffstat (limited to 'doc/debuginfod.8')
-rw-r--r-- | doc/debuginfod.8 | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/debuginfod.8 b/doc/debuginfod.8 index 07cb01ae..1070d290 100644 --- a/doc/debuginfod.8 +++ b/doc/debuginfod.8 @@ -134,6 +134,14 @@ service load. Archive pattern options must still be given, so debuginfod can recognize file name extensions for unpacking. .TP +.B "\-\-metadata\-maxtime=SECONDS" +Impose a limit on the runtime of metadata webapi queries. These +queries, especially broad "glob" wildcards, can take a large amount of +time and produce large results. Public-facing servers may need to +throttle them. The default limit is 5 seconds. Set 0 to disable this +limit. + +.TP .B "\-D SQL" "\-\-ddl=SQL" Execute given sqlite statement after the database is opened and initialized as extra DDL (SQL data definition language). This may be @@ -384,6 +392,16 @@ The exact set of metrics and their meanings may change in future versions. Caution: configuration information (path names, versions) may be disclosed. +.SS /metadata?key=\fIKEY\fP&value=\fIVALUE\fP + +This endpoint triggers a search of the files in the index plus any +upstream federated servers, based on given key and value. If +successful, the result is a application/json textual array, listing +metadata for the matched files. See \fIdebuginfod-find(1)\fP for +documentation of the common key/value search parameters, and the +resulting data schema. + + .SH DATA MANAGEMENT debuginfod stores its index in an sqlite database in a densely packed |