バグ報告

From The Document Foundation Wiki
< JA
Jump to: navigation, search

}

LibreOfficeのバグ報告

LibreOfficeのバグ報告は bugzilla で行ってください。Product名として "LibreOffice" を選択してください。

バグ報告に含めるべき事項

以下の情報を入れることにより、バグの再現や特定がしやすくなり、バグの修正が早く行われることになります:

  • システムのバージョンとアーキテクチャ: (例) openSUSE 11.2 on x86_64, 32-bit Windows 7
  • デスクトップシステム(Linuxの場合): (例) KDE or GNOME
  • LibreOfficeのバージョン: (例) 3.2.0
    バージョン番号は、「ヘルプ」 - 「LibreOffice 情報」から見ることができます。リリースバージョンで無いLibreOfficeをLinux上で利用している場合には、LibreOfficeのパッケージ管理システム内での正確なバージョン番号を書いてください。Windowsの場合には、インストーラーのファイル名とどこからダウンロードしたのかを書いてください。
  • 64-bitのLinuxで利用している場合には、32-bit版のLibreOfficeを使っているかどうか。
  • LibreOfficeの公式ビルドでない場合には、パッケージのソース
  • バグの再現手順
  • その他の有益な情報の詳細 (例: スクリーンショット、バックトレース、strace)

How to get strace log (on Linux)

In most cases, it is enough to start the application the following way:

strace -o /tmp/strace.log -f -tt -s 512 libreoffice

Then please do the steps to reproduce the problem and quit the application. The command libreoffice might be replaced with /opt/libreoffice/program/soffice specifically when you don't have the desktop integration installed.

Please, compress the log before it is attached to the bug report:

bzip2 /tmp/strace.log

If the 32-bit LibreOffice is running on 64-bit system, you need to install the package strace-32bit and start the 32-bit binary directly:

cd /opt/libreoffice/program
strace32 -o /tmp/strace.log -f -tt -s 512 ./soffice.bin

How to get backtrace (on Linux)

The backtrace is useful when the application crashes or freezes. You might use the following steps:

  1. Install the libreoffice*-debuginfo packages (if available, and/or from your linux distribution).
  2. Start the debugger with the real binary and log the output:
    cd /opt/libreoffice/program
    
    gdb ./soffice.bin 2>&1 | tee /tmp/gdb.log
    
  3. Inside the debugger, start the application:
    run <options>
    
  4. Do the steps to reproduce the application crash or freeze. If the freeze is the case, you need to press CTRL+C to get the gdb commandline back.
  5. Print backtrace:
    backtrace
    
  6. Print backtrace of all threads:
    thread apply all bt
    
  7. quit the debugger
    quit
    
  8. Attach the whole gdb.log to the bug report.


How to get valgrind log (on Linux)

The valgrind log is useful when the application crashes or freezes and the backtrace is not enough. You might use the following steps:

  1. Install the libreoffice*-debuginfo packages. (if available, and/or from your linux distribution)
  2. Start the debugger with the real binary and log the output:
    cd /opt/libreoffice/program
    
    valgrind --tool=memcheck --num-callers=128 --trace-children=yes ./soffice.bin 2>&1 | tee /tmp/valgrind.log
    
  3. Do the steps to reproduce the application crash or freeze. Note that it usually works fine with valgrind because it helps to keep the memory clean. Anyway, it should detect the danger and put some useful information to the log. Note that valgrind prints many warnings all the time. You really need to do the problematic steps to put the important data into the log.
  4. Quit LibreOffice
  5. Please, compress the valgring.log if it is bigger that 10kB
    bzip2 /tmp/valgrind.log
    
  6. Attach the log into to the bug report.