diff options
author | Frank Ch. Eigler <fche@redhat.com> | 2020-03-27 20:47:45 -0400 |
---|---|---|
committer | Frank Ch. Eigler <fche@redhat.com> | 2020-03-27 20:47:45 -0400 |
commit | 3a9c5da0ac7004a1f04e8768a682f76514e66433 (patch) | |
tree | 90419e2d61a6b6dfae93748fedaea113359ec439 /doc | |
parent | dbfaf36ac283006621cce0d343462512c8c5635d (diff) | |
download | elfutils-3a9c5da0ac7004a1f04e8768a682f76514e66433.tar.gz |
PR25722: debuginfod-find: accept /path/names in place of buildid hex
Extend the debuginfod-find command line interface to permit
/file/names instead of only buildid hexadecimal strings.
v2: move code into debuginfod-find; client API remains buildid only.
Signed-off-by: Frank Ch. Eigler <fche@redhat.com>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/ChangeLog | 4 | ||||
-rw-r--r-- | doc/debuginfod-find.1 | 13 |
2 files changed, 15 insertions, 2 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 38ce441c..25404e58 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2020-03-27 Frank Ch. Eigler <fche@redhat.com> + + * debuginfod-find.1: Document /path/-based buildid passing. + 2020-03-24 Frank Ch. Eigler <fche@redhat.com> * debuginfod_add_http_header.3: New function, documented ... diff --git a/doc/debuginfod-find.1 b/doc/debuginfod-find.1 index a861a48e..aeb1cb12 100644 --- a/doc/debuginfod-find.1 +++ b/doc/debuginfod-find.1 @@ -19,10 +19,11 @@ debuginfod-find \- request debuginfo-related data .SH SYNOPSIS .B debuginfod-find [\fIOPTION\fP]... debuginfo \fIBUILDID\fP - +.B debuginfod-find [\fIOPTION\fP]... debuginfo \fIPATH\fP .B debuginfod-find [\fIOPTION\fP]... executable \fIBUILDID\fP - +.B debuginfod-find [\fIOPTION\fP]... executable \fIPATH\fP .B debuginfod-find [\fIOPTION\fP]... source \fIBUILDID\fP \fI/FILENAME\fP +.B debuginfod-find [\fIOPTION\fP]... source \fIPATH\fP \fI/FILENAME\fP .SH DESCRIPTION \fBdebuginfod-find\fP queries one or more \fBdebuginfod\fP servers for @@ -52,6 +53,14 @@ Then the hexadecimal BUILDID is simply: 8713b9c3fb8a720137a4a08b325905c7aaf8429d .ESAMPLE +In place of the hexadecimal \fIBUILDID\fP, debuginfod-find also +accepts a path name to to an ELF binary, from which it extracts the +buildid. In this case, ensure the file name has some character other +than \fB[0-9a-f]\fP. Files ambiguously named files like +"\fBdeadbeef\fP" can be passed with a \fB./deadbeef\fP extra path +component. + + .SS debuginfo \fIBUILDID\fP If the given buildid is known to a server, this request will result |