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 6 * Copyright (C) 2005 Nguyen Anh Quynh <aquynh@gmail.com> 7 * Copyright (C) 2005 Guillaume Thouvenin <guillaume.thouvenin@bull.net> 8 * 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. 12 * 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. 16 */ 17 18#ifndef CN_PROC_H 19#define CN_PROC_H 20 21#include <linux/types.h> 22 23/* 24 * Userspace sends this enum to register with the kernel that it is listening 25 * for events on the connector. 26 */ 27enum 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 45struct 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 PROC_EVENT_SID = 0x00000080, 56 /* "next" should be 0x00000400 */ 57 /* "last" is the last process event: exit */ 58 PROC_EVENT_EXIT = 0x80000000 59 } what; 60 __u32 cpu; 61 __u64 __attribute__((aligned(8))) timestamp_ns; 62 /* Number of nano seconds since system boot */ 63 union { /* must be last field of proc_event struct */ 64 struct { 65 __u32 err; 66 } ack; 67 68 struct fork_proc_event { 69 __kernel_pid_t parent_pid; 70 __kernel_pid_t parent_tgid; 71 __kernel_pid_t child_pid; 72 __kernel_pid_t child_tgid; 73 } fork; 74 75 struct exec_proc_event { 76 __kernel_pid_t process_pid; 77 __kernel_pid_t process_tgid; 78 } exec; 79 80 struct id_proc_event { 81 __kernel_pid_t process_pid; 82 __kernel_pid_t process_tgid; 83 union { 84 __u32 ruid; /* task uid */ 85 __u32 rgid; /* task gid */ 86 } r; 87 union { 88 __u32 euid; 89 __u32 egid; 90 } e; 91 } id; 92 93 struct sid_proc_event { 94 __kernel_pid_t process_pid; 95 __kernel_pid_t process_tgid; 96 } sid; 97 98 struct exit_proc_event { 99 __kernel_pid_t process_pid; 100 __kernel_pid_t process_tgid; 101 __u32 exit_code, exit_signal; 102 } exit; 103 } event_data; 104}; 105 106#endif /* CN_PROC_H */ 107