[linux.git] / include / linux / cn_proc.h

/*
 * cn_proc.h - process events connector
 *
 * Copyright (C) Matt Helsley, IBM Corp. 2005
 * Based on cn_fork.h by Nguyen Anh Quynh and Guillaume Thouvenin
 * Copyright (C) 2005 Nguyen Anh Quynh <[email protected]>
 * Copyright (C) 2005 Guillaume Thouvenin <[email protected]>
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of version 2.1 of the GNU Lesser General Public License
 * as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it would be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 */

#ifndef CN_PROC_H
#define CN_PROC_H

#include <linux/types.h>

/*
 * Userspace sends this enum to register with the kernel that it is listening
 * for events on the connector.
 */
enum proc_cn_mcast_op {
	PROC_CN_MCAST_LISTEN = 1,
	PROC_CN_MCAST_IGNORE = 2
};

/*
 * From the user's point of view, the process
 * ID is the thread group ID and thread ID is the internal
 * kernel "pid". So, fields are assigned as follow:
 *
 *  In user space     -  In  kernel space
 *
 * parent process ID  =  parent->tgid
 * parent thread  ID  =  parent->pid
 * child  process ID  =  child->tgid
 * child  thread  ID  =  child->pid
 */

struct proc_event {
	enum what {
		/* Use successive bits so the enums can be used to record
		 * sets of events as well
		 */
		PROC_EVENT_NONE = 0x00000000,
		PROC_EVENT_FORK = 0x00000001,
		PROC_EVENT_EXEC = 0x00000002,
		PROC_EVENT_UID  = 0x00000004,
		PROC_EVENT_GID  = 0x00000040,
		/* "next" should be 0x00000400 */
		/* "last" is the last process event: exit */
		PROC_EVENT_EXIT = 0x80000000
	} what;
	__u32 cpu;
	__u64 __attribute__((aligned(8))) timestamp_ns;
		/* Number of nano seconds since system boot */
	union { /* must be last field of proc_event struct */
		struct {
			__u32 err;
		} ack;

		struct fork_proc_event {
			pid_t parent_pid;
			pid_t parent_tgid;
			pid_t child_pid;
			pid_t child_tgid;
		} fork;

		struct exec_proc_event {
			pid_t process_pid;
			pid_t process_tgid;
		} exec;

		struct id_proc_event {
			pid_t process_pid;
			pid_t process_tgid;
			union {
				__u32 ruid; /* task uid */
				__u32 rgid; /* task gid */
			} r;
			union {
				__u32 euid;
				__u32 egid;
			} e;
		} id;

		struct exit_proc_event {
			pid_t process_pid;
			pid_t process_tgid;
			__u32 exit_code, exit_signal;
		} exit;
	} event_data;
};

#ifdef __KERNEL__
#ifdef CONFIG_PROC_EVENTS
void proc_fork_connector(struct task_struct *task);
void proc_exec_connector(struct task_struct *task);
void proc_id_connector(struct task_struct *task, int which_id);
void proc_exit_connector(struct task_struct *task);
#else
static inline void proc_fork_connector(struct task_struct *task)
{}

static inline void proc_exec_connector(struct task_struct *task)
{}

static inline void proc_id_connector(struct task_struct *task,
				     int which_id)
{}

static inline void proc_exit_connector(struct task_struct *task)
{}
#endif	/* CONFIG_PROC_EVENTS */
#endif	/* __KERNEL__ */
#endif	/* CN_PROC_H */
Commit	Line	Data
9f46080c MH	1	/*
	2	* cn_proc.h - process events connector
	3	*
	4	* Copyright (C) Matt Helsley, IBM Corp. 2005
	5	* Based on cn_fork.h by Nguyen Anh Quynh and Guillaume Thouvenin
9f46080c MH	6	* Copyright (C) 2005 Nguyen Anh Quynh <[email protected]>
	7	* Copyright (C) 2005 Guillaume Thouvenin <[email protected]>
	8	*
3fa2164d MH	9	* This program is free software; you can redistribute it and/or modify it
	10	* under the terms of version 2.1 of the GNU Lesser General Public License
	11	* as published by the Free Software Foundation.
9f46080c	12	*
3fa2164d MH	13	* This program is distributed in the hope that it would be useful, but
	14	* WITHOUT ANY WARRANTY; without even the implied warranty of
	15	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
9f46080c MH	16	*/
	17
	18	#ifndef CN_PROC_H
	19	#define CN_PROC_H
	20
	21	#include <linux/types.h>
9f46080c MH	22
	23	/*
	24	* Userspace sends this enum to register with the kernel that it is listening
	25	* for events on the connector.
	26	*/
	27	enum proc_cn_mcast_op {
	28	PROC_CN_MCAST_LISTEN = 1,
	29	PROC_CN_MCAST_IGNORE = 2
	30	};
	31
	32	/*
	33	* From the user's point of view, the process
	34	* ID is the thread group ID and thread ID is the internal
	35	* kernel "pid". So, fields are assigned as follow:
	36	*
	37	* In user space - In kernel space
	38	*
	39	* parent process ID = parent->tgid
	40	* parent thread ID = parent->pid
	41	* child process ID = child->tgid
	42	* child thread ID = child->pid
	43	*/
	44
	45	struct proc_event {
	46	enum what {
	47	/* Use successive bits so the enums can be used to record
	48	* sets of events as well
	49	*/
	50	PROC_EVENT_NONE = 0x00000000,
	51	PROC_EVENT_FORK = 0x00000001,
	52	PROC_EVENT_EXEC = 0x00000002,
	53	PROC_EVENT_UID = 0x00000004,
	54	PROC_EVENT_GID = 0x00000040,
	55	/* "next" should be 0x00000400 */
	56	/* "last" is the last process event: exit */
	57	PROC_EVENT_EXIT = 0x80000000
	58	} what;
	59	__u32 cpu;
822cfbff CS	60	__u64 __attribute__((aligned(8))) timestamp_ns;
822cfbff CS	61	/* Number of nano seconds since system boot */
9f46080c MH	62	union { /* must be last field of proc_event struct */
	63	struct {
	64	__u32 err;
	65	} ack;
	66
	67	struct fork_proc_event {
	68	pid_t parent_pid;
	69	pid_t parent_tgid;
	70	pid_t child_pid;
	71	pid_t child_tgid;
	72	} fork;
	73
	74	struct exec_proc_event {
	75	pid_t process_pid;
	76	pid_t process_tgid;
	77	} exec;
	78
	79	struct id_proc_event {
	80	pid_t process_pid;
	81	pid_t process_tgid;
	82	union {
df69a60d MH	83	__u32 ruid; /* task uid */
df69a60d MH	84	__u32 rgid; /* task gid */
9f46080c MH	85	} r;
9f46080c MH	86	union {
df69a60d MH	87	__u32 euid;
df69a60d MH	88	__u32 egid;
9f46080c MH	89	} e;
	90	} id;
	91
	92	struct exit_proc_event {
	93	pid_t process_pid;
	94	pid_t process_tgid;
	95	__u32 exit_code, exit_signal;
	96	} exit;
	97	} event_data;
	98	};
	99
	100	#ifdef __KERNEL__
	101	#ifdef CONFIG_PROC_EVENTS
	102	void proc_fork_connector(struct task_struct *task);
	103	void proc_exec_connector(struct task_struct *task);
	104	void proc_id_connector(struct task_struct *task, int which_id);
	105	void proc_exit_connector(struct task_struct *task);
	106	#else
	107	static inline void proc_fork_connector(struct task_struct *task)
	108	{}
	109
	110	static inline void proc_exec_connector(struct task_struct *task)
	111	{}
	112
	113	static inline void proc_id_connector(struct task_struct *task,
	114	int which_id)
	115	{}
	116
	117	static inline void proc_exit_connector(struct task_struct *task)
	118	{}
	119	#endif /* CONFIG_PROC_EVENTS */
	120	#endif /* __KERNEL__ */
	121	#endif /* CN_PROC_H */