1bf215546Sopenharmony_ci                              RBUG PIPE DRIVER
2bf215546Sopenharmony_ci
3bf215546Sopenharmony_ci
4bf215546Sopenharmony_ci= About =
5bf215546Sopenharmony_ci
6bf215546Sopenharmony_ciThis directory contains a Gallium3D remote debugger pipe driver.
7bf215546Sopenharmony_ciIt provides remote debugging functionality.
8bf215546Sopenharmony_ci
9bf215546Sopenharmony_ci
10bf215546Sopenharmony_ci= Usage =
11bf215546Sopenharmony_ci
12bf215546Sopenharmony_ciDo
13bf215546Sopenharmony_ci
14bf215546Sopenharmony_ci   GALLIUM_RBUG=true progs/trivial/tri
15bf215546Sopenharmony_ci
16bf215546Sopenharmony_ciwhich should open gallium remote debugging session. While the program is running
17bf215546Sopenharmony_ciyou can launch the small remote debugging application from progs/rbug. More
18bf215546Sopenharmony_ciinformation is in that directory. Also for a gui see:
19bf215546Sopenharmony_ci
20bf215546Sopenharmony_ci   http://cgit.freedesktop.org/mesa/rbug-gui
21bf215546Sopenharmony_ci
22bf215546Sopenharmony_ci
23bf215546Sopenharmony_ci= Integrating =
24bf215546Sopenharmony_ci
25bf215546Sopenharmony_ciYou can integrate the rbug pipe driver either inside the gallium frontend or the 
26bf215546Sopenharmony_citarget. The procedure on both cases is the same. Let's assume you have a 
27bf215546Sopenharmony_cipipe_screen obtained by the usual means (variable and function names are just
28bf215546Sopenharmony_cifor illustration purposes):
29bf215546Sopenharmony_ci
30bf215546Sopenharmony_ci  real_screen = real_screen_create(...);
31bf215546Sopenharmony_ci
32bf215546Sopenharmony_ciThe rbug screen is then created by doing
33bf215546Sopenharmony_ci
34bf215546Sopenharmony_ci  rbug_screen = rbug_screen_create(real_screen);
35bf215546Sopenharmony_ci
36bf215546Sopenharmony_ciYou can then simply use rbug_screen instead of real_screen.
37bf215546Sopenharmony_ci
38bf215546Sopenharmony_ciYou can create as many contexts you wish from rbug_screen::context_create they
39bf215546Sopenharmony_ciare automatically wrapped by rbug_screen.
40bf215546Sopenharmony_ci
41bf215546Sopenharmony_ci
42bf215546Sopenharmony_ci--
43bf215546Sopenharmony_ciJose Fonseca <jfonseca@vmware.com>
44bf215546Sopenharmony_ciJakob Bornecrantz <jakob@vmware.com>
45