17 Ocak 2020 Cuma

gdb seçenekleri

Giriş
gdb yerine UDB de kullanılabilir. Açıklaması şöyle
UDB is another reverse debugger that works just like GDB. It is meant to be a drop-in replacement for GDB and is made to integrate with the development environment and command line.
.gdbinit Dosyası
Örnek
Şöyle yaparız
define sx
  si
  x /1i $pc
end
document sx
    Step one instruction and print next instruction
end
define nx
  ni
  x /1i $pc
end
document nx
    Step one instruction running through calls and print next instruction
end
Invoking GDB
GDB c ve C++ uygulamaları için kullanılabilir. Açıklaması şöyle.
You can use GDB to debug programs written in C, C++, Fortran and Modula-2.
1. Çalışan Uygulamaya Bağlanma
Şöyle yaparız.
gdb -p "pid"
Şöyle yaparız
gdb -p ./myprogram 1234 komutu ile PID'si 1234 olan programa bağlanılabilir.

2. Core Dosyası
Örnek
komutu ile core dosyasının nerede çöktüğü incelenebilir.
gdb myprogram core

3. Uygulamak Debug için
Örnek
Uygulamamızı debug için şöyle yaparız. gdb komut satırına düşer.
gdb myprogram
Örnek
Önce gdb başlatılır
prompt$ gdb
GNU gdb (GDB) Red Hat Enterprise Linux (7.2-50.el6)
Copyright (C) 2010 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.  Type "show copying"
and "show warranty" for details.
This GDB was configured as "x86_64-redhat-linux-gnu".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Daha sonra debug edilecek uygulama belirtilir
(gdb) file /home/me/build-path/my-program
Reading symbols from /home/me/build-path/my-program...done.
İstenilen noktaya breakpoint konulur
(gdb) my-program-src.cpp:57
breakpoint 1 at 0x819df9b: file src/my-program-src.cpp, line 57
Debug başlatılır
(gdb) run 
 Starting program: /home/me/build-path/my-program
4. Ortam değişkeni
Çoğu debugger Linux'ta "_" ortam değişkenine değer atar. Elimizde şöyle bir kod olsun.
#include <stdlib.h>
#include <stdio.h>

int main(int argc, char *argv[]) {
  char *path = getenv("_");
  printf("%s\n", argv[0]);
  printf("%s\n", path);
  return 0;
}
Çıktı olarak şunu alırız.
$ gcc -o main main.c
$ ./main
./main
./main
$ gdb main
...
(gdb) r
Starting program: /home/user/tmp/main
/home/user/tmp/main
/usr/bin/gdb
[Inferior 1 (process 21694) exited normally]
(gdb)

Seçenekler
--args seçeneği
Şöyle yaparız. Kabuk önümüze düşünce run komutu ile program başlatılır.
gdb --args myprogram param1 param2
(gdb) run
Bir diğer seçenek ise şöyle yapmak
gdb myprogram
(gdb) run param1 param2
-ex seçeneği
Tüm thread'lerin call stacklerini görmek için şöyle yaparız
gdb myprogram core.1234 - ex 'thread apply all bt'

-q seçeneği
quite çalıştırır. Böylece başlangıçta yazılan bir sürü satırı görmeyiz. Şöyle yaparız.
gdb -q myprogram

Reading symbols from myprogram...done.
Kabuk Komutları
yanlış komut
gdb komutu anlayamazsa şu çıktıyı verir.
(gdb) by
Undefined command: "by".  Try "help".
add-symbol-file komutu
debug symbol dosyası olmayan .so için sembol yüklemeyi sağlar.
Örnek
Şöyle yaparız.
(gdb) add-symbol-file  /home/me/build-path/lib/libMySharedLib2.so
Örnek
Önce şöyle yaparız.
(gdb) info shared
foo için from adresi $addr olsun. Daha sonra şöyle yaparız.
(gdb) add-symbol-file /path/to/foo.so.debug $addr
breakpoint komutu
b ya da break olarak kullanılır. Breakpoint gdb'nin yaptığı bir şey değildir, işletim sistem seviyesindedir.
Örnek
Adresini bildiğimiz bir satıra breakpoint koyabiliriz. Buradaki adres loader çalıştıktan yani gdb run yapıldıktan sonraki adres. Açıklaması şöyle.
(gdb) b *0x080495a3
Örnek
Metod ismine göre koyabiliriz. Şöyle yaparız
(gdb) b main
Breakpoint 1 at 0x40053c: file foo.c, line 5.
Örnek
İmzasını bildiğimiz bir sınıfın metoduna koyabiliriz. Şöyle yaparız.
break myclass::~myclass()
Örnek
Belli bir nesne için koymak istersek şöyle yaparız
b myclass::~myclass if (this==0x9b993e4)
bt komutu
Call stack'i gösterir. where komutu ile aynıdır. Şöyle yaparız.
(gdb) bt
catch komutu
Sistem çağrısına breakpoint koymak için kullanılabilir.

Örnek
Şöyle yaparız.
(gdb) catch throw 
Catchpoint 2 (throw)
Örnek
Uygulamayı başlatırız
Catchpoint 2 (throw)aagdb --args /path/to/your/your-program and its args
unlink() vs gibi sistem çağrısına breakpoint koyarız. Şöyle yaparız
catch syscall unlink
catch syscall unlinkat
catch syscall rmdir
run
Tümü şöyle
$ gdb -q --args rm -rf /tmp/tmp.HudBncQ4Ni
Reading symbols from rm...
Reading symbols from /usr/lib/debug/.build-id/f6/7ac1d7304650a51950992d074f98ec88fe2f49.debug...
(gdb) catch syscall unlink
Catchpoint 1 (syscall 'unlink' [87])
(gdb) catch syscall unlinkat
Catchpoint 2 (syscall 'unlinkat' [263])
(gdb) catch syscall rmdir
Catchpoint 3 (syscall 'rmdir' [84])
(gdb) run
Starting program: /bin/rm -rf /tmp/tmp.HudBncQ4Ni

Catchpoint 2 (call to syscall unlinkat), 0x00007ffff7eb6fa7 in __GI_unlinkat () at ../sysdeps/unix/syscall-template.S:120
120     ../sysdeps/unix/syscall-template.S: No such file or directory.
(gdb) info registers
rax            0xffffffffffffffda  -38
rbx            0x555555569830      93824992319536
rcx            0x7ffff7eb6fa7      140737352789927
rdx            0x0                 0
rsi            0x555555569938      93824992319800
rdi            0x4                 4
rbp            0x555555568440      0x555555568440
rsp            0x7fffffffda48      0x7fffffffda48
r8             0x3                 3
r9             0x0                 0
r10            0xfffffffffffffa9c  -1380
r11            0x206               518
r12            0x0                 0
r13            0x7fffffffdc30      140737488346160
r14            0x0                 0
r15            0x555555569830      93824992319536
rip            0x7ffff7eb6fa7      0x7ffff7eb6fa7 <__GI_unlinkat+7>
eflags         0x206               [ PF IF ]
cs             0x33                51
ss             0x2b                43
ds             0x0                 0
es             0x0                 0
fs             0x0                 0
gs             0x0                 0
(gdb) x/s $rsi
0x555555569938: "test"
(gdb) info proc
process 7524
cmdline = '/bin/rm -rf /tmp/tmp.HudBncQ4Ni'
cwd = '/export/home/stephane'
exe = '/bin/rm'
(gdb) !readlink /proc/7524/fd/4
/tmp/tmp.HudBncQ4Ni
(gdb) !find /tmp/tmp.HudBncQ4Ni -ls
  1875981      4 drwx------   2 stephane stephane     4096 Aug  8 09:30 /tmp/tmp.HudBncQ4Ni
  1835128      4 -rw-r--r--   1 stephane stephane        5 Aug  8 09:30 /tmp/tmp.HudBncQ4Ni/test

disable komutu
Şöyle yaparız. Ne olduğunu anlamadım.
(gdb) disable  
disas komutu
Assembly kodunu gösterir.
(gdb) disas /m main
Dump of assembler code for function main:
5       {
0x08048330 :    push   %ebp
0x08048331 :    mov    %esp,%ebp
0x08048333 :    sub    $0x8,%esp
0x08048336 :    and    $0xfffffff0,%esp
0x08048339 :    sub    $0x10,%esp

6         printf ("Hello.\n");
0x0804833c :   movl   $0x8048440,(%esp)
0x08048343 :   call   0x8048284 

7         return 0;
8       }
0x08048348 :   mov    $0x0,%eax
0x0804834d :   leave
0x0804834e :   ret

End of assembler dump.
fin komutu
Şöyle yaparız. Ne olduğunu anlamadım.
(gdb) fin
Run till exit from #0 ...
informatino komutu - breakpoints
Örnek
Şöyle yaparız.
(gdb) b _start
Breakpoint 1 at 0x520
(gdb) info b
Num     Type           Disp Enb Address            What
1       breakpoint     keep y   0x0000000000000520 <_start>
2       breakpoint     keep y   0x0000000000000520 <_start>
information komutu - file
Örnek
Uygulamanın EntryPoint'ini öğrenmek için şöyle yaparız.
(gdb) info file
Çıktı olarak bir sürü satır gelir. Entry point şöyledir.
Entry point : 0x804762c
Örnek
Şöyle yaparız.
(gdb) info file
Symbols from "/home/user202729/PINCE/a".
Local exec file:
        `/home/user202729/PINCE/a', file type elf64-x86-64.
        Entry point: 0x520
        [...]
information komutu - threads
Şöyle yaparız.
info threads
information komutu - shared
shared veya sharedlibrary olarak kullanılabilir. Yüklenen kütüphanelerin debug symbol durumunu gösterir. Şöyle yaparız.
(gdb) info sharedlibrary
From                To                  Syms Read   Shared Object Library
0x00007ff8e77c68b0  0x00007ff8e7919ac4  Yes (*)     ./libc.so.6
0x00007ff8e7b71ac0  0x00007ff8e7b8f810  Yes         /lib64/ld-linux-x86-64.so.2
(*): Shared library is missing debugging information.
information komutu - vtable
Belli bir nesnenin vtable satırları şöyle görülebilir.
(gdb) i vtbl b
vtable for 'A' @ 0x400cf0 (subobject @ 0x603010):
[0]: 0x0
[1]: 0x0
[2]: 0x4008e0 <__cxa_pure_virtual@plt>
next komutu
Bir satırı çalıştırır. Sadece enter'a basmak ta aynı şey sanırım. Elimizde şöyle bir kod olsun
unsigned int i = 2;
const int &r = i;
std::cout << r << "\n";
i = 100;
std::cout << r << "\n";
Şöyle yaparız.
(gdb) n
6   const int &r = i;
(gdb) 
7   std::cout << r << "\n";
print komutu
array
Örnek
Elimizde int a[100] olsun. Şöyle yaparız.
(gdb) print a
Örnek
Elimizde int a[100] olsun ancak int* parametre olarak geçilmiş olsun. Şöyle yaparız.
(gdb) print *a@100
Örnek
Elimizde int a[100][100] olsun ancak int* parametre olarak geçişlmiş olsun. Belli bir boyutu görmek için şöyle yaparız.
print *arr[0]@n
Tamamını yazdırmak için şöyle kodumuz olsun.
void print(int arr[][], n, m)
{
    int i, j;
    for (i = 0; i < n; ++i)
    {
        for (j = 0; j < m; ++j)
            printf("%d ", arr[i][j]);
        printf("\n");
    }
}
Çağırmak için şöyle yaparız
call print(arr, n, m)
int
Parametre pointer değilse int i için şöyle bir çıktı alırız.
(gdb) print i
$42 = 1
metod
Örnek
Parametre metod ise imzası ve adresi gösterilir. Main metodu şöyledir.
int main(){...}
Çıktı olarak şunu görürüz. Return Type (int) + Parametreler şeklindedir.
(gdb) print main
$1 = {int ()} 0x4005ab <main>
Başka bir function olsun
void function(char *ls, int a, int b, int c){...}
Çıktı olarak şunu görürüz. Return Type (void) + Parametreler
(gdb) print function
$2 = {void (char *, int, int, int)} 0x400573 <function>
Örnek
Template kodlarda işe yaramıyor. Şöyle yaparız.
(gdb) p std::max_element(v.begin(), v.end())
 No symbol "max_element" in namespace "std".
pointer
Parametre pointer ise tipi ve bellek adresi gösterilir.
(gdb) print &j
$1 = (int *) 0x7fffffffde80
(gdb) print &i
$2 = (int *) 0x7fffffffde84
register
Örnek
Parametre register ise şöyle yaparız.
(gdb) p $sp
$1 = (void *) 0x7fffffffde40

(gdb) p $rbp
$2 = (void *) 0x7fffffffde60
Örnek
Şöyle yaparız
(gdb) p/x $rsp

(gdb) x/x $rbp
Açıklaması şöyle
p/x $rsp displays the value of the rsp register, i.e.: the address of the top of the stack
since  rsp points to the top of the stack.

x/x $rsp displays the memory contents located at the top of stack (i.e.: the contents
located at the address pointed by rsp)
sizeof
Parametre ile sizeof yapılabilir.
(gdb) p sizeof(obj_a)
$1 = 32
struct
Parametre struct ise içi gösterilir.Elimizde global olan ve ismi mutex olan bir değişken olsun.
pthread_mutex_t mutex =...;
Yapının içini görmek için şöyle yaparız.
(gdb) p mutex
$1 = {__data = {__lock = 1, __count = 0, __owner = 6596, ...},
template
Template bir nesne için şöyle yaparız. Çıktı okunaklı değil. Okunaklı çıktı için "pretty printer" tanımlamak gerekir.
(gdb) p server
$11 = (const mpn::SER_ID &) @0x756660: {, std::allocator >, boost::detail::empty_base > >> = {, std::allocator >, boost::detail::empty_base > > >> = {, std::allocator >, boost::detail::empty_base > >> = {, std::allocator >, boost::detail::empty_base >> = {, std::allocator >, boost::equality_comparable2, std::allocator >, boost::detail::empty_base > >> = {, std::allocator >, boost::detail::empty_base >> = {> = {}, }, }, }, }, }, }, t = "B"...}
quit komudu
gdb'den çıkar. Şöyle yaparız.
(gdb) q
run komutu
run veya r kısaltmasını kullanabiliriz. Şöyle yaparız.
(gdb) run
Starting program: ...
[Thread debugging using libthread_db enabled]
Using host libthread_db library "/lib/x86_64-linux-gnu/libthread_db.so.1".
Şöyle yaparız.
Reading symbols from ./a.out...done.
...
(gdb) r
Starting program: /tmp/a.out 
shell
gdb ile shell kullanmak mümkün. Şöyle yaparız.
(gdb) while (1)
 >step
 >shell sleep 1
 >end
python kullanmak için şöyle yaparız.
(gdb) python import time
(gdb) while (1)
 >step
 >python time.sleep(1)
 >end
macro tanımlamak için şöyle yaparız.
(gdb) define runslowly
Type commands for definition of "runslowly".
End with a line saying just "end".
>python import time
>while (1)
 >step
 >python time.sleep(1)
 >end
>end
(gdb) document runslowly
Type documentation for "runslowly".
End with a line saying just "end".
>step a line at a time, every 1 second
>end

(gdb) runslowly
set komutu
Örnek - solib-search path
.so dosyasını yüklemeyez ise şu mesajı verir.
warning: Could not load shared library symbols for linux-vdso.so.1.
Do you need "set solib-search-path" or "set sysroot"?
Şöyle yaparız.
(gdb) set solib-search-path /lib:/usr/adowdy/lib:/usr/adowdy/arm/lib
Örnek
thread kütüphanelerinde karışıklık varsa şu mesajı verir.
warning: Unable to find libthread_db matching inferior's thread library, thread debugging
will not be available.
Şöyle yaparız.
set libthread-db-search-path [path]
Örnek - değişkene değer atamak
Elimizde şöyle bir dizi olsun.
float** P_i=
Bu diziyi dolaşmak için bir değişken yaratıp kullanabiliriz.
(gdb) set $pos=0
(gdb) print P_i[$pos++]
$51 = (float *) 0x804d500
(gdb) print P_i[$pos++]
$52 = (float *) 0x804d148
Örnek - disable-randomization-off
Açıklaması şöyle.
When you run a program inside gdb, gdb tries to help you debugging by disabling address randomization. You can use the following command to enable it (effective from the next run of the program):
Örneğin gdb kullanırken __libc_start_main adresini hep 0x00007ffff7de8060 olarak görebiliriz. Bu yardımı kapatmak için şöyle yaparız.
(gdb) set disable-randomization off
Örnek - değişkene değer atamak
Program Counter (PC) değerini bir önceki değere atamak için şöyle yaparız. RSP stack'i gösterir.
(gdb) set $pc = *(void **)$rsp
(gdb) set $rsp = $rsp + 8
si komutu
Tek bir makine kodu (Single Instruction) çalıştırır. C kodundaki satırında çalıştırılmasından farklıdır.
(gdb) si
0x08048366 in main ()
0x0804836c in main ()
start komutu
run komutunun aksine ilk satır'da uygulamayı durdurur ve bekler. Böylece breakpoint kopyma şansımız olur. Şöyle yaparız.
#include <stdlib.h>
int main()
{
  void *p = calloc(1, 10);
  return p == 0;
}

gdb -q ./a.out

Reading symbols from ./a.out...done.
(gdb) start
Temporary breakpoint 1 at 0x8048426: file foo.c, line 4.
Starting program: /tmp/a.out 

Temporary breakpoint 1, main () at foo.c:4
4         void *p = calloc(1, 10);
symbol-file
GDB ya da herhangi bir debugger ile çalışırken symbol table verisini yüklemek gerekir. Bu tablonun üretilmesi için yazılımın "gcc -g" seçeneği ile derlenmesi gerekmektedir. Symbol table kabaca makine kodu içindeki offsetlerin değişkenlere dönüştürülebilmesine yarar.

Yani kaynak kod ile assembly arasında ilişki kurar. Debug yaparken kaynak kod içinde 1 satır atlansa bile, 50 tane assembly satırı atlanılmış olabilir.

Bir başka örnek olarak, gdb içinde print x komutu verilince x değişkeninin hangi offsette bulunduğunu symbol table gösterir.

Symbol file debug yaparken çıkarılabilir veya tekrar eklenebilir. Bunun için symbol-file komutu kullanılır. Örnek:
Reading symbols from /tmp/foo...done.
(gdb) symbol-file
Discard symbol table from `/tmp/foo'? (y or n) y
No symbol file now.
(gdb) symbol-file foo
Reading symbols from /tmp/foo...done.
(gdb) symbol-file
Discard symbol table from `/tmp/foo'? (y or n) y
No symbol file now.
Visual Studio'da sembol tabloları şöyle kontrol edilir.
Debug >Windows> Modules penceresinde pdb dosyasının olduğuna bakılır.

target komutu
Remove debug için kullanılır
Örnek
Şöyle yaparız
target remote 192.168.1.20:9134
thread komutu
Örnek
Bir thread'e geçmek için şöyle yaparız.
(gdb) thread 45  
[Switching to thread 45 (Thread 909)]  
...
Örnek
Tüm threadlerin stack çıktısını görmek için şöyle yaparız.
(gdb) thread apply all bt
where komutu
Call stack'i gösterir.

x komutu
Adresteki değer gösterir.
a
Ne olduğunu anlamadım. Şöyle yaparız.
(gdb) x/14ag 0x400d08
...
i - instruction
Belirtilen adresten sonraki 3 instruction'ı gösterir.
(gdb) x/3i 0x400b8f
0x400b8f <virtual thunk to A::show()>:  mov    (%rdi),%r10
0x400b92 <virtual thunk to A::show()+3>:    add    -0x18(%r10),%rdi
0x400b96 <virtual thunk to A::show()+7>:    jmp    0x400b46 <A::show()>
register
Register'ın değerini gösterir. Şöyle yaparız. x ve x/1xw arasındaki farkı bilmiyorum
(gdb) x $rbp+8
0x7fffffffddb8: 0xf7a2e830
(gdb) x/1xw $rbp+8
0x7fffffffddb8: 0xf7a2e830
Şöyle yaparız.
(gdb) p/x $rdi
$1 = 0x3
(gdb) p/x $rsi
$2 = 0x7fffffffe3a8
x
hexadecimal gösterir. Şöyle bir komut olsun
(gdb) call memset(0x8d9d50, 0, 32)
$89 = 9280848
Bu adresten itibaren 8 tane word'ü hexadecimal görmek istersek şöyle yaparız.
(gdb) x/8xw 0x8d9d50
0x8d9d50:       0x00000000      0x00000000      0x00000000      0x00000000
0x8d9d60:       0x00000000      0x00000000      0x00000000      0x00000000