1 /* Copyright (c) 2011-2014 PLUMgrid, http://plumgrid.com
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.
7 * This program is distributed in the hope that it will be useful, but
8 * WITHOUT ANY WARRANTY; without even the implied warranty of
9 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
10 * General Public License for more details.
12 #include <linux/bpf.h>
13 #include <linux/syscalls.h>
14 #include <linux/slab.h>
15 #include <linux/anon_inodes.h>
16 #include <linux/file.h>
17 #include <linux/license.h>
18 #include <linux/filter.h>
19 #include <linux/version.h>
21 static LIST_HEAD(bpf_map_types
);
23 static struct bpf_map
*find_and_alloc_map(union bpf_attr
*attr
)
25 struct bpf_map_type_list
*tl
;
28 list_for_each_entry(tl
, &bpf_map_types
, list_node
) {
29 if (tl
->type
== attr
->map_type
) {
30 map
= tl
->ops
->map_alloc(attr
);
34 map
->map_type
= attr
->map_type
;
38 return ERR_PTR(-EINVAL
);
41 /* boot time registration of different map implementations */
42 void bpf_register_map_type(struct bpf_map_type_list
*tl
)
44 list_add(&tl
->list_node
, &bpf_map_types
);
47 /* called from workqueue */
48 static void bpf_map_free_deferred(struct work_struct
*work
)
50 struct bpf_map
*map
= container_of(work
, struct bpf_map
, work
);
52 /* implementation dependent freeing */
53 map
->ops
->map_free(map
);
56 /* decrement map refcnt and schedule it for freeing via workqueue
57 * (unrelying map implementation ops->map_free() might sleep)
59 void bpf_map_put(struct bpf_map
*map
)
61 if (atomic_dec_and_test(&map
->refcnt
)) {
62 INIT_WORK(&map
->work
, bpf_map_free_deferred
);
63 schedule_work(&map
->work
);
67 static int bpf_map_release(struct inode
*inode
, struct file
*filp
)
69 struct bpf_map
*map
= filp
->private_data
;
71 if (map
->map_type
== BPF_MAP_TYPE_PROG_ARRAY
)
72 /* prog_array stores refcnt-ed bpf_prog pointers
73 * release them all when user space closes prog_array_fd
75 bpf_prog_array_map_clear(map
);
81 static const struct file_operations bpf_map_fops
= {
82 .release
= bpf_map_release
,
85 /* helper macro to check that unused fields 'union bpf_attr' are zero */
86 #define CHECK_ATTR(CMD) \
87 memchr_inv((void *) &attr->CMD##_LAST_FIELD + \
88 sizeof(attr->CMD##_LAST_FIELD), 0, \
90 offsetof(union bpf_attr, CMD##_LAST_FIELD) - \
91 sizeof(attr->CMD##_LAST_FIELD)) != NULL
93 #define BPF_MAP_CREATE_LAST_FIELD max_entries
94 /* called via syscall */
95 static int map_create(union bpf_attr
*attr
)
100 err
= CHECK_ATTR(BPF_MAP_CREATE
);
104 /* find map type and init map: hashtable vs rbtree vs bloom vs ... */
105 map
= find_and_alloc_map(attr
);
109 atomic_set(&map
->refcnt
, 1);
111 err
= anon_inode_getfd("bpf-map", &bpf_map_fops
, map
, O_RDWR
| O_CLOEXEC
);
114 /* failed to allocate fd */
120 map
->ops
->map_free(map
);
124 /* if error is returned, fd is released.
125 * On success caller should complete fd access with matching fdput()
127 struct bpf_map
*bpf_map_get(struct fd f
)
132 return ERR_PTR(-EBADF
);
134 if (f
.file
->f_op
!= &bpf_map_fops
) {
136 return ERR_PTR(-EINVAL
);
139 map
= f
.file
->private_data
;
144 /* helper to convert user pointers passed inside __aligned_u64 fields */
145 static void __user
*u64_to_ptr(__u64 val
)
147 return (void __user
*) (unsigned long) val
;
150 /* last field in 'union bpf_attr' used by this command */
151 #define BPF_MAP_LOOKUP_ELEM_LAST_FIELD value
153 static int map_lookup_elem(union bpf_attr
*attr
)
155 void __user
*ukey
= u64_to_ptr(attr
->key
);
156 void __user
*uvalue
= u64_to_ptr(attr
->value
);
157 int ufd
= attr
->map_fd
;
158 struct fd f
= fdget(ufd
);
160 void *key
, *value
, *ptr
;
163 if (CHECK_ATTR(BPF_MAP_LOOKUP_ELEM
))
166 map
= bpf_map_get(f
);
171 key
= kmalloc(map
->key_size
, GFP_USER
);
176 if (copy_from_user(key
, ukey
, map
->key_size
) != 0)
180 value
= kmalloc(map
->value_size
, GFP_USER
);
185 ptr
= map
->ops
->map_lookup_elem(map
, key
);
187 memcpy(value
, ptr
, map
->value_size
);
195 if (copy_to_user(uvalue
, value
, map
->value_size
) != 0)
209 #define BPF_MAP_UPDATE_ELEM_LAST_FIELD flags
211 static int map_update_elem(union bpf_attr
*attr
)
213 void __user
*ukey
= u64_to_ptr(attr
->key
);
214 void __user
*uvalue
= u64_to_ptr(attr
->value
);
215 int ufd
= attr
->map_fd
;
216 struct fd f
= fdget(ufd
);
221 if (CHECK_ATTR(BPF_MAP_UPDATE_ELEM
))
224 map
= bpf_map_get(f
);
229 key
= kmalloc(map
->key_size
, GFP_USER
);
234 if (copy_from_user(key
, ukey
, map
->key_size
) != 0)
238 value
= kmalloc(map
->value_size
, GFP_USER
);
243 if (copy_from_user(value
, uvalue
, map
->value_size
) != 0)
246 /* eBPF program that use maps are running under rcu_read_lock(),
247 * therefore all map accessors rely on this fact, so do the same here
250 err
= map
->ops
->map_update_elem(map
, key
, value
, attr
->flags
);
262 #define BPF_MAP_DELETE_ELEM_LAST_FIELD key
264 static int map_delete_elem(union bpf_attr
*attr
)
266 void __user
*ukey
= u64_to_ptr(attr
->key
);
267 int ufd
= attr
->map_fd
;
268 struct fd f
= fdget(ufd
);
273 if (CHECK_ATTR(BPF_MAP_DELETE_ELEM
))
276 map
= bpf_map_get(f
);
281 key
= kmalloc(map
->key_size
, GFP_USER
);
286 if (copy_from_user(key
, ukey
, map
->key_size
) != 0)
290 err
= map
->ops
->map_delete_elem(map
, key
);
300 /* last field in 'union bpf_attr' used by this command */
301 #define BPF_MAP_GET_NEXT_KEY_LAST_FIELD next_key
303 static int map_get_next_key(union bpf_attr
*attr
)
305 void __user
*ukey
= u64_to_ptr(attr
->key
);
306 void __user
*unext_key
= u64_to_ptr(attr
->next_key
);
307 int ufd
= attr
->map_fd
;
308 struct fd f
= fdget(ufd
);
310 void *key
, *next_key
;
313 if (CHECK_ATTR(BPF_MAP_GET_NEXT_KEY
))
316 map
= bpf_map_get(f
);
321 key
= kmalloc(map
->key_size
, GFP_USER
);
326 if (copy_from_user(key
, ukey
, map
->key_size
) != 0)
330 next_key
= kmalloc(map
->key_size
, GFP_USER
);
335 err
= map
->ops
->map_get_next_key(map
, key
, next_key
);
341 if (copy_to_user(unext_key
, next_key
, map
->key_size
) != 0)
355 static LIST_HEAD(bpf_prog_types
);
357 static int find_prog_type(enum bpf_prog_type type
, struct bpf_prog
*prog
)
359 struct bpf_prog_type_list
*tl
;
361 list_for_each_entry(tl
, &bpf_prog_types
, list_node
) {
362 if (tl
->type
== type
) {
363 prog
->aux
->ops
= tl
->ops
;
372 void bpf_register_prog_type(struct bpf_prog_type_list
*tl
)
374 list_add(&tl
->list_node
, &bpf_prog_types
);
377 /* fixup insn->imm field of bpf_call instructions:
378 * if (insn->imm == BPF_FUNC_map_lookup_elem)
379 * insn->imm = bpf_map_lookup_elem - __bpf_call_base;
380 * else if (insn->imm == BPF_FUNC_map_update_elem)
381 * insn->imm = bpf_map_update_elem - __bpf_call_base;
384 * this function is called after eBPF program passed verification
386 static void fixup_bpf_calls(struct bpf_prog
*prog
)
388 const struct bpf_func_proto
*fn
;
391 for (i
= 0; i
< prog
->len
; i
++) {
392 struct bpf_insn
*insn
= &prog
->insnsi
[i
];
394 if (insn
->code
== (BPF_JMP
| BPF_CALL
)) {
395 /* we reach here when program has bpf_call instructions
396 * and it passed bpf_check(), means that
397 * ops->get_func_proto must have been supplied, check it
399 BUG_ON(!prog
->aux
->ops
->get_func_proto
);
401 if (insn
->imm
== BPF_FUNC_tail_call
) {
402 /* mark bpf_tail_call as different opcode
403 * to avoid conditional branch in
404 * interpeter for every normal call
405 * and to prevent accidental JITing by
406 * JIT compiler that doesn't support
414 fn
= prog
->aux
->ops
->get_func_proto(insn
->imm
);
415 /* all functions that have prototype and verifier allowed
416 * programs to call them, must be real in-kernel functions
419 insn
->imm
= fn
->func
- __bpf_call_base
;
424 /* drop refcnt on maps used by eBPF program and free auxilary data */
425 static void free_used_maps(struct bpf_prog_aux
*aux
)
429 for (i
= 0; i
< aux
->used_map_cnt
; i
++)
430 bpf_map_put(aux
->used_maps
[i
]);
432 kfree(aux
->used_maps
);
435 static void __prog_put_rcu(struct rcu_head
*rcu
)
437 struct bpf_prog_aux
*aux
= container_of(rcu
, struct bpf_prog_aux
, rcu
);
440 bpf_prog_free(aux
->prog
);
443 /* version of bpf_prog_put() that is called after a grace period */
444 void bpf_prog_put_rcu(struct bpf_prog
*prog
)
446 if (atomic_dec_and_test(&prog
->aux
->refcnt
)) {
447 prog
->aux
->prog
= prog
;
448 call_rcu(&prog
->aux
->rcu
, __prog_put_rcu
);
452 void bpf_prog_put(struct bpf_prog
*prog
)
454 if (atomic_dec_and_test(&prog
->aux
->refcnt
)) {
455 free_used_maps(prog
->aux
);
459 EXPORT_SYMBOL_GPL(bpf_prog_put
);
461 static int bpf_prog_release(struct inode
*inode
, struct file
*filp
)
463 struct bpf_prog
*prog
= filp
->private_data
;
465 bpf_prog_put_rcu(prog
);
469 static const struct file_operations bpf_prog_fops
= {
470 .release
= bpf_prog_release
,
473 static struct bpf_prog
*get_prog(struct fd f
)
475 struct bpf_prog
*prog
;
478 return ERR_PTR(-EBADF
);
480 if (f
.file
->f_op
!= &bpf_prog_fops
) {
482 return ERR_PTR(-EINVAL
);
485 prog
= f
.file
->private_data
;
490 /* called by sockets/tracing/seccomp before attaching program to an event
491 * pairs with bpf_prog_put()
493 struct bpf_prog
*bpf_prog_get(u32 ufd
)
495 struct fd f
= fdget(ufd
);
496 struct bpf_prog
*prog
;
503 atomic_inc(&prog
->aux
->refcnt
);
507 EXPORT_SYMBOL_GPL(bpf_prog_get
);
509 /* last field in 'union bpf_attr' used by this command */
510 #define BPF_PROG_LOAD_LAST_FIELD kern_version
512 static int bpf_prog_load(union bpf_attr
*attr
)
514 enum bpf_prog_type type
= attr
->prog_type
;
515 struct bpf_prog
*prog
;
520 if (CHECK_ATTR(BPF_PROG_LOAD
))
523 /* copy eBPF program license from user space */
524 if (strncpy_from_user(license
, u64_to_ptr(attr
->license
),
525 sizeof(license
) - 1) < 0)
527 license
[sizeof(license
) - 1] = 0;
529 /* eBPF programs must be GPL compatible to use GPL-ed functions */
530 is_gpl
= license_is_gpl_compatible(license
);
532 if (attr
->insn_cnt
>= BPF_MAXINSNS
)
535 if (type
== BPF_PROG_TYPE_KPROBE
&&
536 attr
->kern_version
!= LINUX_VERSION_CODE
)
539 /* plain bpf_prog allocation */
540 prog
= bpf_prog_alloc(bpf_prog_size(attr
->insn_cnt
), GFP_USER
);
544 prog
->len
= attr
->insn_cnt
;
547 if (copy_from_user(prog
->insns
, u64_to_ptr(attr
->insns
),
548 prog
->len
* sizeof(struct bpf_insn
)) != 0)
551 prog
->orig_prog
= NULL
;
554 atomic_set(&prog
->aux
->refcnt
, 1);
555 prog
->gpl_compatible
= is_gpl
;
557 /* find program type: socket_filter vs tracing_filter */
558 err
= find_prog_type(type
, prog
);
562 /* run eBPF verifier */
563 err
= bpf_check(&prog
, attr
);
567 /* fixup BPF_CALL->imm field */
568 fixup_bpf_calls(prog
);
570 /* eBPF program is ready to be JITed */
571 err
= bpf_prog_select_runtime(prog
);
575 err
= anon_inode_getfd("bpf-prog", &bpf_prog_fops
, prog
, O_RDWR
| O_CLOEXEC
);
577 /* failed to allocate fd */
583 free_used_maps(prog
->aux
);
589 SYSCALL_DEFINE3(bpf
, int, cmd
, union bpf_attr __user
*, uattr
, unsigned int, size
)
591 union bpf_attr attr
= {};
594 /* the syscall is limited to root temporarily. This restriction will be
595 * lifted when security audit is clean. Note that eBPF+tracing must have
596 * this restriction, since it may pass kernel data to user space
598 if (!capable(CAP_SYS_ADMIN
))
601 if (!access_ok(VERIFY_READ
, uattr
, 1))
604 if (size
> PAGE_SIZE
) /* silly large */
607 /* If we're handed a bigger struct than we know of,
608 * ensure all the unknown bits are 0 - i.e. new
609 * user-space does not rely on any kernel feature
610 * extensions we dont know about yet.
612 if (size
> sizeof(attr
)) {
613 unsigned char __user
*addr
;
614 unsigned char __user
*end
;
617 addr
= (void __user
*)uattr
+ sizeof(attr
);
618 end
= (void __user
*)uattr
+ size
;
620 for (; addr
< end
; addr
++) {
621 err
= get_user(val
, addr
);
630 /* copy attributes from user space, may be less than sizeof(bpf_attr) */
631 if (copy_from_user(&attr
, uattr
, size
) != 0)
636 err
= map_create(&attr
);
638 case BPF_MAP_LOOKUP_ELEM
:
639 err
= map_lookup_elem(&attr
);
641 case BPF_MAP_UPDATE_ELEM
:
642 err
= map_update_elem(&attr
);
644 case BPF_MAP_DELETE_ELEM
:
645 err
= map_delete_elem(&attr
);
647 case BPF_MAP_GET_NEXT_KEY
:
648 err
= map_get_next_key(&attr
);
651 err
= bpf_prog_load(&attr
);