Move and update documentation

[lttv.git] / lttv / lttv / sync / event_processing.h

/* This file is part of the Linux Trace Toolkit viewer
 * Copyright (C) 2009, 2010 Benjamin Poirier <benjamin.poirier@polymtl.ca>
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 2.1 of the License, or (at
 * your option) any later version.
 *
 * 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 Lesser General Public
 * License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef EVENT_PROCESSING_H
#define EVENT_PROCESSING_H

#include <glib.h>
#include <stdio.h>

#include "data_structures.h"
#include "graph_functions.h"


struct _SyncState;

typedef struct
{
	char* name;

	/*
	 * This function is called at the beginning of a synchronization run for a
	 * set of traces. Allocate and initialize data structures for
	 * synchronizing a traceset.
	 */
	void (*initProcessing)(struct _SyncState* const syncStateLttv, ...);

	/*
	 * Obtain the factors from downstream.
	 */
	AllFactors* (*finalizeProcessing)(struct _SyncState* const syncState);

	/*
	 * Print statistics related to processing. Is always called after
	 * finalizeProcessing.
	 */
	void (*printProcessingStats)(struct _SyncState* const syncState);

	/*
	 * Deallocate processingData. No more functions may be called after this.
	 */
	void (*destroyProcessing)(struct _SyncState* const syncState);

	/*
	 * Write the processing-specific options and graph commands in the gnuplot
	 * script. Is always called after finalizeProcessing.
	 */
	GraphFunctions graphFunctions;
} ProcessingModule;

#endif