gcc/doc/gcov-dump.texi

   1 @c Copyright (C) 2017 Free Software Foundation, Inc.
   2 @c This is part of the GCC manual.
   3 @c For copying conditions, see the file gcc.texi.
   4
   5 @ignore
   6 @c man begin COPYRIGHT
   7 Copyright @copyright{} 2017 Free Software Foundation, Inc.
   8
   9 Permission is granted to copy, distribute and/or modify this document
  10 under the terms of the GNU Free Documentation License, Version 1.3 or
  11 any later version published by the Free Software Foundation; with the
  12 Invariant Sections being ``GNU General Public License'' and ``Funding
  13 Free Software'', the Front-Cover texts being (a) (see below), and with
  14 the Back-Cover Texts being (b) (see below).  A copy of the license is
  15 included in the gfdl(7) man page.
  16
  17 (a) The FSF's Front-Cover Text is:
  18
  19      A GNU Manual
  20
  21 (b) The FSF's Back-Cover Text is:
  22
  23      You have freedom to copy and modify this GNU Manual, like GNU
  24      software.  Copies published by the Free Software Foundation raise
  25      funds for GNU development.
  26 @c man end
  27 @c Set file name and title for the man page.
  28 @setfilename gcov-dump
  29 @settitle offline gcda and gcno profile dump tool
  30 @end ignore
  31
  32 @node Gcov-dump
  33 @chapter @command{gcov-dump}---an Offline Gcda and Gcno Profile Dump Tool
  34
  35 @menu
  36 * Gcov-dump Intro::             Introduction to gcov-dump.
  37 * Invoking Gcov-dump::          How to use gcov-dump.
  38 @end menu
  39
  40 @node Gcov-dump Intro
  41 @section Introduction to @command{gcov-dump}
  42 @c man begin DESCRIPTION
  43
  44 @command{gcov-dump} is a tool you can use in conjunction with GCC to
  45 dump content of gcda and gcno profile files offline.
  46
  47 @c man end
  48
  49 @node Invoking Gcov-dump
  50 @section Invoking @command{gcov-dump}
  51
  52 @smallexample
  53 Usage: gcov-dump @r{[}@var{OPTION}@r{]} ... @var{gcovfiles}
  54 @end smallexample
  55
  56 @command{gcov-dump} accepts the following options:
  57
  58 @ignore
  59 @c man begin SYNOPSIS
  60 gcov-dump [@option{-v}|@option{--version}]
  61      [@option{-h}|@option{--help}]
  62      [@option{-l}|@option{--long}]
  63      [@option{-p}|@option{--positions}]
  64      [@option{-w}|@option{--working-sets}] @var{gcovfiles}
  65 @c man end
  66 @end ignore
  67
  68 @c man begin OPTIONS
  69 @table @gcctabopt
  70 @item -h
  71 @itemx --help
  72 Display help about using @command{gcov-dump} (on the standard output), and
  73 exit without doing any further processing.
  74
  75 @item -l
  76 @itemx --long
  77 Dump content of records.
  78
  79 @item -p
  80 @itemx --positions
  81 Dump positions of records.
  82
  83 @item -v
  84 @itemx --version
  85 Display the @command{gcov-dump} version number (on the standard output),
  86 and exit without doing any further processing.
  87
  88 @item -w
  89 @itemx --working-sets
  90 Dump working set computed from summary.
  91 @end table
  92
  93 @c man end