trace_sys.h

TRACE的源代码,在LINUX调试程序要使用的.

#ifndef __TRACE_SYS_H
#define __TRACE_SYS_H

/*  This file (trace_sys.h) was created by Ron Rechenmacher <[e-mail]> on
    Oct 27, 1999. "TERMS AND CONDITIONS" governing this file are in the README
    or COPYING file. If you do not have such a file, one can be obtained by
    contacting Ron or Fermi Lab in Batavia IL, 60510, phone: [phone].
*/
#define __TRACE_SYS_H_REV	"\
$RCSfile: trace_sys.h,v $\
$Revision: 1.9 $\
$Date: 2003/05/28 20:37:16 $"

#ifdef __KERNEL__		/* ifdef to allow user space devel. tests */

# include <linux/time.h>	/* struct timeval */
# include <stdarg.h>		/* va_list (This is not part of the kernel
				   source include directory tree but
				   linux/kernel.h includes it so I can too;
				   it's needed.) */ 
#include <linux/version.h>      /* LINUX_VERSION_CODE, KERNEL_VERSION */

#else /* !__KERNEL__ */

# include <sys/time.h>		/* struct timeval */
# include <stdarg.h>		/* va_list */

#endif

#include <asm/trace_processor.h>/* TRACE_PRINT_TIME, TRACE_PRINT_HEADING
				   TRACE_PRINT_SPECIFIC, TRACE_ENTRY_MEMBERS
				   TRACE_ENTRY_TIME, TRACE_ENTRY_SPECIFIC */

extern	char	*tracePrint[];


#ifdef __KERNEL__		/* ifdef to allow user space devel. tests */

#if LINUX_VERSION_CODE >= KERNEL_VERSION(2,4,0)
void
trace_init( void );		/* called from init/main.c */
int
trace_setup( char* );		/* called from init/main.c */
#else
long
trace_init( long, long );       /* called from init/main.c */
void
trace_setup( char*, int* );     /* called from init/main.c */
#endif
void
trace_proc_create( void );	/* called from fs/proc/root.c */

#endif

void
trc_init_entry( int, const char* );/* called in trace.c and trace_proce.c */


int
trace_vsnxprintf(  char		*buf  /* output buffer */
		 , int		outputBufferSize_bytes
		 , int		formatSize_bytes
		 , int		vaListSize_ints
		 , int		*status
		 , const char	*fmt
		 , va_list	args );
int
trace_snxprintf(  char		*buf  /* output buffer */
		, int		outputBufferSize_bytes
		, int		formatSize_bytes
		, int		vaListSize_ints
		, int		*status
		, const char	*fmt
		, ...		);

struct s_traceEntry
{   /*  NOTE: size of this struct is not the size of the entry */
    struct timeval	time;

    TRACE_ENTRY_MEMBERS;

    pid_t		pid;
    int			cpu;
    int			tid;	/* tells if "proc" */
    int			lvl;
    int			messageTruncated; /* on the way into the Q */


    /*  NOTE: data array include:
	o   message
	o   parameters
	o   processor specific (i.e. pentium pro performance registers)
    */
    char		data[0];
};

#ifdef __KERNEL__

extern struct s_tracePrint	traceInitialPrint[];

extern char *trace_c_rev;
extern char *trace_queue_c_rev;
extern char *trace_vsnxprintf_c_rev;

#endif

#endif /* __TRACE_SYS_H */