[net-next-2.6.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 <aquynh@gmail.com>
 * Copyright (C) 2005 Guillaume Thouvenin <guillaume.thouvenin@bull.net>
 *
 * 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,
		PROC_EVENT_SID  = 0x00000080,
		/* "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 {
			__kernel_pid_t parent_pid;
			__kernel_pid_t parent_tgid;
			__kernel_pid_t child_pid;
			__kernel_pid_t child_tgid;
		} fork;

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

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

		struct sid_proc_event {
			__kernel_pid_t process_pid;
			__kernel_pid_t process_tgid;
		} sid;

		struct exit_proc_event {
			__kernel_pid_t process_pid;
			__kernel_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_sid_connector(struct task_struct *task);
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_sid_connector(struct task_struct *task)
{}

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 <aquynh@gmail.com>
	7	* Copyright (C) 2005 Guillaume Thouvenin <guillaume.thouvenin@bull.net>
	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,
02b51df1	55	PROC_EVENT_SID = 0x00000080,
9f46080c MH	56	/* "next" should be 0x00000400 */
	57	/* "last" is the last process event: exit */
	58	PROC_EVENT_EXIT = 0x80000000
	59	} what;
	60	__u32 cpu;
822cfbff CS	61	__u64 __attribute__((aligned(8))) timestamp_ns;
822cfbff CS	62	/* Number of nano seconds since system boot */
9f46080c MH	63	union { /* must be last field of proc_event struct */
	64	struct {
	65	__u32 err;
	66	} ack;
	67
	68	struct fork_proc_event {
85efde6f AB	69	__kernel_pid_t parent_pid;
	70	__kernel_pid_t parent_tgid;
	71	__kernel_pid_t child_pid;
	72	__kernel_pid_t child_tgid;
9f46080c MH	73	} fork;
	74
	75	struct exec_proc_event {
85efde6f AB	76	__kernel_pid_t process_pid;
85efde6f AB	77	__kernel_pid_t process_tgid;
9f46080c MH	78	} exec;
	79
	80	struct id_proc_event {
85efde6f AB	81	__kernel_pid_t process_pid;
85efde6f AB	82	__kernel_pid_t process_tgid;
9f46080c	83	union {
df69a60d MH	84	__u32 ruid; /* task uid */
df69a60d MH	85	__u32 rgid; /* task gid */
9f46080c MH	86	} r;
9f46080c MH	87	union {
df69a60d MH	88	__u32 euid;
df69a60d MH	89	__u32 egid;
9f46080c MH	90	} e;
	91	} id;
	92
02b51df1 SJR	93	struct sid_proc_event {
	94	__kernel_pid_t process_pid;
	95	__kernel_pid_t process_tgid;
	96	} sid;
	97
9f46080c	98	struct exit_proc_event {
85efde6f AB	99	__kernel_pid_t process_pid;
85efde6f AB	100	__kernel_pid_t process_tgid;
9f46080c MH	101	__u32 exit_code, exit_signal;
	102	} exit;
	103	} event_data;
	104	};
	105
	106	#ifdef __KERNEL__
	107	#ifdef CONFIG_PROC_EVENTS
	108	void proc_fork_connector(struct task_struct *task);
	109	void proc_exec_connector(struct task_struct *task);
	110	void proc_id_connector(struct task_struct *task, int which_id);
02b51df1	111	void proc_sid_connector(struct task_struct *task);
9f46080c MH	112	void proc_exit_connector(struct task_struct *task);
	113	#else
	114	static inline void proc_fork_connector(struct task_struct *task)
	115	{}
	116
	117	static inline void proc_exec_connector(struct task_struct *task)
	118	{}
	119
	120	static inline void proc_id_connector(struct task_struct *task,
	121	int which_id)
	122	{}
	123
02b51df1 SJR	124	static inline void proc_sid_connector(struct task_struct *task)
	125	{}
	126
9f46080c MH	127	static inline void proc_exit_connector(struct task_struct *task)
	128	{}
	129	#endif /* CONFIG_PROC_EVENTS */
	130	#endif /* __KERNEL__ */
	131	#endif /* CN_PROC_H */