diff options
author | Denys Vlasenko <vda.linux@googlemail.com> | 2009-10-19 18:12:39 +0200 |
---|---|---|
committer | Denys Vlasenko <vda.linux@googlemail.com> | 2009-10-19 18:12:39 +0200 |
commit | 4df20906ef57432edb505ce28179fd979729c975 (patch) | |
tree | 0c8f030e6fd954073c9c952e03ba74f849f2718b /src/Daemon | |
parent | f10e69f4ebcd403a6c68f5feea9e1111ae338f2a (diff) | |
download | abrt-4df20906ef57432edb505ce28179fd979729c975.tar.gz abrt-4df20906ef57432edb505ce28179fd979729c975.tar.xz abrt-4df20906ef57432edb505ce28179fd979729c975.zip |
abrt-debuginfo-install: expand doc
Signed-off-by: Denys Vlasenko <vda.linux@googlemail.com>
Diffstat (limited to 'src/Daemon')
-rwxr-xr-x | src/Daemon/abrt-debuginfo-install | 23 |
1 files changed, 15 insertions, 8 deletions
diff --git a/src/Daemon/abrt-debuginfo-install b/src/Daemon/abrt-debuginfo-install index e9b398a8..fc5380ba 100755 --- a/src/Daemon/abrt-debuginfo-install +++ b/src/Daemon/abrt-debuginfo-install @@ -17,6 +17,17 @@ # it may be omitted or set to something else. script must be ready # for those cases too. # +# Output goes to GUI as debuginfo install log. The script should be careful +# to give useful, but not overly cluttered info to stdout. +# Additionally, abrt daemon handles "MISSING:xxxx" messages specially: +# xxxx will be prepended to backtrace. This is used to inform about +# missing debuginfos. +# +# Exitcodes: +# 0 - all debuginfos are installed +# 1 - not all debuginfos are installed +# 2+ - serious problem +# # Algorithm: # - Create TEMPDIR # - Extract build-ids from coredump @@ -31,6 +42,10 @@ # to CACHEDIR/usr/lib/debug/.build-id/XX/XXXX.debug and delete TEMPDIR # - Report which XX/XXXX.debug are still missing. # +# For better debuggability, eu_unstrip.OUT, yum_provides.OUT etc files +# are saved in TEMPDIR, and TEMPDIR is not deleted if we exit with exitcode 2 +# ("serious problem"). +# # In the future, we may want to use a separate CACHEDIR (say, /var/cache/abrt-di) # and use it with this gdb command: # set debug-file-directory /usr/lib/debug/.build-id:CACHEDIR/usr/lib/debug/.build-id @@ -40,14 +55,6 @@ # This is ugly, since it messes up /usr/lib/debug/.build-id over time # by piling up debuginfos there without any means to control their amount, # but it's the only way to make it work with current gdb. -# -# Output goes to GUI as debigunfo install log. -# "MISSING:xxxx" messages result in xxxx being prepended to backtrace -# -# Exitcodes: -# 0 - all debuginfos are installed -# 1 - not all debuginfos are installed -# 2+ - serious problem core=$1 |