.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "GAMMARAY 1" .TH GAMMARAY 1 "2014-06-29" "2.1.0" "KDAB Products" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" GammaRay \- Qt\-application inspection and manipulation tool. .SH "SYNOPSIS" .IX Header "SYNOPSIS" gammaray [\-\-pid | | \-\-connect [:] .SH "DESCRIPTION" .IX Header "DESCRIPTION" GammaRay inspects runtime internals of a Qt-application, such as: Object tree, properties, signal/slots, widgets, models, graphics views, javascript debugger, resources, state machines, meta types, fonts, codecs, text documents .PP 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). .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-\-help\fR" 4 .IX Item "--help" Print help message and exit. .IP "\fB\-\-version\fR" 4 .IX Item "--version" Print version information and exit. .IP "\fB\-p, \-\-pid " 4 .IX Item "-p, --pid " Attach to running Qt application with the specified pid. .IP "\fB\-i, \-\-injector " 4 .IX Item "-i, --injector " Set the specified injection type. .Sp Supported injectors are: preload (Linux, Mac \s-1OS\s0) gdb (Linux. requires gdb to be installed) style windll (Windows) .IP "\fB\-\-inprocess\fR" 4 .IX Item "--inprocess" Use the Gammaray 1.x in-process \s-1UI.\s0 This is not necessary in most cases, apart from using tools that do not work remotely. .IP "\fB\-\-inject\-only\fR" 4 .IX Item "--inject-only" This will only inject the GammaRay probe into a process, but not start the GammaRay \s-1UI.\s0 This is useful for example when doing remote debugging on embedded devices. .IP "\fB\-\-listen " 4 .IX Item "--listen
" 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. .IP "\fB\-\-no\-listen\fR" 4 .IX Item "--no-listen" Disables the GammaRay server. This implies \-\-inprocess as there is no other way to connect to the GammaRay probe in this case. .IP "\fB\-\-list\-probes\fR" 4 .IX Item "--list-probes" List all installed probes. .IP "\fB\-\-probe " 4 .IX Item "--probe " 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 \s-1ABI\s0 auto-detection is implemented. .IP "\fB\-\-connect " 4 .IX Item "--connect " Connect to a target with an already injected GammaRay probe. Useful for example for remote debugging. .SH "EXAMPLES" .IX Header "EXAMPLES" .ie n .IP "Run gammaray on the Qt-application ""qtfoo"" with command line arguments 'arg1' and 'arg2':" 4 .el .IP "Run gammaray on the Qt-application \f(CWqtfoo\fR with command line arguments 'arg1' and 'arg2':" 4 .IX Item "Run gammaray on the Qt-application qtfoo with command line arguments 'arg1' and 'arg2':" .Vb 1 \& % gammaray /path/to/qtfoo arg1 arg2 .Ve .IP "Invoke gammaray on the Qt-application running with pid 1234:" 4 .IX Item "Invoke gammaray on the Qt-application running with pid 1234:" .Vb 1 \& % gammaray \-\-pid 1234 .Ve .IP "Invoke gammaray on with injector gdb on Qt-application running with pid 1234:" 4 .IX Item "Invoke gammaray on with injector gdb on Qt-application running with pid 1234:" .Vb 1 \& % gammaray \-\-injector gdb \-\-pid 1234 .Ve .SH "EXIT STATUS" .IX Header "EXIT STATUS" Exits with 0 under normal operation; otherwise, exists with a positive integer indicating a problem occurred while launching or attaching an injector. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (C) 2010\-2014 Klaralvdalens Datakonsult \s-1AB,\s0 a \s-1KDAB\s0 Group company, .PP This program is free software; you can redistribute it and/or modify it under the terms of the \s-1GNU\s0 General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. .PP This program is distributed in the hope that it will be useful, but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of \&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \&\s-1GNU\s0 General Public License for more details. .PP You should have received a copy of the \s-1GNU\s0 General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301, USA.\s0 .PP StackWalker code Copyright (c) 2005\-2009, Jochen Kalmbach, All rights reserved. .SH "AUTHORS" .IX Header "AUTHORS" .Vb 10 \& Volker Krause (Head Engineer) \& Allen Winter \& Andreas Holzammer \& David Faure \& Kevin Funk \& Milian Wolff \& Patrick Spendrin \& Stephen Kelly \& Till Adam \& Tobias Koenig .Ve