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 void bpf_prog_put(struct bpf_prog *prog)
437 if (atomic_dec_and_test(&prog->aux->refcnt)) {
438 free_used_maps(prog->aux);
442 EXPORT_SYMBOL_GPL(bpf_prog_put);
444 static int bpf_prog_release(struct inode *inode, struct file *filp)
446 struct bpf_prog *prog = filp->private_data;
452 static const struct file_operations bpf_prog_fops = {
453 .release = bpf_prog_release,
456 static struct bpf_prog *get_prog(struct fd f)
458 struct bpf_prog *prog;
461 return ERR_PTR(-EBADF);
463 if (f.file->f_op != &bpf_prog_fops) {
465 return ERR_PTR(-EINVAL);
468 prog = f.file->private_data;
473 /* called by sockets/tracing/seccomp before attaching program to an event
474 * pairs with bpf_prog_put()
476 struct bpf_prog *bpf_prog_get(u32 ufd)
478 struct fd f = fdget(ufd);
479 struct bpf_prog *prog;
486 atomic_inc(&prog->aux->refcnt);
490 EXPORT_SYMBOL_GPL(bpf_prog_get);
492 /* last field in 'union bpf_attr' used by this command */
493 #define BPF_PROG_LOAD_LAST_FIELD kern_version
495 static int bpf_prog_load(union bpf_attr *attr)
497 enum bpf_prog_type type = attr->prog_type;
498 struct bpf_prog *prog;
503 if (CHECK_ATTR(BPF_PROG_LOAD))
506 /* copy eBPF program license from user space */
507 if (strncpy_from_user(license, u64_to_ptr(attr->license),
508 sizeof(license) - 1) < 0)
510 license[sizeof(license) - 1] = 0;
512 /* eBPF programs must be GPL compatible to use GPL-ed functions */
513 is_gpl = license_is_gpl_compatible(license);
515 if (attr->insn_cnt >= BPF_MAXINSNS)
518 if (type == BPF_PROG_TYPE_KPROBE &&
519 attr->kern_version != LINUX_VERSION_CODE)
522 /* plain bpf_prog allocation */
523 prog = bpf_prog_alloc(bpf_prog_size(attr->insn_cnt), GFP_USER);
527 prog->len = attr->insn_cnt;
530 if (copy_from_user(prog->insns, u64_to_ptr(attr->insns),
531 prog->len * sizeof(struct bpf_insn)) != 0)
534 prog->orig_prog = NULL;
537 atomic_set(&prog->aux->refcnt, 1);
538 prog->gpl_compatible = is_gpl;
540 /* find program type: socket_filter vs tracing_filter */
541 err = find_prog_type(type, prog);
545 /* run eBPF verifier */
546 err = bpf_check(&prog, attr);
550 /* fixup BPF_CALL->imm field */
551 fixup_bpf_calls(prog);
553 /* eBPF program is ready to be JITed */
554 err = bpf_prog_select_runtime(prog);
558 err = anon_inode_getfd("bpf-prog", &bpf_prog_fops, prog, O_RDWR | O_CLOEXEC);
560 /* failed to allocate fd */
566 free_used_maps(prog->aux);
572 SYSCALL_DEFINE3(bpf, int, cmd, union bpf_attr __user *, uattr, unsigned int, size)
574 union bpf_attr attr = {};
577 /* the syscall is limited to root temporarily. This restriction will be
578 * lifted when security audit is clean. Note that eBPF+tracing must have
579 * this restriction, since it may pass kernel data to user space
581 if (!capable(CAP_SYS_ADMIN))
584 if (!access_ok(VERIFY_READ, uattr, 1))
587 if (size > PAGE_SIZE) /* silly large */
590 /* If we're handed a bigger struct than we know of,
591 * ensure all the unknown bits are 0 - i.e. new
592 * user-space does not rely on any kernel feature
593 * extensions we dont know about yet.
595 if (size > sizeof(attr)) {
596 unsigned char __user *addr;
597 unsigned char __user *end;
600 addr = (void __user *)uattr + sizeof(attr);
601 end = (void __user *)uattr + size;
603 for (; addr < end; addr++) {
604 err = get_user(val, addr);
613 /* copy attributes from user space, may be less than sizeof(bpf_attr) */
614 if (copy_from_user(&attr, uattr, size) != 0)
619 err = map_create(&attr);
621 case BPF_MAP_LOOKUP_ELEM:
622 err = map_lookup_elem(&attr);
624 case BPF_MAP_UPDATE_ELEM:
625 err = map_update_elem(&attr);
627 case BPF_MAP_DELETE_ELEM:
628 err = map_delete_elem(&attr);
630 case BPF_MAP_GET_NEXT_KEY:
631 err = map_get_next_key(&attr);
634 err = bpf_prog_load(&attr);