Dijagnosticirajte na daljinu pomoću GDB-a

U uobičajenom slučaju kada udaljeni računal ili spremnik već ima instaliran GDBserver i kada je udaljeno pokretanje aplikacije već postavljeno i radi odabirom gumba Run (ili Ctrl+R), možete pokrenuti udaljeno otklanjanje pogrešaka odabirom gumba Debug (ili F5).

U tom slučaju, Qt Creator pokreće i automatski povezuje debug poslužitelj i aplikaciju na udaljenom računalu te stvarni otklanjivač pogrešaka na razvojnom hostu u ispravnom redoslijedu.

Ovo je preporučena metoda.

Ako uvjeti za ovo automatizirano postavljanje nisu ispunjeni, ali vaša udaljena mašina može pokretati GDB poslužitelj (ili bilo koju kompatibilnu sondu koja koristi GDB serijski protokol), i dalje možete koristiti Qt Creator za otklanjanje pogrešaka u svojoj aplikaciji.

Aplikacija radi, SSH pristup udaljenom računalu je dostupan

Ako se želite spojiti na aplikaciju koja već radi na udaljenom računalu i debug poslužitelj se može pokrenuti putem SSH-a s lokalnog računala, idite na Debug > Start Debugging > Attach to running applications.

Aplikacija nije pokrenuta, terminalski pristup udaljenom računalu je dostupan

Ako se debug poslužitelj ne može pokrenuti putem SSH-a s lokalnog računala, provjerite dokumentaciju svog uređaja radi alternativnih načina pokretanja debug poslužitelja.

Ako imate pristup terminalu na udaljenom računalu i instaliran GDB poslužitelj, možete ručno prenijeti izvršnu datoteku na udaljeno računalo i pokrenuti gdbserver prosljeđivanjem broja priključka i izvršne datoteke:

gdbserver :1234 /path/to/executable

Zatim obično odgovara:

Process /path/to/executable created; pid = 5159
Listening on port 1234

Na lokalnom računalu na kojem se pokreće Qt Creator:

1. Idite na Debug > Start Debugging > Attach to Running Debug Server.

   

2. U Kit odaberite skup za izgradnju i pokretanje koji ćete koristiti za izgradnju projekta.
3. U Server port unesite naziv udaljenog računala i broj porta koji ćete koristiti.
4. U odjeljku Local executable navedite putanju do izvršne datoteke aplikacije na lokalnom računalu.
5. U Command line arguments u navedite argumente naredbenog retka koji će se proslijediti izvršnoj datoteci.
6. U Working directory u navedite radni direktorij. Zadano je to direktorij s rezultatom izgradnje.
7. Odaberite Run in terminal za konzolne aplikacije.
8. Odaberite Break at "main" da zaustavite otklanjivač pogrešaka na glavnoj funkciji.
9. Odaberite Use target extended-remote to connect za uspostavljanje veze u target extended-remote mode. U ovom načinu rada, kada se debugirana aplikacija zatvori ili se odvojite od nje, otklanjivač pogrešaka ostaje povezan s ciljem. Možete ponovno pokrenuti aplikaciju, spojiti se na pokrenutu aplikaciju ili koristiti naredbe monitora specifične za odredište. Na primjer, GDB se ne izlazi osim ako nije pozvan s opcijom --once, ali možete ga natjerati da izađe korištenjem naredbe monitor exit.
10. U Override SysRoot-u navedite putanju do sysroot -a koji ćete koristiti umjesto zadanog sysroot-a.
11. U Init commands unesite naredbe koje će se izvršiti odmah nakon uspostavljanja veze s odredištem.
12. U odjeljku Reset commands unesite naredbe koje će se izvršiti pri resetiranju veze s odredištem.
13. U odjeljku Debug information navedite lokaciju za pohranu informacija o otklanjanju pogrešaka. Ne možete koristiti prazan put.
14. U Override server channel u navedite komunikacijski kanal koji ćete koristiti, kao što je serijski priključak ili prilagođeni port.
15. U Recent odaberite nedavnu konfiguraciju za korištenje.
16. Odaberite OK za pokretanje otklanjanja pogrešaka.

Po zadanome se neaktivni GDB proces prekida nakon 40 sekundi. Za povećanje vremenskog ograničenja u načinu rada GDB timeout, idite na Preferences > Debugger > GDB.

Za više informacija o povezivanju u načinu target extended-remote u GDB-u pogledajte poglavlje Debugging with GDB: Connecting to a Remote Target.

Aplikacija radi, terminalski pristup udaljenom računalu i gdbserver su dostupni

Ovaj je slučaj gotovo identičan prethodnom odjeljku, osim što se gdbserver pokreće drugačije:

gdbserver --attach :1234 <PID of running application>

Koristite SSH port forwarding

Da biste omogućili otklanjanje pogrešaka na udaljenim ciljevima koji ne mogu izložiti GDB poslužiteljske priključke, mapirajte udaljene priključke na lokalne priključke pomoću SSH tuneliranja. Qt Creator automatski otkriva lokalne i udaljene priključke.

Za uključivanje prosljeđivanja SSH portova:

1. Idite na Preferences > Devices.

   

2. U odjeljku Device odaberite Remote Linux Device.
3. Odaberite Use SSH port forwarding for debugging.
4. Odaberite Apply.

Pokretanje GDB poslužitelja naredbom

Remote Debugger Ako želite automatizirati i trajno spremiti postavljanje GDB poslužitelja kao dio vašeg projekta (na primjer, imate skriptu koja pokreće gdbserver na udaljenom uređaju), dodajte konfiguraciju pokretanja udaljenog otklanjanja pogrešaka. Naredba za pokretanje automatski se izvršava svaki put kad pokrenete otklanjanje pogrešaka, pa ne morate ručno postavljati vezu.

Za dodavanje konfiguracije pokretanja udaljenog otklanjanja pogrešaka:

1. Idite na Projects > Run Settings.
2. Odaberite Add > Remote Debugger > Create.
3. U odjeljku Command navedite skriptu ili naredbu koja uspostavlja vezu GDB poslužitelja.
4. U Command line arguments u navedite argumente koje želite proslijediti naredbi pokretača.
5. U Symbol file (local executable) navedite putanju do izvršne datoteke aplikacije na lokalnom računalu.
6. U Server channel odaberite komunikacijski kanal koji ćete koristiti. Zadano je tcp://127.0.0.1:1234.
7. Odaberite Break at "main" za zaustavljanje otklanjivača pogrešaka na glavnoj funkciji.
8. Odaberite Run in terminal za konzolne aplikacije.
9. Odaberite Use "target extended-remote" to connect za povezivanje u proširenom udaljenom načinu rada.
10. Odaberite konfiguraciju pokretanja u odabiraču skupa alata i pritisnite F5 za pokretanje otklanjanja pogrešaka.