include/linux/user_events.h

   1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
   2 /*
   3  * Copyright (c) 2021, Microsoft Corporation.
   4  *
   5  * Authors:
   6  *   Beau Belgrave <beaub@linux.microsoft.com>
   7  */
   8 #ifndef _UAPI_LINUX_USER_EVENTS_H
   9 #define _UAPI_LINUX_USER_EVENTS_H
  10
  11 #include <linux/types.h>
  12 #include <linux/ioctl.h>
  13
  14 #ifdef __KERNEL__
  15 #include <linux/uio.h>
  16 #else
  17 #include <sys/uio.h>
  18 #endif
  19
  20 #define USER_EVENTS_SYSTEM "user_events"
  21 #define USER_EVENTS_PREFIX "u:"
  22
  23 /* Bits 0-6 are for known probe types, Bit 7 is for unknown probes */
  24 #define EVENT_BIT_FTRACE 0
  25 #define EVENT_BIT_PERF 1
  26 #define EVENT_BIT_OTHER 7
  27
  28 #define EVENT_STATUS_FTRACE (1 << EVENT_BIT_FTRACE)
  29 #define EVENT_STATUS_PERF (1 << EVENT_BIT_PERF)
  30 #define EVENT_STATUS_OTHER (1 << EVENT_BIT_OTHER)
  31
  32 /* Create dynamic location entry within a 32-bit value */
  33 #define DYN_LOC(offset, size) ((size) << 16 | (offset))
  34
  35 /*
  36  * Describes an event registration and stores the results of the registration.
  37  * This structure is passed to the DIAG_IOCSREG ioctl, callers at a minimum
  38  * must set the size and name_args before invocation.
  39  */
  40 struct user_reg {
  41
  42         /* Input: Size of the user_reg structure being used */
  43         __u32 size;
  44
  45         /* Input: Pointer to string with event name, description and flags */
  46         __u64 name_args;
  47
  48         /* Output: Byte index of the event within the status page */
  49         __u32 status_index;
  50
  51         /* Output: Index of the event to use when writing data */
  52         __u32 write_index;
  53 };
  54
  55 #define DIAG_IOC_MAGIC '*'
  56
  57 /* Requests to register a user_event */
  58 #define DIAG_IOCSREG _IOWR(DIAG_IOC_MAGIC, 0, struct user_reg*)
  59
  60 /* Requests to delete a user_event */
  61 #define DIAG_IOCSDEL _IOW(DIAG_IOC_MAGIC, 1, char*)
  62
  63 #endif /* _UAPI_LINUX_USER_EVENTS_H */