[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 <glib.h>
#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>

/* 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("state.insertion_time (double)\n");
  g_print("state.process_name (string)\n");
  g_print("state.thread_brand (string)\n");
  g_print("state.execution_mode (string)\n");
  g_print("state.execution_submode (string)\n");
  g_print("state.process_status (string)\n");
  g_print("state.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
4ec0c904	32	#include <glib.h>
a58509ee	33	#include <lttv/lttv.h>
	34	#include <lttv/option.h>
	35	#include <lttv/module.h>
	36	#include <lttv/hook.h>
	37	#include <lttv/attribute.h>
	38	#include <lttv/iattribute.h>
	39	#include <lttv/stats.h>
	40	#include <lttv/filter.h>
	41	#include <ltt/ltt.h>
	42	#include <ltt/event.h>
	43	#include <ltt/type.h>
	44	#include <ltt/trace.h>
	45	#include <ltt/facility.h>
a58509ee	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
4ec0c904	90	if(((GString)(value.v_pointer))->len != 0)
4ec0c904	91	g_string_append_c((GString)(value.v_pointer),'&');
4ec0c904	92	g_string_append_c((GString)(value.v_pointer),'(');
4ec0c904	93	g_string_append((GString)(value.v_pointer),a_file_content);
4ec0c904	94	g_string_append_c((GString)(value.v_pointer),')');
56e29124	95
91ad3f0a	96	}
	97
	98	/**
	99	* filters the string input from user
bd523c6f	100	* @param hook_data the hook data, unused
91ad3f0a	101	*/
	102	void filter_analyze_string(void *hook_data) {
	103
73050a5f	104	LttvAttributeValue value;
	105
	106	LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());
	107
91ad3f0a	108	/*
	109	* User may specify filtering options through static file
	110	* and/or command line string. From these sources, an
	111	* option string is rebuilded and sent to the filter core
	112	*/
73050a5f	113	g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
73050a5f	114	LTTV_POINTER, &value));
cec3d7b0	115
4ec0c904	116	if(((GString)(value.v_pointer))->len != 0)
4ec0c904	117	g_string_append_c((GString)(value.v_pointer),'&');
4ec0c904	118	g_string_append_c((GString)(value.v_pointer),'(');
4ec0c904	119	g_string_append((GString)(value.v_pointer),a_string);
4ec0c904	120	g_string_append_c((GString)(value.v_pointer),')');
56e29124	121
a58509ee	122	}
a58509ee	123
bd523c6f	124	/**
	125	* Output all filter commands on console
	126	* @param hook_data the hook data
	127	*/
	128	void filter_list_commands(void *hook_data) {
	129
	130	g_print("[field] [op] [value]\n\n");
	131
	132	g_print("* Possible fields *\n");
	133	g_print("event.name (string)\n");
ffd088ef	134	g_print("event.facility (string)\n");
bd523c6f	135	g_print("event.category (string)\n");
	136	g_print("event.time (double)\n");
	137	g_print("event.tsc (integer)\n");
c56a714e	138	g_print("event.field.facility_name.event_name.field_name.subfield_name (field_type)\n");
bd523c6f	139	g_print("tracefile.name (string)\n");
	140	g_print("trace.name (string)\n");
	141	g_print("state.pid (integer)\n");
	142	g_print("state.ppid (integer)\n");
	143	g_print("state.creation_time (double)\n");
7b5f6cf1	144	g_print("state.insertion_time (double)\n");
	145	g_print("state.process_name (string)\n");
	146	g_print("state.thread_brand (string)\n");
	147	g_print("state.execution_mode (string)\n");
	148	g_print("state.execution_submode (string)\n");
	149	g_print("state.process_status (string)\n");
	150	g_print("state.cpu (string)\n\n");
bd523c6f	151
	152	g_print("* Possible operators *\n");
	153	g_print("equal '='\n");
	154	g_print("not equal '!='\n");
	155	g_print("greater '>'\n");
	156	g_print("greater or equal '>='\n");
	157	g_print("lower '<'\n");
	158	g_print("lower or equal '<='\n");
	159
	160	g_print("* Possible values *\n");
	161	g_print("string, integer, double");
	162	}
	163
a58509ee	164	/**
	165	* initialize the new module
	166	*/
	167	static void init() {
	168
a58509ee	169	LttvAttributeValue value;
	170
	171	LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());
	172
73050a5f	173	g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
	174	LTTV_POINTER, &value));
	175
	176	*(value.v_pointer) = g_string_new("");
	177
a58509ee	178	g_info("Init textFilter.c");
cec3d7b0	179
91ad3f0a	180	a_string = NULL;
73050a5f	181	lttv_option_add("expression", 'e',
a58509ee	182	"filters a string issued by the user on the command line",
a58509ee	183	"string",
91ad3f0a	184	LTTV_OPT_STRING, &a_string, filter_analyze_string, NULL);
1a7fa682	185	// add function to call for option
1a7fa682	186
a58509ee	187	a_file_name = NULL;
	188	lttv_option_add("filename", 'f',
	189	"browse the filter options contained in specified file",
	190	"file name",
91ad3f0a	191	LTTV_OPT_STRING, &a_file_name, filter_analyze_file, NULL);
a58509ee	192
bd523c6f	193	lttv_option_add("list", 'l',
	194	"list all possible filter commands for module",
	195	"list commands",
	196	LTTV_OPT_NONE, NULL, filter_list_commands, NULL);
	197
a58509ee	198	}
	199
	200	/**
	201	* Destroy the current module
	202	*/
	203	static void destroy() {
	204	g_info("Destroy textFilter");
	205
73050a5f	206	lttv_option_remove("expression");
a58509ee	207
	208	lttv_option_remove("filename");
	209
bd523c6f	210	lttv_option_remove("list");
bd523c6f	211
73050a5f	212	LttvAttributeValue value;
	213
	214	LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());
a58509ee	215
73050a5f	216	g_assert(lttv_iattribute_find_by_path(attributes, "filter/expression",
	217	LTTV_POINTER, &value));
	218
	219	g_string_free((GString)(value.v_pointer),TRUE);
a58509ee	220
	221	}
	222
	223
	224	LTTV_MODULE("textFilter", "Filters traces", \
	225	"Filter the trace following commands issued by user input", \
73050a5f	226	init, destroy, "option")
a58509ee	227