root/arch/x86/include/asm/kprobes.h
/* SPDX-License-Identifier: GPL-2.0-or-later */
#ifndef _ASM_X86_KPROBES_H
#define _ASM_X86_KPROBES_H
/*
 *  Kernel Probes (KProbes)
 *
 * Copyright (C) IBM Corporation, 2002, 2004
 *
 * See arch/x86/kernel/kprobes.c for x86 kprobes history.
 */

#include <asm-generic/kprobes.h>

#ifdef CONFIG_KPROBES
#include <linux/types.h>
#include <linux/ptrace.h>
#include <linux/percpu.h>
#include <asm/text-patching.h>
#include <asm/insn.h>

#define  __ARCH_WANT_KPROBES_INSN_SLOT

struct pt_regs;
struct kprobe;

typedef u8 kprobe_opcode_t;

#define MAX_STACK_SIZE 64
#define CUR_STACK_SIZE(ADDR) \
        (current_top_of_stack() - (unsigned long)(ADDR))
#define MIN_STACK_SIZE(ADDR)                            \
        (MAX_STACK_SIZE < CUR_STACK_SIZE(ADDR) ?        \
         MAX_STACK_SIZE : CUR_STACK_SIZE(ADDR))

#define flush_insn_slot(p)      do { } while (0)

/* optinsn template addresses */
extern __visible kprobe_opcode_t optprobe_template_entry[];
extern __visible kprobe_opcode_t optprobe_template_clac[];
extern __visible kprobe_opcode_t optprobe_template_val[];
extern __visible kprobe_opcode_t optprobe_template_call[];
extern __visible kprobe_opcode_t optprobe_template_end[];
#define MAX_OPTIMIZED_LENGTH (MAX_INSN_SIZE + DISP32_SIZE)
#define MAX_OPTINSN_SIZE                                \
        (((unsigned long)optprobe_template_end -        \
          (unsigned long)optprobe_template_entry) +     \
         MAX_OPTIMIZED_LENGTH + JMP32_INSN_SIZE)

extern const int kretprobe_blacklist_size;

void arch_remove_kprobe(struct kprobe *p);

/* Architecture specific copy of original instruction*/
struct arch_specific_insn {
        /* copy of the original instruction */
        kprobe_opcode_t *insn;
        /*
         * boostable = 0: This instruction type is not boostable.
         * boostable = 1: This instruction has been boosted: we have
         * added a relative jump after the instruction copy in insn,
         * so no single-step and fixup are needed (unless there's
         * a post_handler).
         */
        unsigned boostable:1;
        unsigned char size;     /* The size of insn */
        union {
                unsigned char opcode;
                struct {
                        unsigned char type;
                } jcc;
                struct {
                        unsigned char type;
                        unsigned char asize;
                } loop;
                struct {
                        unsigned char reg;
                } indirect;
        };
        s32 rel32;      /* relative offset must be s32, s16, or s8 */
        void (*emulate_op)(struct kprobe *p, struct pt_regs *regs);
        /* Number of bytes of text poked */
        int tp_len;
};

struct arch_optimized_insn {
        /* copy of the original instructions */
        kprobe_opcode_t copied_insn[DISP32_SIZE];
        /* detour code buffer */
        kprobe_opcode_t *insn;
        /* the size of instructions copied to detour code buffer */
        size_t size;
};

/* Return true (!0) if optinsn is prepared for optimization. */
static inline int arch_prepared_optinsn(struct arch_optimized_insn *optinsn)
{
        return optinsn->size;
}

struct prev_kprobe {
        struct kprobe *kp;
        unsigned long status;
        unsigned long old_flags;
        unsigned long saved_flags;
};

/* per-cpu kprobe control block */
struct kprobe_ctlblk {
        unsigned long kprobe_status;
        unsigned long kprobe_old_flags;
        unsigned long kprobe_saved_flags;
        struct prev_kprobe prev_kprobe;
};

extern int kprobe_fault_handler(struct pt_regs *regs, int trapnr);
extern int kprobe_int3_handler(struct pt_regs *regs);

#else

static inline int kprobe_debug_handler(struct pt_regs *regs) { return 0; }

#endif /* CONFIG_KPROBES */
#endif /* _ASM_X86_KPROBES_H */