173572984SJens Axboe // SPDX-License-Identifier: GPL-2.0 273572984SJens Axboe #include <linux/kernel.h> 373572984SJens Axboe #include <linux/errno.h> 473572984SJens Axboe #include <linux/fs.h> 573572984SJens Axboe #include <linux/file.h> 673572984SJens Axboe #include <linux/mm.h> 773572984SJens Axboe #include <linux/slab.h> 873572984SJens Axboe #include <linux/nospec.h> 973572984SJens Axboe #include <linux/hugetlb.h> 1073572984SJens Axboe #include <linux/compat.h> 1173572984SJens Axboe #include <linux/io_uring.h> 1273572984SJens Axboe 1373572984SJens Axboe #include <uapi/linux/io_uring.h> 1473572984SJens Axboe 1573572984SJens Axboe #include "io_uring.h" 1673572984SJens Axboe #include "openclose.h" 1773572984SJens Axboe #include "rsrc.h" 1873572984SJens Axboe 1973572984SJens Axboe struct io_rsrc_update { 2073572984SJens Axboe struct file *file; 2173572984SJens Axboe u64 arg; 2273572984SJens Axboe u32 nr_args; 2373572984SJens Axboe u32 offset; 2473572984SJens Axboe }; 2573572984SJens Axboe 26fc7f3a8dSPavel Begunkov static void io_rsrc_buf_put(struct io_ring_ctx *ctx, struct io_rsrc_put *prsrc); 27fc7f3a8dSPavel Begunkov static void io_rsrc_file_put(struct io_ring_ctx *ctx, struct io_rsrc_put *prsrc); 2873572984SJens Axboe static int io_sqe_buffer_register(struct io_ring_ctx *ctx, struct iovec *iov, 2973572984SJens Axboe struct io_mapped_ubuf **pimu, 3073572984SJens Axboe struct page **last_hpage); 3173572984SJens Axboe 3273572984SJens Axboe /* only define max */ 3373572984SJens Axboe #define IORING_MAX_FIXED_FILES (1U << 20) 3473572984SJens Axboe #define IORING_MAX_REG_BUFFERS (1U << 14) 3573572984SJens Axboe 366a9ce66fSPavel Begunkov int __io_account_mem(struct user_struct *user, unsigned long nr_pages) 3773572984SJens Axboe { 3873572984SJens Axboe unsigned long page_limit, cur_pages, new_pages; 3973572984SJens Axboe 406a9ce66fSPavel Begunkov if (!nr_pages) 416a9ce66fSPavel Begunkov return 0; 426a9ce66fSPavel Begunkov 4373572984SJens Axboe /* Don't allow more pages than we can safely lock */ 4473572984SJens Axboe page_limit = rlimit(RLIMIT_MEMLOCK) >> PAGE_SHIFT; 4573572984SJens Axboe 4673572984SJens Axboe cur_pages = atomic_long_read(&user->locked_vm); 474ccc6db0SUros Bizjak do { 4873572984SJens Axboe new_pages = cur_pages + nr_pages; 4973572984SJens Axboe if (new_pages > page_limit) 5073572984SJens Axboe return -ENOMEM; 514ccc6db0SUros Bizjak } while (!atomic_long_try_cmpxchg(&user->locked_vm, 524ccc6db0SUros Bizjak &cur_pages, new_pages)); 5373572984SJens Axboe return 0; 5473572984SJens Axboe } 5573572984SJens Axboe 5673572984SJens Axboe static void io_unaccount_mem(struct io_ring_ctx *ctx, unsigned long nr_pages) 5773572984SJens Axboe { 5873572984SJens Axboe if (ctx->user) 5973572984SJens Axboe __io_unaccount_mem(ctx->user, nr_pages); 6073572984SJens Axboe 6173572984SJens Axboe if (ctx->mm_account) 6273572984SJens Axboe atomic64_sub(nr_pages, &ctx->mm_account->pinned_vm); 6373572984SJens Axboe } 6473572984SJens Axboe 6573572984SJens Axboe static int io_account_mem(struct io_ring_ctx *ctx, unsigned long nr_pages) 6673572984SJens Axboe { 6773572984SJens Axboe int ret; 6873572984SJens Axboe 6973572984SJens Axboe if (ctx->user) { 7073572984SJens Axboe ret = __io_account_mem(ctx->user, nr_pages); 7173572984SJens Axboe if (ret) 7273572984SJens Axboe return ret; 7373572984SJens Axboe } 7473572984SJens Axboe 7573572984SJens Axboe if (ctx->mm_account) 7673572984SJens Axboe atomic64_add(nr_pages, &ctx->mm_account->pinned_vm); 7773572984SJens Axboe 7873572984SJens Axboe return 0; 7973572984SJens Axboe } 8073572984SJens Axboe 8173572984SJens Axboe static int io_copy_iov(struct io_ring_ctx *ctx, struct iovec *dst, 8273572984SJens Axboe void __user *arg, unsigned index) 8373572984SJens Axboe { 8473572984SJens Axboe struct iovec __user *src; 8573572984SJens Axboe 8673572984SJens Axboe #ifdef CONFIG_COMPAT 8773572984SJens Axboe if (ctx->compat) { 8873572984SJens Axboe struct compat_iovec __user *ciovs; 8973572984SJens Axboe struct compat_iovec ciov; 9073572984SJens Axboe 9173572984SJens Axboe ciovs = (struct compat_iovec __user *) arg; 9273572984SJens Axboe if (copy_from_user(&ciov, &ciovs[index], sizeof(ciov))) 9373572984SJens Axboe return -EFAULT; 9473572984SJens Axboe 9573572984SJens Axboe dst->iov_base = u64_to_user_ptr((u64)ciov.iov_base); 9673572984SJens Axboe dst->iov_len = ciov.iov_len; 9773572984SJens Axboe return 0; 9873572984SJens Axboe } 9973572984SJens Axboe #endif 10073572984SJens Axboe src = (struct iovec __user *) arg; 10173572984SJens Axboe if (copy_from_user(dst, &src[index], sizeof(*dst))) 10273572984SJens Axboe return -EFAULT; 10373572984SJens Axboe return 0; 10473572984SJens Axboe } 10573572984SJens Axboe 10673572984SJens Axboe static int io_buffer_validate(struct iovec *iov) 10773572984SJens Axboe { 10873572984SJens Axboe unsigned long tmp, acct_len = iov->iov_len + (PAGE_SIZE - 1); 10973572984SJens Axboe 11073572984SJens Axboe /* 11173572984SJens Axboe * Don't impose further limits on the size and buffer 11273572984SJens Axboe * constraints here, we'll -EINVAL later when IO is 11373572984SJens Axboe * submitted if they are wrong. 11473572984SJens Axboe */ 11573572984SJens Axboe if (!iov->iov_base) 11673572984SJens Axboe return iov->iov_len ? -EFAULT : 0; 11773572984SJens Axboe if (!iov->iov_len) 11873572984SJens Axboe return -EFAULT; 11973572984SJens Axboe 12073572984SJens Axboe /* arbitrary limit, but we need something */ 12173572984SJens Axboe if (iov->iov_len > SZ_1G) 12273572984SJens Axboe return -EFAULT; 12373572984SJens Axboe 12473572984SJens Axboe if (check_add_overflow((unsigned long)iov->iov_base, acct_len, &tmp)) 12573572984SJens Axboe return -EOVERFLOW; 12673572984SJens Axboe 12773572984SJens Axboe return 0; 12873572984SJens Axboe } 12973572984SJens Axboe 13073572984SJens Axboe static void io_buffer_unmap(struct io_ring_ctx *ctx, struct io_mapped_ubuf **slot) 13173572984SJens Axboe { 13273572984SJens Axboe struct io_mapped_ubuf *imu = *slot; 13373572984SJens Axboe unsigned int i; 13473572984SJens Axboe 13573572984SJens Axboe if (imu != ctx->dummy_ubuf) { 13673572984SJens Axboe for (i = 0; i < imu->nr_bvecs; i++) 13773572984SJens Axboe unpin_user_page(imu->bvec[i].bv_page); 13873572984SJens Axboe if (imu->acct_pages) 13973572984SJens Axboe io_unaccount_mem(ctx, imu->acct_pages); 14073572984SJens Axboe kvfree(imu); 14173572984SJens Axboe } 14273572984SJens Axboe *slot = NULL; 14373572984SJens Axboe } 14473572984SJens Axboe 14529b26c55SPavel Begunkov static void io_rsrc_put_work(struct io_rsrc_node *node) 14673572984SJens Axboe { 14729b26c55SPavel Begunkov struct io_rsrc_put *prsrc = &node->item; 14873572984SJens Axboe 14936b9818aSPavel Begunkov if (prsrc->tag) 1502236b390SPavel Begunkov io_post_aux_cqe(node->ctx, prsrc->tag, 0, 0); 151fc7f3a8dSPavel Begunkov 1522236b390SPavel Begunkov switch (node->type) { 153fc7f3a8dSPavel Begunkov case IORING_RSRC_FILE: 1542236b390SPavel Begunkov io_rsrc_file_put(node->ctx, prsrc); 155fc7f3a8dSPavel Begunkov break; 156fc7f3a8dSPavel Begunkov case IORING_RSRC_BUFFER: 1572236b390SPavel Begunkov io_rsrc_buf_put(node->ctx, prsrc); 158fc7f3a8dSPavel Begunkov break; 159fc7f3a8dSPavel Begunkov default: 160fc7f3a8dSPavel Begunkov WARN_ON_ONCE(1); 161fc7f3a8dSPavel Begunkov break; 162fc7f3a8dSPavel Begunkov } 163ff7c75ecSPavel Begunkov } 164ff7c75ecSPavel Begunkov 1659eae8655SPavel Begunkov void io_rsrc_node_destroy(struct io_ring_ctx *ctx, struct io_rsrc_node *node) 16673572984SJens Axboe { 1679eae8655SPavel Begunkov if (!io_alloc_cache_put(&ctx->rsrc_node_cache, &node->cache)) 1689eae8655SPavel Begunkov kfree(node); 16973572984SJens Axboe } 17073572984SJens Axboe 171ef8ae64fSPavel Begunkov void io_rsrc_node_ref_zero(struct io_rsrc_node *node) 1722236b390SPavel Begunkov __must_hold(&node->ctx->uring_lock) 17373572984SJens Axboe { 1742236b390SPavel Begunkov struct io_ring_ctx *ctx = node->ctx; 17573572984SJens Axboe 17673572984SJens Axboe while (!list_empty(&ctx->rsrc_ref_list)) { 17773572984SJens Axboe node = list_first_entry(&ctx->rsrc_ref_list, 17873572984SJens Axboe struct io_rsrc_node, node); 17973572984SJens Axboe /* recycle ref nodes in order */ 180c732ea24SPavel Begunkov if (node->refs) 18173572984SJens Axboe break; 18273572984SJens Axboe list_del(&node->node); 1834130b499SPavel Begunkov 1844130b499SPavel Begunkov if (likely(!node->empty)) 18529b26c55SPavel Begunkov io_rsrc_put_work(node); 1864130b499SPavel Begunkov io_rsrc_node_destroy(ctx, node); 18773572984SJens Axboe } 1880b222eebSPavel Begunkov if (list_empty(&ctx->rsrc_ref_list) && unlikely(ctx->rsrc_quiesce)) 1890b222eebSPavel Begunkov wake_up_all(&ctx->rsrc_quiesce_wq); 19073572984SJens Axboe } 19173572984SJens Axboe 1922933ae6eSPavel Begunkov struct io_rsrc_node *io_rsrc_node_alloc(struct io_ring_ctx *ctx) 19373572984SJens Axboe { 19473572984SJens Axboe struct io_rsrc_node *ref_node; 1959eae8655SPavel Begunkov struct io_cache_entry *entry; 19673572984SJens Axboe 1979eae8655SPavel Begunkov entry = io_alloc_cache_get(&ctx->rsrc_node_cache); 1989eae8655SPavel Begunkov if (entry) { 1999eae8655SPavel Begunkov ref_node = container_of(entry, struct io_rsrc_node, cache); 2009eae8655SPavel Begunkov } else { 20173572984SJens Axboe ref_node = kzalloc(sizeof(*ref_node), GFP_KERNEL); 20273572984SJens Axboe if (!ref_node) 20373572984SJens Axboe return NULL; 2049eae8655SPavel Begunkov } 20573572984SJens Axboe 2062236b390SPavel Begunkov ref_node->ctx = ctx; 20726147da3SPavel Begunkov ref_node->empty = 0; 208c376644fSPavel Begunkov ref_node->refs = 1; 20973572984SJens Axboe return ref_node; 21073572984SJens Axboe } 21173572984SJens Axboe 21273572984SJens Axboe __cold static int io_rsrc_ref_quiesce(struct io_rsrc_data *data, 21373572984SJens Axboe struct io_ring_ctx *ctx) 21473572984SJens Axboe { 215c376644fSPavel Begunkov struct io_rsrc_node *backup; 2164ea15b56SPavel Begunkov DEFINE_WAIT(we); 21773572984SJens Axboe int ret; 21873572984SJens Axboe 219c376644fSPavel Begunkov /* As We may drop ->uring_lock, other task may have started quiesce */ 22073572984SJens Axboe if (data->quiesce) 22173572984SJens Axboe return -ENXIO; 222c376644fSPavel Begunkov 223c376644fSPavel Begunkov backup = io_rsrc_node_alloc(ctx); 224c376644fSPavel Begunkov if (!backup) 225c376644fSPavel Begunkov return -ENOMEM; 22626147da3SPavel Begunkov ctx->rsrc_node->empty = true; 2272236b390SPavel Begunkov ctx->rsrc_node->type = -1; 228c376644fSPavel Begunkov list_add_tail(&ctx->rsrc_node->node, &ctx->rsrc_ref_list); 229c376644fSPavel Begunkov io_put_rsrc_node(ctx, ctx->rsrc_node); 230c376644fSPavel Begunkov ctx->rsrc_node = backup; 23173572984SJens Axboe 2320b222eebSPavel Begunkov if (list_empty(&ctx->rsrc_ref_list)) 23377e3202aSPavel Begunkov return 0; 234ef67fcb4SDylan Yudaken 2357d481e03SPavel Begunkov if (ctx->flags & IORING_SETUP_DEFER_TASKRUN) { 2367d481e03SPavel Begunkov atomic_set(&ctx->cq_wait_nr, 1); 2377d481e03SPavel Begunkov smp_mb(); 2387d481e03SPavel Begunkov } 2397d481e03SPavel Begunkov 2400b222eebSPavel Begunkov ctx->rsrc_quiesce++; 24177e3202aSPavel Begunkov data->quiesce = true; 24277e3202aSPavel Begunkov do { 2434ea15b56SPavel Begunkov prepare_to_wait(&ctx->rsrc_quiesce_wq, &we, TASK_INTERRUPTIBLE); 244eef81fcaSPavel Begunkov mutex_unlock(&ctx->uring_lock); 2454ea15b56SPavel Begunkov 246ef67fcb4SDylan Yudaken ret = io_run_task_work_sig(ctx); 24777e3202aSPavel Begunkov if (ret < 0) { 24877e3202aSPavel Begunkov mutex_lock(&ctx->uring_lock); 2490b222eebSPavel Begunkov if (list_empty(&ctx->rsrc_ref_list)) 250757ef468SPavel Begunkov ret = 0; 25177e3202aSPavel Begunkov break; 25277e3202aSPavel Begunkov } 2534ea15b56SPavel Begunkov 2544ea15b56SPavel Begunkov schedule(); 2554ea15b56SPavel Begunkov __set_current_state(TASK_RUNNING); 25673572984SJens Axboe mutex_lock(&ctx->uring_lock); 257eef81fcaSPavel Begunkov ret = 0; 2580b222eebSPavel Begunkov } while (!list_empty(&ctx->rsrc_ref_list)); 25973572984SJens Axboe 2604ea15b56SPavel Begunkov finish_wait(&ctx->rsrc_quiesce_wq, &we); 2614ea15b56SPavel Begunkov data->quiesce = false; 2620b222eebSPavel Begunkov ctx->rsrc_quiesce--; 2630b222eebSPavel Begunkov 2647d481e03SPavel Begunkov if (ctx->flags & IORING_SETUP_DEFER_TASKRUN) { 2657d481e03SPavel Begunkov atomic_set(&ctx->cq_wait_nr, 0); 2667d481e03SPavel Begunkov smp_mb(); 2677d481e03SPavel Begunkov } 26873572984SJens Axboe return ret; 26973572984SJens Axboe } 27073572984SJens Axboe 27173572984SJens Axboe static void io_free_page_table(void **table, size_t size) 27273572984SJens Axboe { 27373572984SJens Axboe unsigned i, nr_tables = DIV_ROUND_UP(size, PAGE_SIZE); 27473572984SJens Axboe 27573572984SJens Axboe for (i = 0; i < nr_tables; i++) 27673572984SJens Axboe kfree(table[i]); 27773572984SJens Axboe kfree(table); 27873572984SJens Axboe } 27973572984SJens Axboe 28073572984SJens Axboe static void io_rsrc_data_free(struct io_rsrc_data *data) 28173572984SJens Axboe { 28273572984SJens Axboe size_t size = data->nr * sizeof(data->tags[0][0]); 28373572984SJens Axboe 28473572984SJens Axboe if (data->tags) 28573572984SJens Axboe io_free_page_table((void **)data->tags, size); 28673572984SJens Axboe kfree(data); 28773572984SJens Axboe } 28873572984SJens Axboe 28973572984SJens Axboe static __cold void **io_alloc_page_table(size_t size) 29073572984SJens Axboe { 29173572984SJens Axboe unsigned i, nr_tables = DIV_ROUND_UP(size, PAGE_SIZE); 29273572984SJens Axboe size_t init_size = size; 29373572984SJens Axboe void **table; 29473572984SJens Axboe 29573572984SJens Axboe table = kcalloc(nr_tables, sizeof(*table), GFP_KERNEL_ACCOUNT); 29673572984SJens Axboe if (!table) 29773572984SJens Axboe return NULL; 29873572984SJens Axboe 29973572984SJens Axboe for (i = 0; i < nr_tables; i++) { 30073572984SJens Axboe unsigned int this_size = min_t(size_t, size, PAGE_SIZE); 30173572984SJens Axboe 30273572984SJens Axboe table[i] = kzalloc(this_size, GFP_KERNEL_ACCOUNT); 30373572984SJens Axboe if (!table[i]) { 30473572984SJens Axboe io_free_page_table(table, init_size); 30573572984SJens Axboe return NULL; 30673572984SJens Axboe } 30773572984SJens Axboe size -= this_size; 30873572984SJens Axboe } 30973572984SJens Axboe return table; 31073572984SJens Axboe } 31173572984SJens Axboe 312fc7f3a8dSPavel Begunkov __cold static int io_rsrc_data_alloc(struct io_ring_ctx *ctx, int type, 313fc7f3a8dSPavel Begunkov u64 __user *utags, 31473572984SJens Axboe unsigned nr, struct io_rsrc_data **pdata) 31573572984SJens Axboe { 31673572984SJens Axboe struct io_rsrc_data *data; 3176acd352dSLi zeming int ret = 0; 31873572984SJens Axboe unsigned i; 31973572984SJens Axboe 32073572984SJens Axboe data = kzalloc(sizeof(*data), GFP_KERNEL); 32173572984SJens Axboe if (!data) 32273572984SJens Axboe return -ENOMEM; 32373572984SJens Axboe data->tags = (u64 **)io_alloc_page_table(nr * sizeof(data->tags[0][0])); 32473572984SJens Axboe if (!data->tags) { 32573572984SJens Axboe kfree(data); 32673572984SJens Axboe return -ENOMEM; 32773572984SJens Axboe } 32873572984SJens Axboe 32973572984SJens Axboe data->nr = nr; 33073572984SJens Axboe data->ctx = ctx; 331fc7f3a8dSPavel Begunkov data->rsrc_type = type; 33273572984SJens Axboe if (utags) { 33373572984SJens Axboe ret = -EFAULT; 33473572984SJens Axboe for (i = 0; i < nr; i++) { 33573572984SJens Axboe u64 *tag_slot = io_get_tag_slot(data, i); 33673572984SJens Axboe 33773572984SJens Axboe if (copy_from_user(tag_slot, &utags[i], 33873572984SJens Axboe sizeof(*tag_slot))) 33973572984SJens Axboe goto fail; 34073572984SJens Axboe } 34173572984SJens Axboe } 34273572984SJens Axboe *pdata = data; 34373572984SJens Axboe return 0; 34473572984SJens Axboe fail: 34573572984SJens Axboe io_rsrc_data_free(data); 34673572984SJens Axboe return ret; 34773572984SJens Axboe } 34873572984SJens Axboe 34973572984SJens Axboe static int __io_sqe_files_update(struct io_ring_ctx *ctx, 35073572984SJens Axboe struct io_uring_rsrc_update2 *up, 35173572984SJens Axboe unsigned nr_args) 35273572984SJens Axboe { 35373572984SJens Axboe u64 __user *tags = u64_to_user_ptr(up->tags); 35473572984SJens Axboe __s32 __user *fds = u64_to_user_ptr(up->data); 35573572984SJens Axboe struct io_rsrc_data *data = ctx->file_data; 35673572984SJens Axboe struct io_fixed_file *file_slot; 35773572984SJens Axboe struct file *file; 35873572984SJens Axboe int fd, i, err = 0; 35973572984SJens Axboe unsigned int done; 36073572984SJens Axboe 36173572984SJens Axboe if (!ctx->file_data) 36273572984SJens Axboe return -ENXIO; 36373572984SJens Axboe if (up->offset + nr_args > ctx->nr_user_files) 36473572984SJens Axboe return -EINVAL; 36573572984SJens Axboe 36673572984SJens Axboe for (done = 0; done < nr_args; done++) { 36773572984SJens Axboe u64 tag = 0; 36873572984SJens Axboe 36973572984SJens Axboe if ((tags && copy_from_user(&tag, &tags[done], sizeof(tag))) || 37073572984SJens Axboe copy_from_user(&fd, &fds[done], sizeof(fd))) { 37173572984SJens Axboe err = -EFAULT; 37273572984SJens Axboe break; 37373572984SJens Axboe } 37473572984SJens Axboe if ((fd == IORING_REGISTER_FILES_SKIP || fd == -1) && tag) { 37573572984SJens Axboe err = -EINVAL; 37673572984SJens Axboe break; 37773572984SJens Axboe } 37873572984SJens Axboe if (fd == IORING_REGISTER_FILES_SKIP) 37973572984SJens Axboe continue; 38073572984SJens Axboe 38173572984SJens Axboe i = array_index_nospec(up->offset + done, ctx->nr_user_files); 38273572984SJens Axboe file_slot = io_fixed_file_slot(&ctx->file_table, i); 38373572984SJens Axboe 38473572984SJens Axboe if (file_slot->file_ptr) { 38573572984SJens Axboe file = (struct file *)(file_slot->file_ptr & FFS_MASK); 38663fea890SPavel Begunkov err = io_queue_rsrc_removal(data, i, file); 38773572984SJens Axboe if (err) 38873572984SJens Axboe break; 38973572984SJens Axboe file_slot->file_ptr = 0; 39073572984SJens Axboe io_file_bitmap_clear(&ctx->file_table, i); 39173572984SJens Axboe } 39273572984SJens Axboe if (fd != -1) { 39373572984SJens Axboe file = fget(fd); 39473572984SJens Axboe if (!file) { 39573572984SJens Axboe err = -EBADF; 39673572984SJens Axboe break; 39773572984SJens Axboe } 39873572984SJens Axboe /* 39973572984SJens Axboe * Don't allow io_uring instances to be registered. If 40073572984SJens Axboe * UNIX isn't enabled, then this causes a reference 40173572984SJens Axboe * cycle and this instance can never get freed. If UNIX 40273572984SJens Axboe * is enabled we'll handle it just fine, but there's 40373572984SJens Axboe * still no point in allowing a ring fd as it doesn't 40473572984SJens Axboe * support regular read/write anyway. 40573572984SJens Axboe */ 40673572984SJens Axboe if (io_is_uring_fops(file)) { 40773572984SJens Axboe fput(file); 40873572984SJens Axboe err = -EBADF; 40973572984SJens Axboe break; 41073572984SJens Axboe } 41173572984SJens Axboe err = io_scm_file_account(ctx, file); 41273572984SJens Axboe if (err) { 41373572984SJens Axboe fput(file); 41473572984SJens Axboe break; 41573572984SJens Axboe } 41673572984SJens Axboe *io_get_tag_slot(data, i) = tag; 41773572984SJens Axboe io_fixed_file_set(file_slot, file); 41873572984SJens Axboe io_file_bitmap_set(&ctx->file_table, i); 41973572984SJens Axboe } 42073572984SJens Axboe } 42173572984SJens Axboe return done ? done : err; 42273572984SJens Axboe } 42373572984SJens Axboe 42473572984SJens Axboe static int __io_sqe_buffers_update(struct io_ring_ctx *ctx, 42573572984SJens Axboe struct io_uring_rsrc_update2 *up, 42673572984SJens Axboe unsigned int nr_args) 42773572984SJens Axboe { 42873572984SJens Axboe u64 __user *tags = u64_to_user_ptr(up->tags); 42973572984SJens Axboe struct iovec iov, __user *iovs = u64_to_user_ptr(up->data); 43073572984SJens Axboe struct page *last_hpage = NULL; 43173572984SJens Axboe __u32 done; 43273572984SJens Axboe int i, err; 43373572984SJens Axboe 43473572984SJens Axboe if (!ctx->buf_data) 43573572984SJens Axboe return -ENXIO; 43673572984SJens Axboe if (up->offset + nr_args > ctx->nr_user_bufs) 43773572984SJens Axboe return -EINVAL; 43873572984SJens Axboe 43973572984SJens Axboe for (done = 0; done < nr_args; done++) { 44073572984SJens Axboe struct io_mapped_ubuf *imu; 44173572984SJens Axboe u64 tag = 0; 44273572984SJens Axboe 44373572984SJens Axboe err = io_copy_iov(ctx, &iov, iovs, done); 44473572984SJens Axboe if (err) 44573572984SJens Axboe break; 44673572984SJens Axboe if (tags && copy_from_user(&tag, &tags[done], sizeof(tag))) { 44773572984SJens Axboe err = -EFAULT; 44873572984SJens Axboe break; 44973572984SJens Axboe } 45073572984SJens Axboe err = io_buffer_validate(&iov); 45173572984SJens Axboe if (err) 45273572984SJens Axboe break; 45373572984SJens Axboe if (!iov.iov_base && tag) { 45473572984SJens Axboe err = -EINVAL; 45573572984SJens Axboe break; 45673572984SJens Axboe } 45773572984SJens Axboe err = io_sqe_buffer_register(ctx, &iov, &imu, &last_hpage); 45873572984SJens Axboe if (err) 45973572984SJens Axboe break; 46073572984SJens Axboe 4619a57fffeSPavel Begunkov i = array_index_nospec(up->offset + done, ctx->nr_user_bufs); 46273572984SJens Axboe if (ctx->user_bufs[i] != ctx->dummy_ubuf) { 46373572984SJens Axboe err = io_queue_rsrc_removal(ctx->buf_data, i, 46463fea890SPavel Begunkov ctx->user_bufs[i]); 46573572984SJens Axboe if (unlikely(err)) { 46673572984SJens Axboe io_buffer_unmap(ctx, &imu); 46773572984SJens Axboe break; 46873572984SJens Axboe } 4695ff4fdffSPavel Begunkov ctx->user_bufs[i] = ctx->dummy_ubuf; 47073572984SJens Axboe } 47173572984SJens Axboe 47273572984SJens Axboe ctx->user_bufs[i] = imu; 473953c37e0SPavel Begunkov *io_get_tag_slot(ctx->buf_data, i) = tag; 47473572984SJens Axboe } 47573572984SJens Axboe return done ? done : err; 47673572984SJens Axboe } 47773572984SJens Axboe 47873572984SJens Axboe static int __io_register_rsrc_update(struct io_ring_ctx *ctx, unsigned type, 47973572984SJens Axboe struct io_uring_rsrc_update2 *up, 48073572984SJens Axboe unsigned nr_args) 48173572984SJens Axboe { 48273572984SJens Axboe __u32 tmp; 48373572984SJens Axboe 484786788a8SPavel Begunkov lockdep_assert_held(&ctx->uring_lock); 485786788a8SPavel Begunkov 48673572984SJens Axboe if (check_add_overflow(up->offset, nr_args, &tmp)) 48773572984SJens Axboe return -EOVERFLOW; 48873572984SJens Axboe 48973572984SJens Axboe switch (type) { 49073572984SJens Axboe case IORING_RSRC_FILE: 49173572984SJens Axboe return __io_sqe_files_update(ctx, up, nr_args); 49273572984SJens Axboe case IORING_RSRC_BUFFER: 49373572984SJens Axboe return __io_sqe_buffers_update(ctx, up, nr_args); 49473572984SJens Axboe } 49573572984SJens Axboe return -EINVAL; 49673572984SJens Axboe } 49773572984SJens Axboe 49873572984SJens Axboe int io_register_files_update(struct io_ring_ctx *ctx, void __user *arg, 49973572984SJens Axboe unsigned nr_args) 50073572984SJens Axboe { 50173572984SJens Axboe struct io_uring_rsrc_update2 up; 50273572984SJens Axboe 50373572984SJens Axboe if (!nr_args) 50473572984SJens Axboe return -EINVAL; 50573572984SJens Axboe memset(&up, 0, sizeof(up)); 50673572984SJens Axboe if (copy_from_user(&up, arg, sizeof(struct io_uring_rsrc_update))) 50773572984SJens Axboe return -EFAULT; 50873572984SJens Axboe if (up.resv || up.resv2) 50973572984SJens Axboe return -EINVAL; 51073572984SJens Axboe return __io_register_rsrc_update(ctx, IORING_RSRC_FILE, &up, nr_args); 51173572984SJens Axboe } 51273572984SJens Axboe 51373572984SJens Axboe int io_register_rsrc_update(struct io_ring_ctx *ctx, void __user *arg, 51473572984SJens Axboe unsigned size, unsigned type) 51573572984SJens Axboe { 51673572984SJens Axboe struct io_uring_rsrc_update2 up; 51773572984SJens Axboe 51873572984SJens Axboe if (size != sizeof(up)) 51973572984SJens Axboe return -EINVAL; 52073572984SJens Axboe if (copy_from_user(&up, arg, sizeof(up))) 52173572984SJens Axboe return -EFAULT; 52273572984SJens Axboe if (!up.nr || up.resv || up.resv2) 52373572984SJens Axboe return -EINVAL; 52473572984SJens Axboe return __io_register_rsrc_update(ctx, type, &up, up.nr); 52573572984SJens Axboe } 52673572984SJens Axboe 52773572984SJens Axboe __cold int io_register_rsrc(struct io_ring_ctx *ctx, void __user *arg, 52873572984SJens Axboe unsigned int size, unsigned int type) 52973572984SJens Axboe { 53073572984SJens Axboe struct io_uring_rsrc_register rr; 53173572984SJens Axboe 53273572984SJens Axboe /* keep it extendible */ 53373572984SJens Axboe if (size != sizeof(rr)) 53473572984SJens Axboe return -EINVAL; 53573572984SJens Axboe 53673572984SJens Axboe memset(&rr, 0, sizeof(rr)); 53773572984SJens Axboe if (copy_from_user(&rr, arg, size)) 53873572984SJens Axboe return -EFAULT; 53973572984SJens Axboe if (!rr.nr || rr.resv2) 54073572984SJens Axboe return -EINVAL; 54173572984SJens Axboe if (rr.flags & ~IORING_RSRC_REGISTER_SPARSE) 54273572984SJens Axboe return -EINVAL; 54373572984SJens Axboe 54473572984SJens Axboe switch (type) { 54573572984SJens Axboe case IORING_RSRC_FILE: 54673572984SJens Axboe if (rr.flags & IORING_RSRC_REGISTER_SPARSE && rr.data) 54773572984SJens Axboe break; 54873572984SJens Axboe return io_sqe_files_register(ctx, u64_to_user_ptr(rr.data), 54973572984SJens Axboe rr.nr, u64_to_user_ptr(rr.tags)); 55073572984SJens Axboe case IORING_RSRC_BUFFER: 55173572984SJens Axboe if (rr.flags & IORING_RSRC_REGISTER_SPARSE && rr.data) 55273572984SJens Axboe break; 55373572984SJens Axboe return io_sqe_buffers_register(ctx, u64_to_user_ptr(rr.data), 55473572984SJens Axboe rr.nr, u64_to_user_ptr(rr.tags)); 55573572984SJens Axboe } 55673572984SJens Axboe return -EINVAL; 55773572984SJens Axboe } 55873572984SJens Axboe 559d9808cebSPavel Begunkov int io_files_update_prep(struct io_kiocb *req, const struct io_uring_sqe *sqe) 56073572984SJens Axboe { 561f2ccb5aeSStefan Metzmacher struct io_rsrc_update *up = io_kiocb_to_cmd(req, struct io_rsrc_update); 56273572984SJens Axboe 56373572984SJens Axboe if (unlikely(req->flags & (REQ_F_FIXED_FILE | REQ_F_BUFFER_SELECT))) 56473572984SJens Axboe return -EINVAL; 56573572984SJens Axboe if (sqe->rw_flags || sqe->splice_fd_in) 56673572984SJens Axboe return -EINVAL; 56773572984SJens Axboe 56873572984SJens Axboe up->offset = READ_ONCE(sqe->off); 56973572984SJens Axboe up->nr_args = READ_ONCE(sqe->len); 57073572984SJens Axboe if (!up->nr_args) 57173572984SJens Axboe return -EINVAL; 57273572984SJens Axboe up->arg = READ_ONCE(sqe->addr); 57373572984SJens Axboe return 0; 57473572984SJens Axboe } 57573572984SJens Axboe 57673572984SJens Axboe static int io_files_update_with_index_alloc(struct io_kiocb *req, 57773572984SJens Axboe unsigned int issue_flags) 57873572984SJens Axboe { 579f2ccb5aeSStefan Metzmacher struct io_rsrc_update *up = io_kiocb_to_cmd(req, struct io_rsrc_update); 58073572984SJens Axboe __s32 __user *fds = u64_to_user_ptr(up->arg); 58173572984SJens Axboe unsigned int done; 58273572984SJens Axboe struct file *file; 58373572984SJens Axboe int ret, fd; 58473572984SJens Axboe 58573572984SJens Axboe if (!req->ctx->file_data) 58673572984SJens Axboe return -ENXIO; 58773572984SJens Axboe 58873572984SJens Axboe for (done = 0; done < up->nr_args; done++) { 58973572984SJens Axboe if (copy_from_user(&fd, &fds[done], sizeof(fd))) { 59073572984SJens Axboe ret = -EFAULT; 59173572984SJens Axboe break; 59273572984SJens Axboe } 59373572984SJens Axboe 59473572984SJens Axboe file = fget(fd); 59573572984SJens Axboe if (!file) { 59673572984SJens Axboe ret = -EBADF; 59773572984SJens Axboe break; 59873572984SJens Axboe } 59973572984SJens Axboe ret = io_fixed_fd_install(req, issue_flags, file, 60073572984SJens Axboe IORING_FILE_INDEX_ALLOC); 60173572984SJens Axboe if (ret < 0) 60273572984SJens Axboe break; 60373572984SJens Axboe if (copy_to_user(&fds[done], &ret, sizeof(ret))) { 604f110ed84SJens Axboe __io_close_fixed(req->ctx, issue_flags, ret); 60573572984SJens Axboe ret = -EFAULT; 60673572984SJens Axboe break; 60773572984SJens Axboe } 60873572984SJens Axboe } 60973572984SJens Axboe 61073572984SJens Axboe if (done) 61173572984SJens Axboe return done; 61273572984SJens Axboe return ret; 61373572984SJens Axboe } 61473572984SJens Axboe 615d9808cebSPavel Begunkov int io_files_update(struct io_kiocb *req, unsigned int issue_flags) 61673572984SJens Axboe { 617f2ccb5aeSStefan Metzmacher struct io_rsrc_update *up = io_kiocb_to_cmd(req, struct io_rsrc_update); 61873572984SJens Axboe struct io_ring_ctx *ctx = req->ctx; 61973572984SJens Axboe struct io_uring_rsrc_update2 up2; 62073572984SJens Axboe int ret; 62173572984SJens Axboe 62273572984SJens Axboe up2.offset = up->offset; 62373572984SJens Axboe up2.data = up->arg; 62473572984SJens Axboe up2.nr = 0; 62573572984SJens Axboe up2.tags = 0; 62673572984SJens Axboe up2.resv = 0; 62773572984SJens Axboe up2.resv2 = 0; 62873572984SJens Axboe 62973572984SJens Axboe if (up->offset == IORING_FILE_INDEX_ALLOC) { 63073572984SJens Axboe ret = io_files_update_with_index_alloc(req, issue_flags); 63173572984SJens Axboe } else { 63273572984SJens Axboe io_ring_submit_lock(ctx, issue_flags); 63373572984SJens Axboe ret = __io_register_rsrc_update(ctx, IORING_RSRC_FILE, 63473572984SJens Axboe &up2, up->nr_args); 63573572984SJens Axboe io_ring_submit_unlock(ctx, issue_flags); 63673572984SJens Axboe } 63773572984SJens Axboe 63873572984SJens Axboe if (ret < 0) 63973572984SJens Axboe req_set_fail(req); 64073572984SJens Axboe io_req_set_res(req, ret, 0); 64173572984SJens Axboe return IOU_OK; 64273572984SJens Axboe } 64373572984SJens Axboe 64463fea890SPavel Begunkov int io_queue_rsrc_removal(struct io_rsrc_data *data, unsigned idx, void *rsrc) 64573572984SJens Axboe { 64663fea890SPavel Begunkov struct io_ring_ctx *ctx = data->ctx; 64763fea890SPavel Begunkov struct io_rsrc_node *node = ctx->rsrc_node; 64873572984SJens Axboe u64 *tag_slot = io_get_tag_slot(data, idx); 64973572984SJens Axboe 650c376644fSPavel Begunkov ctx->rsrc_node = io_rsrc_node_alloc(ctx); 651c376644fSPavel Begunkov if (unlikely(!ctx->rsrc_node)) { 652c376644fSPavel Begunkov ctx->rsrc_node = node; 65373572984SJens Axboe return -ENOMEM; 654ff7c75ecSPavel Begunkov } 65573572984SJens Axboe 656c376644fSPavel Begunkov node->item.rsrc = rsrc; 6572236b390SPavel Begunkov node->type = data->rsrc_type; 658c376644fSPavel Begunkov node->item.tag = *tag_slot; 65973572984SJens Axboe *tag_slot = 0; 660c376644fSPavel Begunkov list_add_tail(&node->node, &ctx->rsrc_ref_list); 661c376644fSPavel Begunkov io_put_rsrc_node(ctx, node); 66273572984SJens Axboe return 0; 66373572984SJens Axboe } 66473572984SJens Axboe 66573572984SJens Axboe void __io_sqe_files_unregister(struct io_ring_ctx *ctx) 66673572984SJens Axboe { 66773572984SJens Axboe int i; 66873572984SJens Axboe 66973572984SJens Axboe for (i = 0; i < ctx->nr_user_files; i++) { 67073572984SJens Axboe struct file *file = io_file_from_index(&ctx->file_table, i); 67173572984SJens Axboe 67238eddb2cSPavel Begunkov /* skip scm accounted files, they'll be freed by ->ring_sock */ 67338eddb2cSPavel Begunkov if (!file || io_file_need_scm(file)) 67473572984SJens Axboe continue; 67573572984SJens Axboe io_file_bitmap_clear(&ctx->file_table, i); 67673572984SJens Axboe fput(file); 67773572984SJens Axboe } 67873572984SJens Axboe 67973572984SJens Axboe #if defined(CONFIG_UNIX) 68073572984SJens Axboe if (ctx->ring_sock) { 68173572984SJens Axboe struct sock *sock = ctx->ring_sock->sk; 68273572984SJens Axboe struct sk_buff *skb; 68373572984SJens Axboe 68473572984SJens Axboe while ((skb = skb_dequeue(&sock->sk_receive_queue)) != NULL) 68573572984SJens Axboe kfree_skb(skb); 68673572984SJens Axboe } 68773572984SJens Axboe #endif 68873572984SJens Axboe io_free_file_tables(&ctx->file_table); 68902a4d923SSavino Dicanosa io_file_table_set_alloc_range(ctx, 0, 0); 69073572984SJens Axboe io_rsrc_data_free(ctx->file_data); 69173572984SJens Axboe ctx->file_data = NULL; 69273572984SJens Axboe ctx->nr_user_files = 0; 69373572984SJens Axboe } 69473572984SJens Axboe 69573572984SJens Axboe int io_sqe_files_unregister(struct io_ring_ctx *ctx) 69673572984SJens Axboe { 69773572984SJens Axboe unsigned nr = ctx->nr_user_files; 69873572984SJens Axboe int ret; 69973572984SJens Axboe 70073572984SJens Axboe if (!ctx->file_data) 70173572984SJens Axboe return -ENXIO; 70273572984SJens Axboe 70373572984SJens Axboe /* 70473572984SJens Axboe * Quiesce may unlock ->uring_lock, and while it's not held 70573572984SJens Axboe * prevent new requests using the table. 70673572984SJens Axboe */ 70773572984SJens Axboe ctx->nr_user_files = 0; 70873572984SJens Axboe ret = io_rsrc_ref_quiesce(ctx->file_data, ctx); 70973572984SJens Axboe ctx->nr_user_files = nr; 71073572984SJens Axboe if (!ret) 71173572984SJens Axboe __io_sqe_files_unregister(ctx); 71273572984SJens Axboe return ret; 71373572984SJens Axboe } 71473572984SJens Axboe 71573572984SJens Axboe /* 71673572984SJens Axboe * Ensure the UNIX gc is aware of our file set, so we are certain that 71773572984SJens Axboe * the io_uring can be safely unregistered on process exit, even if we have 71873572984SJens Axboe * loops in the file referencing. We account only files that can hold other 71973572984SJens Axboe * files because otherwise they can't form a loop and so are not interesting 72073572984SJens Axboe * for GC. 72173572984SJens Axboe */ 72273572984SJens Axboe int __io_scm_file_account(struct io_ring_ctx *ctx, struct file *file) 72373572984SJens Axboe { 72473572984SJens Axboe #if defined(CONFIG_UNIX) 72573572984SJens Axboe struct sock *sk = ctx->ring_sock->sk; 72673572984SJens Axboe struct sk_buff_head *head = &sk->sk_receive_queue; 72773572984SJens Axboe struct scm_fp_list *fpl; 72873572984SJens Axboe struct sk_buff *skb; 72973572984SJens Axboe 73073572984SJens Axboe if (likely(!io_file_need_scm(file))) 73173572984SJens Axboe return 0; 73273572984SJens Axboe 73373572984SJens Axboe /* 73473572984SJens Axboe * See if we can merge this file into an existing skb SCM_RIGHTS 73573572984SJens Axboe * file set. If there's no room, fall back to allocating a new skb 73673572984SJens Axboe * and filling it in. 73773572984SJens Axboe */ 73873572984SJens Axboe spin_lock_irq(&head->lock); 73973572984SJens Axboe skb = skb_peek(head); 74073572984SJens Axboe if (skb && UNIXCB(skb).fp->count < SCM_MAX_FD) 74173572984SJens Axboe __skb_unlink(skb, head); 74273572984SJens Axboe else 74373572984SJens Axboe skb = NULL; 74473572984SJens Axboe spin_unlock_irq(&head->lock); 74573572984SJens Axboe 74673572984SJens Axboe if (!skb) { 74773572984SJens Axboe fpl = kzalloc(sizeof(*fpl), GFP_KERNEL); 74873572984SJens Axboe if (!fpl) 74973572984SJens Axboe return -ENOMEM; 75073572984SJens Axboe 75173572984SJens Axboe skb = alloc_skb(0, GFP_KERNEL); 75273572984SJens Axboe if (!skb) { 75373572984SJens Axboe kfree(fpl); 75473572984SJens Axboe return -ENOMEM; 75573572984SJens Axboe } 75673572984SJens Axboe 75773572984SJens Axboe fpl->user = get_uid(current_user()); 75873572984SJens Axboe fpl->max = SCM_MAX_FD; 75973572984SJens Axboe fpl->count = 0; 76073572984SJens Axboe 76173572984SJens Axboe UNIXCB(skb).fp = fpl; 76273572984SJens Axboe skb->sk = sk; 76310369080SEric Dumazet skb->destructor = io_uring_destruct_scm; 76473572984SJens Axboe refcount_add(skb->truesize, &sk->sk_wmem_alloc); 76573572984SJens Axboe } 76673572984SJens Axboe 76773572984SJens Axboe fpl = UNIXCB(skb).fp; 76873572984SJens Axboe fpl->fp[fpl->count++] = get_file(file); 76973572984SJens Axboe unix_inflight(fpl->user, file); 77073572984SJens Axboe skb_queue_head(head, skb); 77173572984SJens Axboe fput(file); 77273572984SJens Axboe #endif 77373572984SJens Axboe return 0; 77473572984SJens Axboe } 77573572984SJens Axboe 776d581076bSPavel Begunkov static __cold void io_rsrc_file_scm_put(struct io_ring_ctx *ctx, struct file *file) 77773572984SJens Axboe { 77873572984SJens Axboe #if defined(CONFIG_UNIX) 77973572984SJens Axboe struct sock *sock = ctx->ring_sock->sk; 78073572984SJens Axboe struct sk_buff_head list, *head = &sock->sk_receive_queue; 78173572984SJens Axboe struct sk_buff *skb; 78273572984SJens Axboe int i; 78373572984SJens Axboe 78473572984SJens Axboe __skb_queue_head_init(&list); 78573572984SJens Axboe 78673572984SJens Axboe /* 78773572984SJens Axboe * Find the skb that holds this file in its SCM_RIGHTS. When found, 78873572984SJens Axboe * remove this entry and rearrange the file array. 78973572984SJens Axboe */ 79073572984SJens Axboe skb = skb_dequeue(head); 79173572984SJens Axboe while (skb) { 79273572984SJens Axboe struct scm_fp_list *fp; 79373572984SJens Axboe 79473572984SJens Axboe fp = UNIXCB(skb).fp; 79573572984SJens Axboe for (i = 0; i < fp->count; i++) { 79673572984SJens Axboe int left; 79773572984SJens Axboe 79873572984SJens Axboe if (fp->fp[i] != file) 79973572984SJens Axboe continue; 80073572984SJens Axboe 80173572984SJens Axboe unix_notinflight(fp->user, fp->fp[i]); 80273572984SJens Axboe left = fp->count - 1 - i; 80373572984SJens Axboe if (left) { 80473572984SJens Axboe memmove(&fp->fp[i], &fp->fp[i + 1], 80573572984SJens Axboe left * sizeof(struct file *)); 80673572984SJens Axboe } 80773572984SJens Axboe fp->count--; 80873572984SJens Axboe if (!fp->count) { 80973572984SJens Axboe kfree_skb(skb); 81073572984SJens Axboe skb = NULL; 81173572984SJens Axboe } else { 81273572984SJens Axboe __skb_queue_tail(&list, skb); 81373572984SJens Axboe } 81473572984SJens Axboe fput(file); 81573572984SJens Axboe file = NULL; 81673572984SJens Axboe break; 81773572984SJens Axboe } 81873572984SJens Axboe 81973572984SJens Axboe if (!file) 82073572984SJens Axboe break; 82173572984SJens Axboe 82273572984SJens Axboe __skb_queue_tail(&list, skb); 82373572984SJens Axboe 82473572984SJens Axboe skb = skb_dequeue(head); 82573572984SJens Axboe } 82673572984SJens Axboe 82773572984SJens Axboe if (skb_peek(&list)) { 82873572984SJens Axboe spin_lock_irq(&head->lock); 82973572984SJens Axboe while ((skb = __skb_dequeue(&list)) != NULL) 83073572984SJens Axboe __skb_queue_tail(head, skb); 83173572984SJens Axboe spin_unlock_irq(&head->lock); 83273572984SJens Axboe } 83373572984SJens Axboe #endif 83473572984SJens Axboe } 83573572984SJens Axboe 836d581076bSPavel Begunkov static void io_rsrc_file_put(struct io_ring_ctx *ctx, struct io_rsrc_put *prsrc) 837d581076bSPavel Begunkov { 838d581076bSPavel Begunkov struct file *file = prsrc->file; 839d581076bSPavel Begunkov 840d581076bSPavel Begunkov if (likely(!io_file_need_scm(file))) 841d581076bSPavel Begunkov fput(file); 842d581076bSPavel Begunkov else 843d581076bSPavel Begunkov io_rsrc_file_scm_put(ctx, file); 844d581076bSPavel Begunkov } 845d581076bSPavel Begunkov 84673572984SJens Axboe int io_sqe_files_register(struct io_ring_ctx *ctx, void __user *arg, 84773572984SJens Axboe unsigned nr_args, u64 __user *tags) 84873572984SJens Axboe { 84973572984SJens Axboe __s32 __user *fds = (__s32 __user *) arg; 85073572984SJens Axboe struct file *file; 85173572984SJens Axboe int fd, ret; 85273572984SJens Axboe unsigned i; 85373572984SJens Axboe 85473572984SJens Axboe if (ctx->file_data) 85573572984SJens Axboe return -EBUSY; 85673572984SJens Axboe if (!nr_args) 85773572984SJens Axboe return -EINVAL; 85873572984SJens Axboe if (nr_args > IORING_MAX_FIXED_FILES) 85973572984SJens Axboe return -EMFILE; 86073572984SJens Axboe if (nr_args > rlimit(RLIMIT_NOFILE)) 86173572984SJens Axboe return -EMFILE; 862fc7f3a8dSPavel Begunkov ret = io_rsrc_data_alloc(ctx, IORING_RSRC_FILE, tags, nr_args, 86373572984SJens Axboe &ctx->file_data); 86473572984SJens Axboe if (ret) 86573572984SJens Axboe return ret; 86673572984SJens Axboe 86773572984SJens Axboe if (!io_alloc_file_tables(&ctx->file_table, nr_args)) { 86873572984SJens Axboe io_rsrc_data_free(ctx->file_data); 86973572984SJens Axboe ctx->file_data = NULL; 87073572984SJens Axboe return -ENOMEM; 87173572984SJens Axboe } 87273572984SJens Axboe 87373572984SJens Axboe for (i = 0; i < nr_args; i++, ctx->nr_user_files++) { 87473572984SJens Axboe struct io_fixed_file *file_slot; 87573572984SJens Axboe 87673572984SJens Axboe if (fds && copy_from_user(&fd, &fds[i], sizeof(fd))) { 87773572984SJens Axboe ret = -EFAULT; 87873572984SJens Axboe goto fail; 87973572984SJens Axboe } 88073572984SJens Axboe /* allow sparse sets */ 88173572984SJens Axboe if (!fds || fd == -1) { 88273572984SJens Axboe ret = -EINVAL; 88373572984SJens Axboe if (unlikely(*io_get_tag_slot(ctx->file_data, i))) 88473572984SJens Axboe goto fail; 88573572984SJens Axboe continue; 88673572984SJens Axboe } 88773572984SJens Axboe 88873572984SJens Axboe file = fget(fd); 88973572984SJens Axboe ret = -EBADF; 89073572984SJens Axboe if (unlikely(!file)) 89173572984SJens Axboe goto fail; 89273572984SJens Axboe 89373572984SJens Axboe /* 89473572984SJens Axboe * Don't allow io_uring instances to be registered. If UNIX 89573572984SJens Axboe * isn't enabled, then this causes a reference cycle and this 89673572984SJens Axboe * instance can never get freed. If UNIX is enabled we'll 89773572984SJens Axboe * handle it just fine, but there's still no point in allowing 89873572984SJens Axboe * a ring fd as it doesn't support regular read/write anyway. 89973572984SJens Axboe */ 90073572984SJens Axboe if (io_is_uring_fops(file)) { 90173572984SJens Axboe fput(file); 90273572984SJens Axboe goto fail; 90373572984SJens Axboe } 90473572984SJens Axboe ret = io_scm_file_account(ctx, file); 90573572984SJens Axboe if (ret) { 90673572984SJens Axboe fput(file); 90773572984SJens Axboe goto fail; 90873572984SJens Axboe } 90973572984SJens Axboe file_slot = io_fixed_file_slot(&ctx->file_table, i); 91073572984SJens Axboe io_fixed_file_set(file_slot, file); 91173572984SJens Axboe io_file_bitmap_set(&ctx->file_table, i); 91273572984SJens Axboe } 91373572984SJens Axboe 9146e73dffbSPavel Begunkov /* default it to the whole table */ 9156e73dffbSPavel Begunkov io_file_table_set_alloc_range(ctx, 0, ctx->nr_user_files); 91673572984SJens Axboe return 0; 91773572984SJens Axboe fail: 91873572984SJens Axboe __io_sqe_files_unregister(ctx); 91973572984SJens Axboe return ret; 92073572984SJens Axboe } 92173572984SJens Axboe 92273572984SJens Axboe static void io_rsrc_buf_put(struct io_ring_ctx *ctx, struct io_rsrc_put *prsrc) 92373572984SJens Axboe { 92473572984SJens Axboe io_buffer_unmap(ctx, &prsrc->buf); 92573572984SJens Axboe prsrc->buf = NULL; 92673572984SJens Axboe } 92773572984SJens Axboe 92873572984SJens Axboe void __io_sqe_buffers_unregister(struct io_ring_ctx *ctx) 92973572984SJens Axboe { 93073572984SJens Axboe unsigned int i; 93173572984SJens Axboe 93273572984SJens Axboe for (i = 0; i < ctx->nr_user_bufs; i++) 93373572984SJens Axboe io_buffer_unmap(ctx, &ctx->user_bufs[i]); 93473572984SJens Axboe kfree(ctx->user_bufs); 93573572984SJens Axboe io_rsrc_data_free(ctx->buf_data); 93673572984SJens Axboe ctx->user_bufs = NULL; 93773572984SJens Axboe ctx->buf_data = NULL; 93873572984SJens Axboe ctx->nr_user_bufs = 0; 93973572984SJens Axboe } 94073572984SJens Axboe 94173572984SJens Axboe int io_sqe_buffers_unregister(struct io_ring_ctx *ctx) 94273572984SJens Axboe { 94373572984SJens Axboe unsigned nr = ctx->nr_user_bufs; 94473572984SJens Axboe int ret; 94573572984SJens Axboe 94673572984SJens Axboe if (!ctx->buf_data) 94773572984SJens Axboe return -ENXIO; 94873572984SJens Axboe 94973572984SJens Axboe /* 95073572984SJens Axboe * Quiesce may unlock ->uring_lock, and while it's not held 95173572984SJens Axboe * prevent new requests using the table. 95273572984SJens Axboe */ 95373572984SJens Axboe ctx->nr_user_bufs = 0; 95473572984SJens Axboe ret = io_rsrc_ref_quiesce(ctx->buf_data, ctx); 95573572984SJens Axboe ctx->nr_user_bufs = nr; 95673572984SJens Axboe if (!ret) 95773572984SJens Axboe __io_sqe_buffers_unregister(ctx); 95873572984SJens Axboe return ret; 95973572984SJens Axboe } 96073572984SJens Axboe 96173572984SJens Axboe /* 96273572984SJens Axboe * Not super efficient, but this is just a registration time. And we do cache 96373572984SJens Axboe * the last compound head, so generally we'll only do a full search if we don't 96473572984SJens Axboe * match that one. 96573572984SJens Axboe * 96673572984SJens Axboe * We check if the given compound head page has already been accounted, to 96773572984SJens Axboe * avoid double accounting it. This allows us to account the full size of the 96873572984SJens Axboe * page, not just the constituent pages of a huge page. 96973572984SJens Axboe */ 97073572984SJens Axboe static bool headpage_already_acct(struct io_ring_ctx *ctx, struct page **pages, 97173572984SJens Axboe int nr_pages, struct page *hpage) 97273572984SJens Axboe { 97373572984SJens Axboe int i, j; 97473572984SJens Axboe 97573572984SJens Axboe /* check current page array */ 97673572984SJens Axboe for (i = 0; i < nr_pages; i++) { 97773572984SJens Axboe if (!PageCompound(pages[i])) 97873572984SJens Axboe continue; 97973572984SJens Axboe if (compound_head(pages[i]) == hpage) 98073572984SJens Axboe return true; 98173572984SJens Axboe } 98273572984SJens Axboe 98373572984SJens Axboe /* check previously registered pages */ 98473572984SJens Axboe for (i = 0; i < ctx->nr_user_bufs; i++) { 98573572984SJens Axboe struct io_mapped_ubuf *imu = ctx->user_bufs[i]; 98673572984SJens Axboe 98773572984SJens Axboe for (j = 0; j < imu->nr_bvecs; j++) { 98873572984SJens Axboe if (!PageCompound(imu->bvec[j].bv_page)) 98973572984SJens Axboe continue; 99073572984SJens Axboe if (compound_head(imu->bvec[j].bv_page) == hpage) 99173572984SJens Axboe return true; 99273572984SJens Axboe } 99373572984SJens Axboe } 99473572984SJens Axboe 99573572984SJens Axboe return false; 99673572984SJens Axboe } 99773572984SJens Axboe 99873572984SJens Axboe static int io_buffer_account_pin(struct io_ring_ctx *ctx, struct page **pages, 99973572984SJens Axboe int nr_pages, struct io_mapped_ubuf *imu, 100073572984SJens Axboe struct page **last_hpage) 100173572984SJens Axboe { 100273572984SJens Axboe int i, ret; 100373572984SJens Axboe 100473572984SJens Axboe imu->acct_pages = 0; 100573572984SJens Axboe for (i = 0; i < nr_pages; i++) { 100673572984SJens Axboe if (!PageCompound(pages[i])) { 100773572984SJens Axboe imu->acct_pages++; 100873572984SJens Axboe } else { 100973572984SJens Axboe struct page *hpage; 101073572984SJens Axboe 101173572984SJens Axboe hpage = compound_head(pages[i]); 101273572984SJens Axboe if (hpage == *last_hpage) 101373572984SJens Axboe continue; 101473572984SJens Axboe *last_hpage = hpage; 101573572984SJens Axboe if (headpage_already_acct(ctx, pages, i, hpage)) 101673572984SJens Axboe continue; 101773572984SJens Axboe imu->acct_pages += page_size(hpage) >> PAGE_SHIFT; 101873572984SJens Axboe } 101973572984SJens Axboe } 102073572984SJens Axboe 102173572984SJens Axboe if (!imu->acct_pages) 102273572984SJens Axboe return 0; 102373572984SJens Axboe 102473572984SJens Axboe ret = io_account_mem(ctx, imu->acct_pages); 102573572984SJens Axboe if (ret) 102673572984SJens Axboe imu->acct_pages = 0; 102773572984SJens Axboe return ret; 102873572984SJens Axboe } 102973572984SJens Axboe 103073572984SJens Axboe struct page **io_pin_pages(unsigned long ubuf, unsigned long len, int *npages) 103173572984SJens Axboe { 103273572984SJens Axboe unsigned long start, end, nr_pages; 103373572984SJens Axboe struct page **pages = NULL; 103434ed8d0dSLorenzo Stoakes int pret, ret = -ENOMEM; 103573572984SJens Axboe 103673572984SJens Axboe end = (ubuf + len + PAGE_SIZE - 1) >> PAGE_SHIFT; 103773572984SJens Axboe start = ubuf >> PAGE_SHIFT; 103873572984SJens Axboe nr_pages = end - start; 103973572984SJens Axboe 104073572984SJens Axboe pages = kvmalloc_array(nr_pages, sizeof(struct page *), GFP_KERNEL); 104173572984SJens Axboe if (!pages) 104273572984SJens Axboe goto done; 104373572984SJens Axboe 104473572984SJens Axboe ret = 0; 104573572984SJens Axboe mmap_read_lock(current->mm); 104673572984SJens Axboe pret = pin_user_pages(ubuf, nr_pages, FOLL_WRITE | FOLL_LONGTERM, 1047*4c630f30SLorenzo Stoakes pages); 104834ed8d0dSLorenzo Stoakes if (pret == nr_pages) 104973572984SJens Axboe *npages = nr_pages; 105034ed8d0dSLorenzo Stoakes else 105173572984SJens Axboe ret = pret < 0 ? pret : -EFAULT; 105234ed8d0dSLorenzo Stoakes 105373572984SJens Axboe mmap_read_unlock(current->mm); 105473572984SJens Axboe if (ret) { 105534ed8d0dSLorenzo Stoakes /* if we did partial map, release any pages we did get */ 105673572984SJens Axboe if (pret > 0) 105773572984SJens Axboe unpin_user_pages(pages, pret); 105873572984SJens Axboe goto done; 105973572984SJens Axboe } 106073572984SJens Axboe ret = 0; 106173572984SJens Axboe done: 106273572984SJens Axboe if (ret < 0) { 106373572984SJens Axboe kvfree(pages); 106473572984SJens Axboe pages = ERR_PTR(ret); 106573572984SJens Axboe } 106673572984SJens Axboe return pages; 106773572984SJens Axboe } 106873572984SJens Axboe 106973572984SJens Axboe static int io_sqe_buffer_register(struct io_ring_ctx *ctx, struct iovec *iov, 107073572984SJens Axboe struct io_mapped_ubuf **pimu, 107173572984SJens Axboe struct page **last_hpage) 107273572984SJens Axboe { 107373572984SJens Axboe struct io_mapped_ubuf *imu = NULL; 107473572984SJens Axboe struct page **pages = NULL; 107573572984SJens Axboe unsigned long off; 107673572984SJens Axboe size_t size; 107773572984SJens Axboe int ret, nr_pages, i; 1078977bc873SJens Axboe struct folio *folio = NULL; 107973572984SJens Axboe 108073572984SJens Axboe *pimu = ctx->dummy_ubuf; 10815ff4fdffSPavel Begunkov if (!iov->iov_base) 108273572984SJens Axboe return 0; 108373572984SJens Axboe 108473572984SJens Axboe ret = -ENOMEM; 108573572984SJens Axboe pages = io_pin_pages((unsigned long) iov->iov_base, iov->iov_len, 108673572984SJens Axboe &nr_pages); 108773572984SJens Axboe if (IS_ERR(pages)) { 108873572984SJens Axboe ret = PTR_ERR(pages); 108973572984SJens Axboe pages = NULL; 109073572984SJens Axboe goto done; 109173572984SJens Axboe } 109273572984SJens Axboe 109357bebf80SPavel Begunkov /* If it's a huge page, try to coalesce them into a single bvec entry */ 109457bebf80SPavel Begunkov if (nr_pages > 1) { 109557bebf80SPavel Begunkov folio = page_folio(pages[0]); 109657bebf80SPavel Begunkov for (i = 1; i < nr_pages; i++) { 1097776617dbSTobias Holl /* 1098776617dbSTobias Holl * Pages must be consecutive and on the same folio for 1099776617dbSTobias Holl * this to work 1100776617dbSTobias Holl */ 1101776617dbSTobias Holl if (page_folio(pages[i]) != folio || 1102776617dbSTobias Holl pages[i] != pages[i - 1] + 1) { 110357bebf80SPavel Begunkov folio = NULL; 110457bebf80SPavel Begunkov break; 110557bebf80SPavel Begunkov } 110657bebf80SPavel Begunkov } 110757bebf80SPavel Begunkov if (folio) { 1108d2acf789SPavel Begunkov /* 1109d2acf789SPavel Begunkov * The pages are bound to the folio, it doesn't 1110d2acf789SPavel Begunkov * actually unpin them but drops all but one reference, 1111d2acf789SPavel Begunkov * which is usually put down by io_buffer_unmap(). 1112d2acf789SPavel Begunkov * Note, needs a better helper. 1113d2acf789SPavel Begunkov */ 1114d2acf789SPavel Begunkov unpin_user_pages(&pages[1], nr_pages - 1); 111557bebf80SPavel Begunkov nr_pages = 1; 111657bebf80SPavel Begunkov } 111757bebf80SPavel Begunkov } 111857bebf80SPavel Begunkov 111973572984SJens Axboe imu = kvmalloc(struct_size(imu, bvec, nr_pages), GFP_KERNEL); 112073572984SJens Axboe if (!imu) 112173572984SJens Axboe goto done; 112273572984SJens Axboe 112373572984SJens Axboe ret = io_buffer_account_pin(ctx, pages, nr_pages, imu, last_hpage); 112473572984SJens Axboe if (ret) { 112573572984SJens Axboe unpin_user_pages(pages, nr_pages); 112673572984SJens Axboe goto done; 112773572984SJens Axboe } 112873572984SJens Axboe 112973572984SJens Axboe off = (unsigned long) iov->iov_base & ~PAGE_MASK; 113073572984SJens Axboe size = iov->iov_len; 113157bebf80SPavel Begunkov /* store original address for later verification */ 113257bebf80SPavel Begunkov imu->ubuf = (unsigned long) iov->iov_base; 113357bebf80SPavel Begunkov imu->ubuf_end = imu->ubuf + iov->iov_len; 113457bebf80SPavel Begunkov imu->nr_bvecs = nr_pages; 113557bebf80SPavel Begunkov *pimu = imu; 113657bebf80SPavel Begunkov ret = 0; 113757bebf80SPavel Begunkov 113857bebf80SPavel Begunkov if (folio) { 113957bebf80SPavel Begunkov bvec_set_page(&imu->bvec[0], pages[0], size, off); 114057bebf80SPavel Begunkov goto done; 114157bebf80SPavel Begunkov } 114273572984SJens Axboe for (i = 0; i < nr_pages; i++) { 114373572984SJens Axboe size_t vec_len; 114473572984SJens Axboe 114573572984SJens Axboe vec_len = min_t(size_t, size, PAGE_SIZE - off); 1146cc342a21SChristoph Hellwig bvec_set_page(&imu->bvec[i], pages[i], vec_len, off); 114773572984SJens Axboe off = 0; 114873572984SJens Axboe size -= vec_len; 114973572984SJens Axboe } 115073572984SJens Axboe done: 115173572984SJens Axboe if (ret) 115273572984SJens Axboe kvfree(imu); 115373572984SJens Axboe kvfree(pages); 115473572984SJens Axboe return ret; 115573572984SJens Axboe } 115673572984SJens Axboe 115773572984SJens Axboe static int io_buffers_map_alloc(struct io_ring_ctx *ctx, unsigned int nr_args) 115873572984SJens Axboe { 115973572984SJens Axboe ctx->user_bufs = kcalloc(nr_args, sizeof(*ctx->user_bufs), GFP_KERNEL); 116073572984SJens Axboe return ctx->user_bufs ? 0 : -ENOMEM; 116173572984SJens Axboe } 116273572984SJens Axboe 116373572984SJens Axboe int io_sqe_buffers_register(struct io_ring_ctx *ctx, void __user *arg, 116473572984SJens Axboe unsigned int nr_args, u64 __user *tags) 116573572984SJens Axboe { 116673572984SJens Axboe struct page *last_hpage = NULL; 116773572984SJens Axboe struct io_rsrc_data *data; 116873572984SJens Axboe int i, ret; 116973572984SJens Axboe struct iovec iov; 117073572984SJens Axboe 117173572984SJens Axboe BUILD_BUG_ON(IORING_MAX_REG_BUFFERS >= (1u << 16)); 117273572984SJens Axboe 117373572984SJens Axboe if (ctx->user_bufs) 117473572984SJens Axboe return -EBUSY; 117573572984SJens Axboe if (!nr_args || nr_args > IORING_MAX_REG_BUFFERS) 117673572984SJens Axboe return -EINVAL; 1177fc7f3a8dSPavel Begunkov ret = io_rsrc_data_alloc(ctx, IORING_RSRC_BUFFER, tags, nr_args, &data); 117873572984SJens Axboe if (ret) 117973572984SJens Axboe return ret; 118073572984SJens Axboe ret = io_buffers_map_alloc(ctx, nr_args); 118173572984SJens Axboe if (ret) { 118273572984SJens Axboe io_rsrc_data_free(data); 118373572984SJens Axboe return ret; 118473572984SJens Axboe } 118573572984SJens Axboe 118673572984SJens Axboe for (i = 0; i < nr_args; i++, ctx->nr_user_bufs++) { 118773572984SJens Axboe if (arg) { 118873572984SJens Axboe ret = io_copy_iov(ctx, &iov, arg, i); 118973572984SJens Axboe if (ret) 119073572984SJens Axboe break; 119173572984SJens Axboe ret = io_buffer_validate(&iov); 119273572984SJens Axboe if (ret) 119373572984SJens Axboe break; 119473572984SJens Axboe } else { 119573572984SJens Axboe memset(&iov, 0, sizeof(iov)); 119673572984SJens Axboe } 119773572984SJens Axboe 119873572984SJens Axboe if (!iov.iov_base && *io_get_tag_slot(data, i)) { 119973572984SJens Axboe ret = -EINVAL; 120073572984SJens Axboe break; 120173572984SJens Axboe } 120273572984SJens Axboe 120373572984SJens Axboe ret = io_sqe_buffer_register(ctx, &iov, &ctx->user_bufs[i], 120473572984SJens Axboe &last_hpage); 120573572984SJens Axboe if (ret) 120673572984SJens Axboe break; 120773572984SJens Axboe } 120873572984SJens Axboe 120973572984SJens Axboe WARN_ON_ONCE(ctx->buf_data); 121073572984SJens Axboe 121173572984SJens Axboe ctx->buf_data = data; 121273572984SJens Axboe if (ret) 121373572984SJens Axboe __io_sqe_buffers_unregister(ctx); 121473572984SJens Axboe return ret; 121573572984SJens Axboe } 1216c059f785SPavel Begunkov 1217c059f785SPavel Begunkov int io_import_fixed(int ddir, struct iov_iter *iter, 1218c059f785SPavel Begunkov struct io_mapped_ubuf *imu, 1219c059f785SPavel Begunkov u64 buf_addr, size_t len) 1220c059f785SPavel Begunkov { 1221c059f785SPavel Begunkov u64 buf_end; 1222c059f785SPavel Begunkov size_t offset; 1223c059f785SPavel Begunkov 1224c059f785SPavel Begunkov if (WARN_ON_ONCE(!imu)) 1225c059f785SPavel Begunkov return -EFAULT; 1226c059f785SPavel Begunkov if (unlikely(check_add_overflow(buf_addr, (u64)len, &buf_end))) 1227c059f785SPavel Begunkov return -EFAULT; 1228c059f785SPavel Begunkov /* not inside the mapped region */ 1229c059f785SPavel Begunkov if (unlikely(buf_addr < imu->ubuf || buf_end > imu->ubuf_end)) 1230c059f785SPavel Begunkov return -EFAULT; 1231c059f785SPavel Begunkov 1232c059f785SPavel Begunkov /* 12336bf65a1bSPavel Begunkov * Might not be a start of buffer, set size appropriately 1234c059f785SPavel Begunkov * and advance us to the beginning. 1235c059f785SPavel Begunkov */ 1236c059f785SPavel Begunkov offset = buf_addr - imu->ubuf; 1237c059f785SPavel Begunkov iov_iter_bvec(iter, ddir, imu->bvec, imu->nr_bvecs, offset + len); 1238c059f785SPavel Begunkov 1239c059f785SPavel Begunkov if (offset) { 1240c059f785SPavel Begunkov /* 1241c059f785SPavel Begunkov * Don't use iov_iter_advance() here, as it's really slow for 1242c059f785SPavel Begunkov * using the latter parts of a big fixed buffer - it iterates 1243c059f785SPavel Begunkov * over each segment manually. We can cheat a bit here, because 1244c059f785SPavel Begunkov * we know that: 1245c059f785SPavel Begunkov * 1246c059f785SPavel Begunkov * 1) it's a BVEC iter, we set it up 1247c059f785SPavel Begunkov * 2) all bvecs are PAGE_SIZE in size, except potentially the 1248c059f785SPavel Begunkov * first and last bvec 1249c059f785SPavel Begunkov * 1250c059f785SPavel Begunkov * So just find our index, and adjust the iterator afterwards. 1251c059f785SPavel Begunkov * If the offset is within the first bvec (or the whole first 1252c059f785SPavel Begunkov * bvec, just use iov_iter_advance(). This makes it easier 1253c059f785SPavel Begunkov * since we can just skip the first segment, which may not 1254c059f785SPavel Begunkov * be PAGE_SIZE aligned. 1255c059f785SPavel Begunkov */ 1256c059f785SPavel Begunkov const struct bio_vec *bvec = imu->bvec; 1257c059f785SPavel Begunkov 1258c059f785SPavel Begunkov if (offset <= bvec->bv_len) { 125957bebf80SPavel Begunkov /* 126057bebf80SPavel Begunkov * Note, huge pages buffers consists of one large 126157bebf80SPavel Begunkov * bvec entry and should always go this way. The other 126257bebf80SPavel Begunkov * branch doesn't expect non PAGE_SIZE'd chunks. 126357bebf80SPavel Begunkov */ 1264b000ae0eSPavel Begunkov iter->bvec = bvec; 1265b000ae0eSPavel Begunkov iter->nr_segs = bvec->bv_len; 1266b000ae0eSPavel Begunkov iter->count -= offset; 1267b000ae0eSPavel Begunkov iter->iov_offset = offset; 1268c059f785SPavel Begunkov } else { 1269c059f785SPavel Begunkov unsigned long seg_skip; 1270c059f785SPavel Begunkov 1271c059f785SPavel Begunkov /* skip first vec */ 1272c059f785SPavel Begunkov offset -= bvec->bv_len; 1273c059f785SPavel Begunkov seg_skip = 1 + (offset >> PAGE_SHIFT); 1274c059f785SPavel Begunkov 1275c059f785SPavel Begunkov iter->bvec = bvec + seg_skip; 1276c059f785SPavel Begunkov iter->nr_segs -= seg_skip; 1277c059f785SPavel Begunkov iter->count -= bvec->bv_len + offset; 1278c059f785SPavel Begunkov iter->iov_offset = offset & ~PAGE_MASK; 1279c059f785SPavel Begunkov } 1280c059f785SPavel Begunkov } 1281c059f785SPavel Begunkov 1282c059f785SPavel Begunkov return 0; 1283c059f785SPavel Begunkov } 1284