From 1dd211da9a6614ac3681d9913da1f5136ae363cd Mon Sep 17 00:00:00 2001 From: Sebastien Helleu Date: Sat, 1 May 2010 11:48:02 +0200 Subject: [PATCH] Replace command "bt" by "bt full" for reporting crashes with gdb in user guide --- doc/en/weechat_user.en.txt | 41 +++++++++++++++++++------------------- doc/fr/weechat_user.fr.txt | 41 +++++++++++++++++++------------------- doc/it/weechat_user.it.txt | 41 +++++++++++++++++++------------------- 3 files changed, 63 insertions(+), 60 deletions(-) diff --git a/doc/en/weechat_user.en.txt b/doc/en/weechat_user.en.txt index 90939e57b..ae5c3a4e2 100644 --- a/doc/en/weechat_user.en.txt +++ b/doc/en/weechat_user.en.txt @@ -234,29 +234,30 @@ in '/home/xxx/', then run gdb with this command: gdb /usr/bin/weechat-curses /home/xxx/core ---------------------------------------- -Then under gdb, use command `bt` to display backtrace. +Then under gdb, use command `bt full` to display backtrace. You will see something like that: ---------------------------------------- -(gdb) bt -#0 0xffffe424 in __kernel_vsyscall () -#1 0xb76208e0 in raise () from /lib/i686/cmov/libc.so.6 -#2 0xb7623e15 in abort () from /lib/i686/cmov/libc.so.6 -#3 0x08083940 in weechat_shutdown (return_code=1, crash=1) at /some_path/src/core/weechat.c:357 -#4 0x08098aaa in debug_sigsegv () at /some_path/src/core/wee-debug.c:155 -#5 -#6 0xb7656681 in vsnprintf () from /lib/i686/cmov/libc.so.6 -#7 0xb763dd22 in snprintf () from /lib/i686/cmov/libc.so.6 -#8 0xb7258674 in irc_protocol_cmd_join (server=0x8165138, command=0xb727c187 "join", argc=3, argv=0x889e840, argv_eol=0x889e858) - at /some_path/src/plugins/irc/irc-protocol.c:520 -#9 0xb7265c6e in irc_protocol_recv_command (server=0x8165138, entire_line=0x889e7e0 ":nick!nick@127.0.0.1 JOIN :#test", - command=0x889d080 "JOIN") at /some_path/src/plugins/irc/irc-protocol.c:4077 -#10 0xb726a2c6 in irc_server_msgq_flush () at /some_path/src/plugins/irc/irc-server.c:1614 -#11 0xb726a4da in irc_server_recv_cb (data=0x8165138, fd=8) at /some_path/src/plugins/irc/irc-server.c:1691 -#12 0x0809a797 in hook_fd_exec (read_fds=0xbfcf8074, write_fds=0xbfcf7ff4, exception_fds=0xbfcf7f74) - at /some_path/src/core/wee-hook.c:1133 -#13 0x08060af0 in gui_main_loop () at /some_path/src/gui/curses/gui-curses-main.c:330 -#14 0x08083b10 in main (argc=3, argv=0xbfcf81d4) at /some_path/src/core/weechat.c:419 +(gdb) bt full +#0 0x00007f9dfb04a465 in raise () from /lib/libc.so.6 +#1 0x00007f9dfb04b8e6 in abort () from /lib/libc.so.6 +#2 0x0000000000437f66 in weechat_shutdown (return_code=1, crash=1) at /some_path/src/core/weechat.c:351 +#3 +#4 0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90, remaining_calls=) + at /some_path/src/core/wee-hook.c:1364 + hook_process = 0x254eb90 + status = +#5 0x000000000044cc7d in hook_timer_exec () at /some_path/src/core/wee-hook.c:1025 + tv_time = {tv_sec = 1272693881, tv_usec = 212665} + ptr_hook = 0x2811f40 + next_hook = 0x0 +#6 0x000000000041b5b0 in gui_main_loop () at /some_path/src/gui/curses/gui-curses-main.c:319 + hook_fd_keyboard = 0x173b600 + tv_timeout = {tv_sec = 0, tv_usec = 0} + read_fds = {fds_bits = {0 }} + write_fds = {fds_bits = {0 }} + except_fds = {fds_bits = {0 }} + max_fd = ---------------------------------------- You must report this trace to developers, and tell them what action caused this diff --git a/doc/fr/weechat_user.fr.txt b/doc/fr/weechat_user.fr.txt index 2b0fb8ae7..23568f824 100644 --- a/doc/fr/weechat_user.fr.txt +++ b/doc/fr/weechat_user.fr.txt @@ -239,29 +239,30 @@ Par exemple si 'weechat-curses' est installé dans '/usr/bin/' et que le fichier gdb /usr/bin/weechat-curses /home/xxx/core ---------------------------------------- -Puis sous gdb, utilisez la commande `bt` pour afficher la trace. +Puis sous gdb, utilisez la commande `bt full` pour afficher la trace. Vous verrez quelque chose comme ceci : ---------------------------------------- -(gdb) bt -#0 0xffffe424 in __kernel_vsyscall () -#1 0xb76208e0 in raise () from /lib/i686/cmov/libc.so.6 -#2 0xb7623e15 in abort () from /lib/i686/cmov/libc.so.6 -#3 0x08083940 in weechat_shutdown (return_code=1, crash=1) at /some_path/src/core/weechat.c:357 -#4 0x08098aaa in debug_sigsegv () at /some_path/src/core/wee-debug.c:155 -#5 -#6 0xb7656681 in vsnprintf () from /lib/i686/cmov/libc.so.6 -#7 0xb763dd22 in snprintf () from /lib/i686/cmov/libc.so.6 -#8 0xb7258674 in irc_protocol_cmd_join (server=0x8165138, command=0xb727c187 "join", argc=3, argv=0x889e840, argv_eol=0x889e858) - at /some_path/src/plugins/irc/irc-protocol.c:520 -#9 0xb7265c6e in irc_protocol_recv_command (server=0x8165138, entire_line=0x889e7e0 ":nick!nick@127.0.0.1 JOIN :#test", - command=0x889d080 "JOIN") at /some_path/src/plugins/irc/irc-protocol.c:4077 -#10 0xb726a2c6 in irc_server_msgq_flush () at /some_path/src/plugins/irc/irc-server.c:1614 -#11 0xb726a4da in irc_server_recv_cb (data=0x8165138, fd=8) at /some_path/src/plugins/irc/irc-server.c:1691 -#12 0x0809a797 in hook_fd_exec (read_fds=0xbfcf8074, write_fds=0xbfcf7ff4, exception_fds=0xbfcf7f74) - at /some_path/src/core/wee-hook.c:1133 -#13 0x08060af0 in gui_main_loop () at /some_path/src/gui/curses/gui-curses-main.c:330 -#14 0x08083b10 in main (argc=3, argv=0xbfcf81d4) at /some_path/src/core/weechat.c:419 +(gdb) bt full +#0 0x00007f9dfb04a465 in raise () from /lib/libc.so.6 +#1 0x00007f9dfb04b8e6 in abort () from /lib/libc.so.6 +#2 0x0000000000437f66 in weechat_shutdown (return_code=1, crash=1) at /some_path/src/core/weechat.c:351 +#3 +#4 0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90, remaining_calls=) + at /some_path/src/core/wee-hook.c:1364 + hook_process = 0x254eb90 + status = +#5 0x000000000044cc7d in hook_timer_exec () at /some_path/src/core/wee-hook.c:1025 + tv_time = {tv_sec = 1272693881, tv_usec = 212665} + ptr_hook = 0x2811f40 + next_hook = 0x0 +#6 0x000000000041b5b0 in gui_main_loop () at /some_path/src/gui/curses/gui-curses-main.c:319 + hook_fd_keyboard = 0x173b600 + tv_timeout = {tv_sec = 0, tv_usec = 0} + read_fds = {fds_bits = {0 }} + write_fds = {fds_bits = {0 }} + except_fds = {fds_bits = {0 }} + max_fd = ---------------------------------------- Vous devez envoyer cette trace aux développeurs, et leur indiquer quelle action diff --git a/doc/it/weechat_user.it.txt b/doc/it/weechat_user.it.txt index 234c76d56..f1fad2c56 100644 --- a/doc/it/weechat_user.it.txt +++ b/doc/it/weechat_user.it.txt @@ -240,29 +240,30 @@ si trova in '/home/xxx/', allora eseguire gdb con questo comando: gdb /usr/bin/weechat-curses /home/xxx/core ---------------------------------------- -All'interno di gdb, usare il comando `bt` per visualizzare +All'interno di gdb, usare il comando `bt full` per visualizzare il backtrace. Verrà mostrato qualcosa di simile a questo: ---------------------------------------- -(gdb) bt -#0 0xffffe424 in __kernel_vsyscall () -#1 0xb76208e0 in raise () from /lib/i686/cmov/libc.so.6 -#2 0xb7623e15 in abort () from /lib/i686/cmov/libc.so.6 -#3 0x08083940 in weechat_shutdown (return_code=1, crash=1) at /some_path/src/core/weechat.c:357 -#4 0x08098aaa in debug_sigsegv () at /some_path/src/core/wee-debug.c:155 -#5 -#6 0xb7656681 in vsnprintf () from /lib/i686/cmov/libc.so.6 -#7 0xb763dd22 in snprintf () from /lib/i686/cmov/libc.so.6 -#8 0xb7258674 in irc_protocol_cmd_join (server=0x8165138, command=0xb727c187 "join", argc=3, argv=0x889e840, argv_eol=0x889e858) - at /some_path/src/plugins/irc/irc-protocol.c:520 -#9 0xb7265c6e in irc_protocol_recv_command (server=0x8165138, entire_line=0x889e7e0 ":nick!nick@127.0.0.1 JOIN :#test", - command=0x889d080 "JOIN") at /some_path/src/plugins/irc/irc-protocol.c:4077 -#10 0xb726a2c6 in irc_server_msgq_flush () at /some_path/src/plugins/irc/irc-server.c:1614 -#11 0xb726a4da in irc_server_recv_cb (data=0x8165138, fd=8) at /some_path/src/plugins/irc/irc-server.c:1691 -#12 0x0809a797 in hook_fd_exec (read_fds=0xbfcf8074, write_fds=0xbfcf7ff4, exception_fds=0xbfcf7f74) - at /some_path/src/core/wee-hook.c:1133 -#13 0x08060af0 in gui_main_loop () at /some_path/src/gui/curses/gui-curses-main.c:330 -#14 0x08083b10 in main (argc=3, argv=0xbfcf81d4) at /some_path/src/core/weechat.c:419 +(gdb) bt full +#0 0x00007f9dfb04a465 in raise () from /lib/libc.so.6 +#1 0x00007f9dfb04b8e6 in abort () from /lib/libc.so.6 +#2 0x0000000000437f66 in weechat_shutdown (return_code=1, crash=1) at /some_path/src/core/weechat.c:351 +#3 +#4 0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90, remaining_calls=) + at /some_path/src/core/wee-hook.c:1364 + hook_process = 0x254eb90 + status = +#5 0x000000000044cc7d in hook_timer_exec () at /some_path/src/core/wee-hook.c:1025 + tv_time = {tv_sec = 1272693881, tv_usec = 212665} + ptr_hook = 0x2811f40 + next_hook = 0x0 +#6 0x000000000041b5b0 in gui_main_loop () at /some_path/src/gui/curses/gui-curses-main.c:319 + hook_fd_keyboard = 0x173b600 + tv_timeout = {tv_sec = 0, tv_usec = 0} + read_fds = {fds_bits = {0 }} + write_fds = {fds_bits = {0 }} + except_fds = {fds_bits = {0 }} + max_fd = ---------------------------------------- Bisogna riportare l'errore agli sviluppatori, e specificare quale azione ha causato