GammaRay - Qt-application inspection and manipulation tool.
gammaray [--pid <pid> | <application> <args> | --connect
GammaRay inspects runtime internals of a Qt-application, such as:
Object tree, properties, signal/slots, widgets, models,
state machines, meta types, fonts, codecs, text documents
When run without any options, gammaray will present a list of running
Qt-applications from which you can attach the selected injector. Else, you can
attach to a running process by specifying its pid, or you can start a new
Qt-application by specifying its name (and optional arguments).
- Print help message and exit.
- Print version information and exit.
- -p, --pid <pid>
- Attach to running Qt application with the specified
- -i, --injector <injector>
- Set the specified injection type.
Supported injectors are:
preload (Linux, Mac OS)
gdb (Linux. requires gdb to be installed)
- Use the Gammaray 1.x in-process UI. This is not necessary
in most cases, apart from using tools that do not work remotely.
- This will only inject the GammaRay probe into a process,
but not start the GammaRay UI. This is useful for example when doing
remote debugging on embedded devices.
- --listen <address>
- Specify on which network address the GammaRay server should
listen, default is 0.0.0.0 (ie. all of them). This can be used for example
on Windows to avoid firewall warnings by setting the address to 127.0.0.1
if you don't need remote access.
- Disables the GammaRay server. This implies --inprocess as
there is no other way to connect to the GammaRay probe in this case.
- List all installed probes.
- --probe <abi>
- Explicitly specify which probe to use. You should use this
if you have more than one probe installed (e.g. one for Qt4 and one for
Qt5), until probe ABI auto-detection is implemented.
- --connect <host[:port]>
- Connect to a target with an already injected GammaRay
probe. Useful for example for remote debugging.
- Run gammaray on the Qt-application "qtfoo" with
command line arguments 'arg1' and 'arg2':
% gammaray /path/to/qtfoo arg1 arg2
- Invoke gammaray on the Qt-application running with pid
% gammaray --pid 1234
- Invoke gammaray on with injector gdb on Qt-application
running with pid 1234:
% gammaray --injector gdb --pid 1234
Exits with 0 under normal operation; otherwise, exists with a positive integer
indicating a problem occurred while launching or attaching an injector.
Copyright (C) 2010-2014 Klaralvdalens Datakonsult AB, a KDAB Group company,
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
Street, Fifth Floor, Boston, MA 02110-1301, USA.
StackWalker code Copyright (c) 2005-2009, Jochen Kalmbach, All rights reserved.
Volker Krause <firstname.lastname@example.org> (Head Engineer)
Allen Winter <email@example.com>
Andreas Holzammer <firstname.lastname@example.org>
David Faure <email@example.com>
Kevin Funk <firstname.lastname@example.org>
Milian Wolff <email@example.com>
Patrick Spendrin <firstname.lastname@example.org>
Stephen Kelly <email@example.com>
Till Adam <firstname.lastname@example.org>
Tobias Koenig <email@example.com>