Difference between revisions of "VPP/g2"

From fd.io
< VPP
Jump to: navigation, search
(Created page with "=== Introduction === G2 is a fine-grained event-log viewer. It's highly scalable, supporting O(1e6 events) and O(1e3 discrete display "tracks"). G2 displays binary data gener...")
 
m (Introduction)
Line 2: Line 2:
  
 
G2 is a fine-grained event-log viewer. It's highly scalable, supporting O(1e6 events) and O(1e3 discrete display "tracks"). G2 displays binary data generated by the vppinfra "elog.[ch]" logger component. G2 also supports for the CPEL file format, described [[VPP/cpel | here]].
 
G2 is a fine-grained event-log viewer. It's highly scalable, supporting O(1e6 events) and O(1e3 discrete display "tracks"). G2 displays binary data generated by the vppinfra "elog.[ch]" logger component. G2 also supports for the CPEL file format, described [[VPP/cpel | here]].
 +
 +
=== Usage ===
 +
 +
$ cd build-root
 +
$ make g2-install
 +
$ ./install-native/g2/bin/g2 --help
 +
g2 [--ticks-per-us <value>][--cpel-input <filename>] [--clib-input <filename]>
 +
G2 (x86_64 GNU/Linux) major version 3.0
 +
Built Wed Feb  3 10:58:12 EST 2016
 +
 +
When viewing a ".cpel" file, use "g2 --cpel <filename>". When viewing a vppinfra event log, use "g2 --clib <filename>".
 +
 +
==== Setting Display Preferences ====
 +
 +
The file $HOMEDIR/.g2 contains display preferences, which can be overridden. Simply un-comment one of the stanzas shown below, or experiment as desired. 
 +
 +
/*
 +
  * Property / parameter settings for G2
 +
  *
 +
  * Setting for a 1024x768 display:
 +
  * event_selector_lines=20
 +
  * drawbox_height=800
 +
  * drawbox_width=600
 +
  *
 +
  * new mac w/ no monitor:
 +
  * event_selector_lines=20
 +
  * drawbox_height=1200
 +
  * drawbox_width=700
 +
  *
 +
  * 1600x1200:
 +
  * drawbox_width=1200
 +
  * drawbox_height=1000
 +
  * event_selector_lines=25
 +
  *
 +
  * for making screenshots on a Macbook Pro
 +
  * drawbox_width=1200
 +
  * drawbox_height=600
 +
  * event_selector_lines=20
 +
  */

Revision as of 18:40, 12 February 2016

Introduction

G2 is a fine-grained event-log viewer. It's highly scalable, supporting O(1e6 events) and O(1e3 discrete display "tracks"). G2 displays binary data generated by the vppinfra "elog.[ch]" logger component. G2 also supports for the CPEL file format, described here.

Usage

$ cd build-root
$ make g2-install
$ ./install-native/g2/bin/g2 --help
g2 [--ticks-per-us <value>][--cpel-input <filename>] [--clib-input <filename]>
G2 (x86_64 GNU/Linux) major version 3.0
Built Wed Feb  3 10:58:12 EST 2016

When viewing a ".cpel" file, use "g2 --cpel <filename>". When viewing a vppinfra event log, use "g2 --clib <filename>".

Setting Display Preferences

The file $HOMEDIR/.g2 contains display preferences, which can be overridden. Simply un-comment one of the stanzas shown below, or experiment as desired.

/*
 * Property / parameter settings for G2
 *
 * Setting for a 1024x768 display:
 * event_selector_lines=20
 * drawbox_height=800
 * drawbox_width=600
 * 
 * new mac w/ no monitor:
 * event_selector_lines=20
 * drawbox_height=1200
 * drawbox_width=700
 *
 * 1600x1200:
 * drawbox_width=1200
 * drawbox_height=1000
 * event_selector_lines=25
 * 
 * for making screenshots on a Macbook Pro
 * drawbox_width=1200
 * drawbox_height=600
 * event_selector_lines=20
 */