1 /* Copyright (c) 2011-2014 PLUMgrid, http://plumgrid.com 2 * 3 * This program is free software; you can redistribute it and/or 4 * modify it under the terms of version 2 of the GNU General Public 5 * License as published by the Free Software Foundation. 6 */ 7 #ifndef _LINUX_BPF_VERIFIER_H 8 #define _LINUX_BPF_VERIFIER_H 1 9 10 #include <linux/bpf.h> /* for enum bpf_reg_type */ 11 #include <linux/filter.h> /* for MAX_BPF_STACK */ 12 13 /* Just some arbitrary values so we can safely do math without overflowing and 14 * are obviously wrong for any sort of memory access. 15 */ 16 #define BPF_REGISTER_MAX_RANGE (1024 * 1024 * 1024) 17 #define BPF_REGISTER_MIN_RANGE -1 18 19 struct bpf_reg_state { 20 enum bpf_reg_type type; 21 union { 22 /* valid when type == CONST_IMM | PTR_TO_STACK | UNKNOWN_VALUE */ 23 s64 imm; 24 25 /* valid when type == PTR_TO_PACKET* */ 26 struct { 27 u16 off; 28 u16 range; 29 }; 30 31 /* valid when type == CONST_PTR_TO_MAP | PTR_TO_MAP_VALUE | 32 * PTR_TO_MAP_VALUE_OR_NULL 33 */ 34 struct bpf_map *map_ptr; 35 }; 36 u32 id; 37 /* Used to determine if any memory access using this register will 38 * result in a bad access. These two fields must be last. 39 * See states_equal() 40 */ 41 s64 min_value; 42 u64 max_value; 43 }; 44 45 enum bpf_stack_slot_type { 46 STACK_INVALID, /* nothing was stored in this stack slot */ 47 STACK_SPILL, /* register spilled into stack */ 48 STACK_MISC /* BPF program wrote some data into this slot */ 49 }; 50 51 #define BPF_REG_SIZE 8 /* size of eBPF register in bytes */ 52 53 /* state of the program: 54 * type of all registers and stack info 55 */ 56 struct bpf_verifier_state { 57 struct bpf_reg_state regs[MAX_BPF_REG]; 58 u8 stack_slot_type[MAX_BPF_STACK]; 59 struct bpf_reg_state spilled_regs[MAX_BPF_STACK / BPF_REG_SIZE]; 60 }; 61 62 /* linked list of verifier states used to prune search */ 63 struct bpf_verifier_state_list { 64 struct bpf_verifier_state state; 65 struct bpf_verifier_state_list *next; 66 }; 67 68 struct bpf_insn_aux_data { 69 enum bpf_reg_type ptr_type; /* pointer type for load/store insns */ 70 }; 71 72 #define MAX_USED_MAPS 64 /* max number of maps accessed by one eBPF program */ 73 74 struct bpf_verifier_env; 75 struct bpf_ext_analyzer_ops { 76 int (*insn_hook)(struct bpf_verifier_env *env, 77 int insn_idx, int prev_insn_idx); 78 }; 79 80 /* single container for all structs 81 * one verifier_env per bpf_check() call 82 */ 83 struct bpf_verifier_env { 84 struct bpf_prog *prog; /* eBPF program being verified */ 85 struct bpf_verifier_stack_elem *head; /* stack of verifier states to be processed */ 86 int stack_size; /* number of states to be processed */ 87 struct bpf_verifier_state cur_state; /* current verifier state */ 88 struct bpf_verifier_state_list **explored_states; /* search pruning optimization */ 89 const struct bpf_ext_analyzer_ops *analyzer_ops; /* external analyzer ops */ 90 void *analyzer_priv; /* pointer to external analyzer's private data */ 91 struct bpf_map *used_maps[MAX_USED_MAPS]; /* array of map's used by eBPF program */ 92 u32 used_map_cnt; /* number of used maps */ 93 u32 id_gen; /* used to generate unique reg IDs */ 94 bool allow_ptr_leaks; 95 bool seen_direct_write; 96 bool varlen_map_value_access; 97 struct bpf_insn_aux_data *insn_aux_data; /* array of per-insn state */ 98 }; 99 100 int bpf_analyzer(struct bpf_prog *prog, const struct bpf_ext_analyzer_ops *ops, 101 void *priv); 102 103 #endif /* _LINUX_BPF_VERIFIER_H */ 104