[lttv.git] / ltt / branches / poly / lttv / modules / text / textFilter.c

/* This file is part of the Linux Trace Toolkit viewer
 * Copyright (C) 2005 Simon Bouvier-Zappa 
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License Version 2 as
 * published by the Free Software Foundation;
 *
 * 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., 59 Temple Place - Suite 330, Boston, 
 * MA 02111-1307, USA.
 */

/*! \file lttv/modules/text/textFilter.c
 *  \brief Textual prompt for user filtering expression.
 *  
 *  The text filter facility will prompt for user filter option 
 *  and transmit them to the lttv core.  User can either specify 
 *  a filtering string with the command line or/and specify a 
 *  file containing filtering expressions.
 */

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#include <lttv/lttv.h>
#include <lttv/option.h>
#include <lttv/module.h>
#include <lttv/hook.h>
#include <lttv/attribute.h>
#include <lttv/iattribute.h>
#include <lttv/stats.h>
#include <lttv/filter.h>
#include <ltt/ltt.h>
#include <ltt/event.h>
#include <ltt/type.h>
#include <ltt/trace.h>
#include <ltt/facility.h>
#include <stdio.h>

/* Insert the hooks before and after each trace and tracefile, and for each
   event. Print a global header. */

/*
 *  TODO
 *  - specify wich hook function will be used to call the core filter
 */

static char 
  *a_file_name = NULL,
  *a_string = NULL;

static LttvHooks
  *before_traceset,
  *event_hook;

/**
 * filters the file input from user
 * @param hook_data the hook data, unused
 */
void filter_analyze_file(void *hook_data) {

  LttvAttributeValue value;

  LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());

  /*
	 * 	User may specify filtering options through static file
	 * 	and/or command line string.  From these sources, an 
	 * 	option string is rebuilded and sent to the filter core
	 */
  if(!g_file_test(a_file_name,G_FILE_TEST_EXISTS)) {
    g_warning("file %s does not exist", a_file_name);
    return;
  }

  char* a_file_content = NULL;

  g_file_get_contents(a_file_name,&a_file_content,NULL,NULL);
  
  g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
      LTTV_POINTER, &value));

  if(((GString*)*(value.v_pointer))->len != 0) g_string_append_c((GString*)*(value.v_pointer),'&');
  g_string_append_c((GString*)*(value.v_pointer),'(');
  g_string_append((GString*)*(value.v_pointer),a_file_content);
  g_string_append_c((GString*)*(value.v_pointer),')');
  
}

/**
 * filters the string input from user
 * @param hook_data the hook data, unused
 */
void filter_analyze_string(void *hook_data) {

  LttvAttributeValue value;

  LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());
  
  /*
	 * 	User may specify filtering options through static file
	 * 	and/or command line string.  From these sources, an 
	 * 	option string is rebuilded and sent to the filter core
	 */
  g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
      LTTV_POINTER, &value));

  if(((GString*)*(value.v_pointer))->len != 0) g_string_append_c((GString*)*(value.v_pointer),'&');
  g_string_append_c((GString*)*(value.v_pointer),'(');
  g_string_append((GString*)*(value.v_pointer),a_string);
  g_string_append_c((GString*)*(value.v_pointer),')');

}

/**
 * Output all filter commands on console 
 * @param hook_data the hook data
 */
void filter_list_commands(void *hook_data) {

  g_print("[field] [op] [value]\n\n");

  g_print("*** Possible fields ***\n");
  g_print("event.name (string)\n");
  g_print("event.facility (string)\n");
  g_print("event.category (string)\n");
  g_print("event.time (double)\n");
  g_print("event.tsc (integer)\n");
  g_print("event.field.facility_name.event_name.field_name.subfield_name (field_type)\n");
  g_print("tracefile.name (string)\n");
  g_print("trace.name (string)\n");
  g_print("state.pid (integer)\n");
  g_print("state.ppid (integer)\n");
  g_print("state.creation_time (double)\n");
  g_print("trace.insertion_time (double)\n");
  g_print("trace.process_name (string)\n");
  g_print("trace.execution_mode (string)\n");
  g_print("trace.execution_submode (string)\n");
  g_print("trace.process_status (string)\n");
  g_print("trace.cpu (string)\n\n");
  
  g_print("*** Possible operators ***\n");
  g_print("equal '='\n");
  g_print("not equal '!='\n");
  g_print("greater '>'\n");
  g_print("greater or equal '>='\n");
  g_print("lower '<'\n");
  g_print("lower or equal '<='\n");
 
  g_print("*** Possible values ***\n");
  g_print("string, integer, double");
}

/**
 * 	initialize the new module
 */
static void init() {
  
  LttvAttributeValue value;

  LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());

  g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
      LTTV_POINTER, &value));
  
  *(value.v_pointer) = g_string_new("");

  g_info("Init textFilter.c");
 
  a_string = NULL;
  lttv_option_add("expression", 'e', 
      "filters a string issued by the user on the command line", 
      "string", 
      LTTV_OPT_STRING, &a_string, filter_analyze_string, NULL);
  // add function to call for option
  
  a_file_name = NULL;
  lttv_option_add("filename", 'f', 
      "browse the filter options contained in specified file", 
      "file name", 
      LTTV_OPT_STRING, &a_file_name, filter_analyze_file, NULL);

  lttv_option_add("list", 'l',
      "list all possible filter commands for module",
      "list commands",
      LTTV_OPT_NONE, NULL, filter_list_commands, NULL);
  
}

/**
 * 	Destroy the current module
 */
static void destroy() {
  g_info("Destroy textFilter");

  lttv_option_remove("expression");

  lttv_option_remove("filename");

  lttv_option_remove("list");

  LttvAttributeValue value;

  LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());

  g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
      LTTV_POINTER, &value));
 
  g_string_free((GString*)*(value.v_pointer),TRUE);
  
}


LTTV_MODULE("textFilter", "Filters traces", \
	    "Filter the trace following commands issued by user input", \
	    init, destroy, "option")
Commit	Line	Data
a58509ee	1	/* This file is part of the Linux Trace Toolkit viewer
852f16bb	2	* Copyright (C) 2005 Simon Bouvier-Zappa
a58509ee	3	*
	4	* This program is free software; you can redistribute it and/or modify
	5	* it under the terms of the GNU General Public License Version 2 as
	6	* published by the Free Software Foundation;
	7	*
	8	* This program is distributed in the hope that it will be useful,
	9	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	10	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	11	* GNU General Public License for more details.
	12	*
	13	* You should have received a copy of the GNU General Public License
	14	* along with this program; if not, write to the Free Software
	15	* Foundation, Inc., 59 Temple Place - Suite 330, Boston,
	16	* MA 02111-1307, USA.
	17	*/
	18
7e7af7f2	19	/*! \file lttv/modules/text/textFilter.c
	20	* \brief Textual prompt for user filtering expression.
	21	*
	22	* The text filter facility will prompt for user filter option
	23	* and transmit them to the lttv core. User can either specify
	24	* a filtering string with the command line or/and specify a
	25	* file containing filtering expressions.
91ad3f0a	26	*/
a58509ee	27
4e4d11b3	28	#ifdef HAVE_CONFIG_H
	29	#include <config.h>
	30	#endif
	31
a58509ee	32	#include <lttv/lttv.h>
	33	#include <lttv/option.h>
	34	#include <lttv/module.h>
	35	#include <lttv/hook.h>
	36	#include <lttv/attribute.h>
	37	#include <lttv/iattribute.h>
	38	#include <lttv/stats.h>
	39	#include <lttv/filter.h>
	40	#include <ltt/ltt.h>
	41	#include <ltt/event.h>
	42	#include <ltt/type.h>
	43	#include <ltt/trace.h>
	44	#include <ltt/facility.h>
	45	#include <stdio.h>
	46
	47	/* Insert the hooks before and after each trace and tracefile, and for each
	48	event. Print a global header. */
	49
1601b365	50	/*
	51	* TODO
	52	* - specify wich hook function will be used to call the core filter
	53	*/
	54
91ad3f0a	55	static char
a58509ee	56	*a_file_name = NULL,
91ad3f0a	57	*a_string = NULL;
91ad3f0a	58
a58509ee	59	static LttvHooks
	60	*before_traceset,
	61	*event_hook;
	62
a58509ee	63	/**
91ad3f0a	64	* filters the file input from user
bd523c6f	65	* @param hook_data the hook data, unused
a58509ee	66	*/
91ad3f0a	67	void filter_analyze_file(void *hook_data) {
91ad3f0a	68
73050a5f	69	LttvAttributeValue value;
	70
	71	LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());
	72
91ad3f0a	73	/*
a58509ee	74	* User may specify filtering options through static file
	75	* and/or command line string. From these sources, an
	76	* option string is rebuilded and sent to the filter core
	77	*/
c684db06	78	if(!g_file_test(a_file_name,G_FILE_TEST_EXISTS)) {
	79	g_warning("file %s does not exist", a_file_name);
	80	return;
	81	}
	82
	83	char* a_file_content = NULL;
	84
	85	g_file_get_contents(a_file_name,&a_file_content,NULL,NULL);
91ad3f0a	86
73050a5f	87	g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
	88	LTTV_POINTER, &value));
	89
73050a5f	90	if(((GString)(value.v_pointer))->len != 0) g_string_append_c((GString)(value.v_pointer),'&');
c684db06	91	g_string_append_c((GString)(value.v_pointer),'(');
	92	g_string_append((GString)(value.v_pointer),a_file_content);
	93	g_string_append_c((GString)(value.v_pointer),')');
56e29124	94
91ad3f0a	95	}
	96
	97	/**
	98	* filters the string input from user
bd523c6f	99	* @param hook_data the hook data, unused
91ad3f0a	100	*/
	101	void filter_analyze_string(void *hook_data) {
	102
73050a5f	103	LttvAttributeValue value;
	104
	105	LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());
	106
91ad3f0a	107	/*
	108	* User may specify filtering options through static file
	109	* and/or command line string. From these sources, an
	110	* option string is rebuilded and sent to the filter core
	111	*/
73050a5f	112	g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
73050a5f	113	LTTV_POINTER, &value));
cec3d7b0	114
73050a5f	115	if(((GString)(value.v_pointer))->len != 0) g_string_append_c((GString)(value.v_pointer),'&');
c684db06	116	g_string_append_c((GString)(value.v_pointer),'(');
73050a5f	117	g_string_append((GString)(value.v_pointer),a_string);
c684db06	118	g_string_append_c((GString)(value.v_pointer),')');
56e29124	119
a58509ee	120	}
a58509ee	121
bd523c6f	122	/**
	123	* Output all filter commands on console
	124	* @param hook_data the hook data
	125	*/
	126	void filter_list_commands(void *hook_data) {
	127
	128	g_print("[field] [op] [value]\n\n");
	129
	130	g_print("* Possible fields *\n");
	131	g_print("event.name (string)\n");
ffd088ef	132	g_print("event.facility (string)\n");
bd523c6f	133	g_print("event.category (string)\n");
	134	g_print("event.time (double)\n");
	135	g_print("event.tsc (integer)\n");
c56a714e	136	g_print("event.field.facility_name.event_name.field_name.subfield_name (field_type)\n");
bd523c6f	137	g_print("tracefile.name (string)\n");
	138	g_print("trace.name (string)\n");
	139	g_print("state.pid (integer)\n");
	140	g_print("state.ppid (integer)\n");
	141	g_print("state.creation_time (double)\n");
	142	g_print("trace.insertion_time (double)\n");
	143	g_print("trace.process_name (string)\n");
	144	g_print("trace.execution_mode (string)\n");
	145	g_print("trace.execution_submode (string)\n");
	146	g_print("trace.process_status (string)\n");
	147	g_print("trace.cpu (string)\n\n");
	148
	149	g_print("* Possible operators *\n");
	150	g_print("equal '='\n");
	151	g_print("not equal '!='\n");
	152	g_print("greater '>'\n");
	153	g_print("greater or equal '>='\n");
	154	g_print("lower '<'\n");
	155	g_print("lower or equal '<='\n");
	156
	157	g_print("* Possible values *\n");
	158	g_print("string, integer, double");
	159	}
	160
a58509ee	161	/**
	162	* initialize the new module
	163	*/
	164	static void init() {
	165
a58509ee	166	LttvAttributeValue value;
	167
	168	LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());
	169
73050a5f	170	g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
	171	LTTV_POINTER, &value));
	172
	173	*(value.v_pointer) = g_string_new("");
	174
a58509ee	175	g_info("Init textFilter.c");
cec3d7b0	176
91ad3f0a	177	a_string = NULL;
73050a5f	178	lttv_option_add("expression", 'e',
a58509ee	179	"filters a string issued by the user on the command line",
a58509ee	180	"string",
91ad3f0a	181	LTTV_OPT_STRING, &a_string, filter_analyze_string, NULL);
1a7fa682	182	// add function to call for option
1a7fa682	183
a58509ee	184	a_file_name = NULL;
	185	lttv_option_add("filename", 'f',
	186	"browse the filter options contained in specified file",
	187	"file name",
91ad3f0a	188	LTTV_OPT_STRING, &a_file_name, filter_analyze_file, NULL);
a58509ee	189
bd523c6f	190	lttv_option_add("list", 'l',
	191	"list all possible filter commands for module",
	192	"list commands",
	193	LTTV_OPT_NONE, NULL, filter_list_commands, NULL);
	194
a58509ee	195	}
	196
	197	/**
	198	* Destroy the current module
	199	*/
	200	static void destroy() {
	201	g_info("Destroy textFilter");
	202
73050a5f	203	lttv_option_remove("expression");
a58509ee	204
	205	lttv_option_remove("filename");
	206
bd523c6f	207	lttv_option_remove("list");
bd523c6f	208
73050a5f	209	LttvAttributeValue value;
	210
	211	LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());
a58509ee	212
73050a5f	213	g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
	214	LTTV_POINTER, &value));
	215
	216	g_string_free((GString)(value.v_pointer),TRUE);
a58509ee	217
	218	}
	219
	220
	221	LTTV_MODULE("textFilter", "Filters traces", \
	222	"Filter the trace following commands issued by user input", \
73050a5f	223	init, destroy, "option")
a58509ee	224