From 9d42c85063ac13f574ffd00b8be31bbd39f29a70 Mon Sep 17 00:00:00 2001 From: José Fonseca Date: Fri, 12 Apr 2013 10:30:21 +0100 Subject: Cleanup README formatting. --- README.markdown | 30 ++++++++++++++++-------------- 1 file changed, 16 insertions(+), 14 deletions(-) (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown index 4bf809e9..7545982e 100644 --- a/README.markdown +++ b/README.markdown @@ -418,10 +418,9 @@ Or on Windows: python scripts\retracediff.py --retrace \path\to\glretrace.exe --ref-env TRACE_LIBGL=\path\to\reference\opengl32.dll application.trace -[![githalytics.com alpha](https://cruel-carlota.pagodabox.com/c1062ad633aa7a458e9d7520021307e4 "githalytics.com")](http://githalytics.com/apitrace/apitrace) - Advanced GUI usage ================== + qapitrace has rudimentary support for replaying traces on a remote target device. This can be useful, for example, when developing for an embedded system. The primary GUI will run on the local host, while any @@ -429,22 +428,22 @@ replays will be performed on the target device. In order to target a remote device, use the command-line: - qapitrace --remote-target - + qapitrace --remote-target + In order for this to work, the following must be available in the system configuration: - + 1. It must be possible for the current user to initiate an ssh session that has access to the target's window system. The command to be exectuted by qapitrace will be: - - ssh glretrace + + ssh glretrace For example, if the target device is using the X window system, one can test whether an ssh session has access to the target X server with: - ssh xdpyinfo + ssh xdpyinfo If this command fails with something like "cannot open display" then the user will have to configure the target to set the DISPLAY @@ -455,18 +454,21 @@ system configuration: this must be configured on the host side so that ssh can be initiated without a username. - For example, if you normally connect with "ssh user@192.168.0.2" + For example, if you normally connect with `ssh user@192.168.0.2` you could configure ~/.ssh/config on the host with a block such as: - Host target - HostName 192.168.0.2 - User user + Host target + HostName 192.168.0.2 + User user - And after this you should be able to connect with "ssh target" so - that you can also use "qapitrace --remote-target target". + And after this you should be able to connect with `ssh target` so + that you can also use `qapitrace --remote-target target`. 2. The target host must have a functional glretrace binary available 3. The target host must have access to at the same path in the filesystem as the path on the host system being passed to the qapitrace command line. + + +[![githalytics.com alpha](https://cruel-carlota.pagodabox.com/c1062ad633aa7a458e9d7520021307e4 "githalytics.com")](http://githalytics.com/apitrace/apitrace) -- cgit v1.2.3