Merge tag 'block-6.1-2022-11-18' of git://git.kernel.dk/linux
[linux-block.git] / net / sunrpc / sched.c
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * linux/net/sunrpc/sched.c
4  *
5  * Scheduling for synchronous and asynchronous RPC requests.
6  *
7  * Copyright (C) 1996 Olaf Kirch, <okir@monad.swb.de>
8  *
9  * TCP NFS related read + write fixes
10  * (C) 1999 Dave Airlie, University of Limerick, Ireland <airlied@linux.ie>
11  */
12
13 #include <linux/module.h>
14
15 #include <linux/sched.h>
16 #include <linux/interrupt.h>
17 #include <linux/slab.h>
18 #include <linux/mempool.h>
19 #include <linux/smp.h>
20 #include <linux/spinlock.h>
21 #include <linux/mutex.h>
22 #include <linux/freezer.h>
23 #include <linux/sched/mm.h>
24
25 #include <linux/sunrpc/clnt.h>
26 #include <linux/sunrpc/metrics.h>
27
28 #include "sunrpc.h"
29
30 #define CREATE_TRACE_POINTS
31 #include <trace/events/sunrpc.h>
32
33 /*
34  * RPC slabs and memory pools
35  */
36 #define RPC_BUFFER_MAXSIZE      (2048)
37 #define RPC_BUFFER_POOLSIZE     (8)
38 #define RPC_TASK_POOLSIZE       (8)
39 static struct kmem_cache        *rpc_task_slabp __read_mostly;
40 static struct kmem_cache        *rpc_buffer_slabp __read_mostly;
41 static mempool_t        *rpc_task_mempool __read_mostly;
42 static mempool_t        *rpc_buffer_mempool __read_mostly;
43
44 static void                     rpc_async_schedule(struct work_struct *);
45 static void                      rpc_release_task(struct rpc_task *task);
46 static void __rpc_queue_timer_fn(struct work_struct *);
47
48 /*
49  * RPC tasks sit here while waiting for conditions to improve.
50  */
51 static struct rpc_wait_queue delay_queue;
52
53 /*
54  * rpciod-related stuff
55  */
56 struct workqueue_struct *rpciod_workqueue __read_mostly;
57 struct workqueue_struct *xprtiod_workqueue __read_mostly;
58 EXPORT_SYMBOL_GPL(xprtiod_workqueue);
59
60 gfp_t rpc_task_gfp_mask(void)
61 {
62         if (current->flags & PF_WQ_WORKER)
63                 return GFP_KERNEL | __GFP_NORETRY | __GFP_NOWARN;
64         return GFP_KERNEL;
65 }
66 EXPORT_SYMBOL_GPL(rpc_task_gfp_mask);
67
68 bool rpc_task_set_rpc_status(struct rpc_task *task, int rpc_status)
69 {
70         if (cmpxchg(&task->tk_rpc_status, 0, rpc_status) == 0)
71                 return true;
72         return false;
73 }
74
75 unsigned long
76 rpc_task_timeout(const struct rpc_task *task)
77 {
78         unsigned long timeout = READ_ONCE(task->tk_timeout);
79
80         if (timeout != 0) {
81                 unsigned long now = jiffies;
82                 if (time_before(now, timeout))
83                         return timeout - now;
84         }
85         return 0;
86 }
87 EXPORT_SYMBOL_GPL(rpc_task_timeout);
88
89 /*
90  * Disable the timer for a given RPC task. Should be called with
91  * queue->lock and bh_disabled in order to avoid races within
92  * rpc_run_timer().
93  */
94 static void
95 __rpc_disable_timer(struct rpc_wait_queue *queue, struct rpc_task *task)
96 {
97         if (list_empty(&task->u.tk_wait.timer_list))
98                 return;
99         task->tk_timeout = 0;
100         list_del(&task->u.tk_wait.timer_list);
101         if (list_empty(&queue->timer_list.list))
102                 cancel_delayed_work(&queue->timer_list.dwork);
103 }
104
105 static void
106 rpc_set_queue_timer(struct rpc_wait_queue *queue, unsigned long expires)
107 {
108         unsigned long now = jiffies;
109         queue->timer_list.expires = expires;
110         if (time_before_eq(expires, now))
111                 expires = 0;
112         else
113                 expires -= now;
114         mod_delayed_work(rpciod_workqueue, &queue->timer_list.dwork, expires);
115 }
116
117 /*
118  * Set up a timer for the current task.
119  */
120 static void
121 __rpc_add_timer(struct rpc_wait_queue *queue, struct rpc_task *task,
122                 unsigned long timeout)
123 {
124         task->tk_timeout = timeout;
125         if (list_empty(&queue->timer_list.list) || time_before(timeout, queue->timer_list.expires))
126                 rpc_set_queue_timer(queue, timeout);
127         list_add(&task->u.tk_wait.timer_list, &queue->timer_list.list);
128 }
129
130 static void rpc_set_waitqueue_priority(struct rpc_wait_queue *queue, int priority)
131 {
132         if (queue->priority != priority) {
133                 queue->priority = priority;
134                 queue->nr = 1U << priority;
135         }
136 }
137
138 static void rpc_reset_waitqueue_priority(struct rpc_wait_queue *queue)
139 {
140         rpc_set_waitqueue_priority(queue, queue->maxpriority);
141 }
142
143 /*
144  * Add a request to a queue list
145  */
146 static void
147 __rpc_list_enqueue_task(struct list_head *q, struct rpc_task *task)
148 {
149         struct rpc_task *t;
150
151         list_for_each_entry(t, q, u.tk_wait.list) {
152                 if (t->tk_owner == task->tk_owner) {
153                         list_add_tail(&task->u.tk_wait.links,
154                                         &t->u.tk_wait.links);
155                         /* Cache the queue head in task->u.tk_wait.list */
156                         task->u.tk_wait.list.next = q;
157                         task->u.tk_wait.list.prev = NULL;
158                         return;
159                 }
160         }
161         INIT_LIST_HEAD(&task->u.tk_wait.links);
162         list_add_tail(&task->u.tk_wait.list, q);
163 }
164
165 /*
166  * Remove request from a queue list
167  */
168 static void
169 __rpc_list_dequeue_task(struct rpc_task *task)
170 {
171         struct list_head *q;
172         struct rpc_task *t;
173
174         if (task->u.tk_wait.list.prev == NULL) {
175                 list_del(&task->u.tk_wait.links);
176                 return;
177         }
178         if (!list_empty(&task->u.tk_wait.links)) {
179                 t = list_first_entry(&task->u.tk_wait.links,
180                                 struct rpc_task,
181                                 u.tk_wait.links);
182                 /* Assume __rpc_list_enqueue_task() cached the queue head */
183                 q = t->u.tk_wait.list.next;
184                 list_add_tail(&t->u.tk_wait.list, q);
185                 list_del(&task->u.tk_wait.links);
186         }
187         list_del(&task->u.tk_wait.list);
188 }
189
190 /*
191  * Add new request to a priority queue.
192  */
193 static void __rpc_add_wait_queue_priority(struct rpc_wait_queue *queue,
194                 struct rpc_task *task,
195                 unsigned char queue_priority)
196 {
197         if (unlikely(queue_priority > queue->maxpriority))
198                 queue_priority = queue->maxpriority;
199         __rpc_list_enqueue_task(&queue->tasks[queue_priority], task);
200 }
201
202 /*
203  * Add new request to wait queue.
204  */
205 static void __rpc_add_wait_queue(struct rpc_wait_queue *queue,
206                 struct rpc_task *task,
207                 unsigned char queue_priority)
208 {
209         INIT_LIST_HEAD(&task->u.tk_wait.timer_list);
210         if (RPC_IS_PRIORITY(queue))
211                 __rpc_add_wait_queue_priority(queue, task, queue_priority);
212         else
213                 list_add_tail(&task->u.tk_wait.list, &queue->tasks[0]);
214         task->tk_waitqueue = queue;
215         queue->qlen++;
216         /* barrier matches the read in rpc_wake_up_task_queue_locked() */
217         smp_wmb();
218         rpc_set_queued(task);
219 }
220
221 /*
222  * Remove request from a priority queue.
223  */
224 static void __rpc_remove_wait_queue_priority(struct rpc_task *task)
225 {
226         __rpc_list_dequeue_task(task);
227 }
228
229 /*
230  * Remove request from queue.
231  * Note: must be called with spin lock held.
232  */
233 static void __rpc_remove_wait_queue(struct rpc_wait_queue *queue, struct rpc_task *task)
234 {
235         __rpc_disable_timer(queue, task);
236         if (RPC_IS_PRIORITY(queue))
237                 __rpc_remove_wait_queue_priority(task);
238         else
239                 list_del(&task->u.tk_wait.list);
240         queue->qlen--;
241 }
242
243 static void __rpc_init_priority_wait_queue(struct rpc_wait_queue *queue, const char *qname, unsigned char nr_queues)
244 {
245         int i;
246
247         spin_lock_init(&queue->lock);
248         for (i = 0; i < ARRAY_SIZE(queue->tasks); i++)
249                 INIT_LIST_HEAD(&queue->tasks[i]);
250         queue->maxpriority = nr_queues - 1;
251         rpc_reset_waitqueue_priority(queue);
252         queue->qlen = 0;
253         queue->timer_list.expires = 0;
254         INIT_DELAYED_WORK(&queue->timer_list.dwork, __rpc_queue_timer_fn);
255         INIT_LIST_HEAD(&queue->timer_list.list);
256         rpc_assign_waitqueue_name(queue, qname);
257 }
258
259 void rpc_init_priority_wait_queue(struct rpc_wait_queue *queue, const char *qname)
260 {
261         __rpc_init_priority_wait_queue(queue, qname, RPC_NR_PRIORITY);
262 }
263 EXPORT_SYMBOL_GPL(rpc_init_priority_wait_queue);
264
265 void rpc_init_wait_queue(struct rpc_wait_queue *queue, const char *qname)
266 {
267         __rpc_init_priority_wait_queue(queue, qname, 1);
268 }
269 EXPORT_SYMBOL_GPL(rpc_init_wait_queue);
270
271 void rpc_destroy_wait_queue(struct rpc_wait_queue *queue)
272 {
273         cancel_delayed_work_sync(&queue->timer_list.dwork);
274 }
275 EXPORT_SYMBOL_GPL(rpc_destroy_wait_queue);
276
277 static int rpc_wait_bit_killable(struct wait_bit_key *key, int mode)
278 {
279         schedule();
280         if (signal_pending_state(mode, current))
281                 return -ERESTARTSYS;
282         return 0;
283 }
284
285 #if IS_ENABLED(CONFIG_SUNRPC_DEBUG) || IS_ENABLED(CONFIG_TRACEPOINTS)
286 static void rpc_task_set_debuginfo(struct rpc_task *task)
287 {
288         struct rpc_clnt *clnt = task->tk_client;
289
290         /* Might be a task carrying a reverse-direction operation */
291         if (!clnt) {
292                 static atomic_t rpc_pid;
293
294                 task->tk_pid = atomic_inc_return(&rpc_pid);
295                 return;
296         }
297
298         task->tk_pid = atomic_inc_return(&clnt->cl_pid);
299 }
300 #else
301 static inline void rpc_task_set_debuginfo(struct rpc_task *task)
302 {
303 }
304 #endif
305
306 static void rpc_set_active(struct rpc_task *task)
307 {
308         rpc_task_set_debuginfo(task);
309         set_bit(RPC_TASK_ACTIVE, &task->tk_runstate);
310         trace_rpc_task_begin(task, NULL);
311 }
312
313 /*
314  * Mark an RPC call as having completed by clearing the 'active' bit
315  * and then waking up all tasks that were sleeping.
316  */
317 static int rpc_complete_task(struct rpc_task *task)
318 {
319         void *m = &task->tk_runstate;
320         wait_queue_head_t *wq = bit_waitqueue(m, RPC_TASK_ACTIVE);
321         struct wait_bit_key k = __WAIT_BIT_KEY_INITIALIZER(m, RPC_TASK_ACTIVE);
322         unsigned long flags;
323         int ret;
324
325         trace_rpc_task_complete(task, NULL);
326
327         spin_lock_irqsave(&wq->lock, flags);
328         clear_bit(RPC_TASK_ACTIVE, &task->tk_runstate);
329         ret = atomic_dec_and_test(&task->tk_count);
330         if (waitqueue_active(wq))
331                 __wake_up_locked_key(wq, TASK_NORMAL, &k);
332         spin_unlock_irqrestore(&wq->lock, flags);
333         return ret;
334 }
335
336 /*
337  * Allow callers to wait for completion of an RPC call
338  *
339  * Note the use of out_of_line_wait_on_bit() rather than wait_on_bit()
340  * to enforce taking of the wq->lock and hence avoid races with
341  * rpc_complete_task().
342  */
343 int rpc_wait_for_completion_task(struct rpc_task *task)
344 {
345         return out_of_line_wait_on_bit(&task->tk_runstate, RPC_TASK_ACTIVE,
346                         rpc_wait_bit_killable, TASK_KILLABLE|TASK_FREEZABLE_UNSAFE);
347 }
348 EXPORT_SYMBOL_GPL(rpc_wait_for_completion_task);
349
350 /*
351  * Make an RPC task runnable.
352  *
353  * Note: If the task is ASYNC, and is being made runnable after sitting on an
354  * rpc_wait_queue, this must be called with the queue spinlock held to protect
355  * the wait queue operation.
356  * Note the ordering of rpc_test_and_set_running() and rpc_clear_queued(),
357  * which is needed to ensure that __rpc_execute() doesn't loop (due to the
358  * lockless RPC_IS_QUEUED() test) before we've had a chance to test
359  * the RPC_TASK_RUNNING flag.
360  */
361 static void rpc_make_runnable(struct workqueue_struct *wq,
362                 struct rpc_task *task)
363 {
364         bool need_wakeup = !rpc_test_and_set_running(task);
365
366         rpc_clear_queued(task);
367         if (!need_wakeup)
368                 return;
369         if (RPC_IS_ASYNC(task)) {
370                 INIT_WORK(&task->u.tk_work, rpc_async_schedule);
371                 queue_work(wq, &task->u.tk_work);
372         } else
373                 wake_up_bit(&task->tk_runstate, RPC_TASK_QUEUED);
374 }
375
376 /*
377  * Prepare for sleeping on a wait queue.
378  * By always appending tasks to the list we ensure FIFO behavior.
379  * NB: An RPC task will only receive interrupt-driven events as long
380  * as it's on a wait queue.
381  */
382 static void __rpc_do_sleep_on_priority(struct rpc_wait_queue *q,
383                 struct rpc_task *task,
384                 unsigned char queue_priority)
385 {
386         trace_rpc_task_sleep(task, q);
387
388         __rpc_add_wait_queue(q, task, queue_priority);
389 }
390
391 static void __rpc_sleep_on_priority(struct rpc_wait_queue *q,
392                 struct rpc_task *task,
393                 unsigned char queue_priority)
394 {
395         if (WARN_ON_ONCE(RPC_IS_QUEUED(task)))
396                 return;
397         __rpc_do_sleep_on_priority(q, task, queue_priority);
398 }
399
400 static void __rpc_sleep_on_priority_timeout(struct rpc_wait_queue *q,
401                 struct rpc_task *task, unsigned long timeout,
402                 unsigned char queue_priority)
403 {
404         if (WARN_ON_ONCE(RPC_IS_QUEUED(task)))
405                 return;
406         if (time_is_after_jiffies(timeout)) {
407                 __rpc_do_sleep_on_priority(q, task, queue_priority);
408                 __rpc_add_timer(q, task, timeout);
409         } else
410                 task->tk_status = -ETIMEDOUT;
411 }
412
413 static void rpc_set_tk_callback(struct rpc_task *task, rpc_action action)
414 {
415         if (action && !WARN_ON_ONCE(task->tk_callback != NULL))
416                 task->tk_callback = action;
417 }
418
419 static bool rpc_sleep_check_activated(struct rpc_task *task)
420 {
421         /* We shouldn't ever put an inactive task to sleep */
422         if (WARN_ON_ONCE(!RPC_IS_ACTIVATED(task))) {
423                 task->tk_status = -EIO;
424                 rpc_put_task_async(task);
425                 return false;
426         }
427         return true;
428 }
429
430 void rpc_sleep_on_timeout(struct rpc_wait_queue *q, struct rpc_task *task,
431                                 rpc_action action, unsigned long timeout)
432 {
433         if (!rpc_sleep_check_activated(task))
434                 return;
435
436         rpc_set_tk_callback(task, action);
437
438         /*
439          * Protect the queue operations.
440          */
441         spin_lock(&q->lock);
442         __rpc_sleep_on_priority_timeout(q, task, timeout, task->tk_priority);
443         spin_unlock(&q->lock);
444 }
445 EXPORT_SYMBOL_GPL(rpc_sleep_on_timeout);
446
447 void rpc_sleep_on(struct rpc_wait_queue *q, struct rpc_task *task,
448                                 rpc_action action)
449 {
450         if (!rpc_sleep_check_activated(task))
451                 return;
452
453         rpc_set_tk_callback(task, action);
454
455         WARN_ON_ONCE(task->tk_timeout != 0);
456         /*
457          * Protect the queue operations.
458          */
459         spin_lock(&q->lock);
460         __rpc_sleep_on_priority(q, task, task->tk_priority);
461         spin_unlock(&q->lock);
462 }
463 EXPORT_SYMBOL_GPL(rpc_sleep_on);
464
465 void rpc_sleep_on_priority_timeout(struct rpc_wait_queue *q,
466                 struct rpc_task *task, unsigned long timeout, int priority)
467 {
468         if (!rpc_sleep_check_activated(task))
469                 return;
470
471         priority -= RPC_PRIORITY_LOW;
472         /*
473          * Protect the queue operations.
474          */
475         spin_lock(&q->lock);
476         __rpc_sleep_on_priority_timeout(q, task, timeout, priority);
477         spin_unlock(&q->lock);
478 }
479 EXPORT_SYMBOL_GPL(rpc_sleep_on_priority_timeout);
480
481 void rpc_sleep_on_priority(struct rpc_wait_queue *q, struct rpc_task *task,
482                 int priority)
483 {
484         if (!rpc_sleep_check_activated(task))
485                 return;
486
487         WARN_ON_ONCE(task->tk_timeout != 0);
488         priority -= RPC_PRIORITY_LOW;
489         /*
490          * Protect the queue operations.
491          */
492         spin_lock(&q->lock);
493         __rpc_sleep_on_priority(q, task, priority);
494         spin_unlock(&q->lock);
495 }
496 EXPORT_SYMBOL_GPL(rpc_sleep_on_priority);
497
498 /**
499  * __rpc_do_wake_up_task_on_wq - wake up a single rpc_task
500  * @wq: workqueue on which to run task
501  * @queue: wait queue
502  * @task: task to be woken up
503  *
504  * Caller must hold queue->lock, and have cleared the task queued flag.
505  */
506 static void __rpc_do_wake_up_task_on_wq(struct workqueue_struct *wq,
507                 struct rpc_wait_queue *queue,
508                 struct rpc_task *task)
509 {
510         /* Has the task been executed yet? If not, we cannot wake it up! */
511         if (!RPC_IS_ACTIVATED(task)) {
512                 printk(KERN_ERR "RPC: Inactive task (%p) being woken up!\n", task);
513                 return;
514         }
515
516         trace_rpc_task_wakeup(task, queue);
517
518         __rpc_remove_wait_queue(queue, task);
519
520         rpc_make_runnable(wq, task);
521 }
522
523 /*
524  * Wake up a queued task while the queue lock is being held
525  */
526 static struct rpc_task *
527 rpc_wake_up_task_on_wq_queue_action_locked(struct workqueue_struct *wq,
528                 struct rpc_wait_queue *queue, struct rpc_task *task,
529                 bool (*action)(struct rpc_task *, void *), void *data)
530 {
531         if (RPC_IS_QUEUED(task)) {
532                 smp_rmb();
533                 if (task->tk_waitqueue == queue) {
534                         if (action == NULL || action(task, data)) {
535                                 __rpc_do_wake_up_task_on_wq(wq, queue, task);
536                                 return task;
537                         }
538                 }
539         }
540         return NULL;
541 }
542
543 /*
544  * Wake up a queued task while the queue lock is being held
545  */
546 static void rpc_wake_up_task_queue_locked(struct rpc_wait_queue *queue,
547                                           struct rpc_task *task)
548 {
549         rpc_wake_up_task_on_wq_queue_action_locked(rpciod_workqueue, queue,
550                                                    task, NULL, NULL);
551 }
552
553 /*
554  * Wake up a task on a specific queue
555  */
556 void rpc_wake_up_queued_task(struct rpc_wait_queue *queue, struct rpc_task *task)
557 {
558         if (!RPC_IS_QUEUED(task))
559                 return;
560         spin_lock(&queue->lock);
561         rpc_wake_up_task_queue_locked(queue, task);
562         spin_unlock(&queue->lock);
563 }
564 EXPORT_SYMBOL_GPL(rpc_wake_up_queued_task);
565
566 static bool rpc_task_action_set_status(struct rpc_task *task, void *status)
567 {
568         task->tk_status = *(int *)status;
569         return true;
570 }
571
572 static void
573 rpc_wake_up_task_queue_set_status_locked(struct rpc_wait_queue *queue,
574                 struct rpc_task *task, int status)
575 {
576         rpc_wake_up_task_on_wq_queue_action_locked(rpciod_workqueue, queue,
577                         task, rpc_task_action_set_status, &status);
578 }
579
580 /**
581  * rpc_wake_up_queued_task_set_status - wake up a task and set task->tk_status
582  * @queue: pointer to rpc_wait_queue
583  * @task: pointer to rpc_task
584  * @status: integer error value
585  *
586  * If @task is queued on @queue, then it is woken up, and @task->tk_status is
587  * set to the value of @status.
588  */
589 void
590 rpc_wake_up_queued_task_set_status(struct rpc_wait_queue *queue,
591                 struct rpc_task *task, int status)
592 {
593         if (!RPC_IS_QUEUED(task))
594                 return;
595         spin_lock(&queue->lock);
596         rpc_wake_up_task_queue_set_status_locked(queue, task, status);
597         spin_unlock(&queue->lock);
598 }
599
600 /*
601  * Wake up the next task on a priority queue.
602  */
603 static struct rpc_task *__rpc_find_next_queued_priority(struct rpc_wait_queue *queue)
604 {
605         struct list_head *q;
606         struct rpc_task *task;
607
608         /*
609          * Service the privileged queue.
610          */
611         q = &queue->tasks[RPC_NR_PRIORITY - 1];
612         if (queue->maxpriority > RPC_PRIORITY_PRIVILEGED && !list_empty(q)) {
613                 task = list_first_entry(q, struct rpc_task, u.tk_wait.list);
614                 goto out;
615         }
616
617         /*
618          * Service a batch of tasks from a single owner.
619          */
620         q = &queue->tasks[queue->priority];
621         if (!list_empty(q) && queue->nr) {
622                 queue->nr--;
623                 task = list_first_entry(q, struct rpc_task, u.tk_wait.list);
624                 goto out;
625         }
626
627         /*
628          * Service the next queue.
629          */
630         do {
631                 if (q == &queue->tasks[0])
632                         q = &queue->tasks[queue->maxpriority];
633                 else
634                         q = q - 1;
635                 if (!list_empty(q)) {
636                         task = list_first_entry(q, struct rpc_task, u.tk_wait.list);
637                         goto new_queue;
638                 }
639         } while (q != &queue->tasks[queue->priority]);
640
641         rpc_reset_waitqueue_priority(queue);
642         return NULL;
643
644 new_queue:
645         rpc_set_waitqueue_priority(queue, (unsigned int)(q - &queue->tasks[0]));
646 out:
647         return task;
648 }
649
650 static struct rpc_task *__rpc_find_next_queued(struct rpc_wait_queue *queue)
651 {
652         if (RPC_IS_PRIORITY(queue))
653                 return __rpc_find_next_queued_priority(queue);
654         if (!list_empty(&queue->tasks[0]))
655                 return list_first_entry(&queue->tasks[0], struct rpc_task, u.tk_wait.list);
656         return NULL;
657 }
658
659 /*
660  * Wake up the first task on the wait queue.
661  */
662 struct rpc_task *rpc_wake_up_first_on_wq(struct workqueue_struct *wq,
663                 struct rpc_wait_queue *queue,
664                 bool (*func)(struct rpc_task *, void *), void *data)
665 {
666         struct rpc_task *task = NULL;
667
668         spin_lock(&queue->lock);
669         task = __rpc_find_next_queued(queue);
670         if (task != NULL)
671                 task = rpc_wake_up_task_on_wq_queue_action_locked(wq, queue,
672                                 task, func, data);
673         spin_unlock(&queue->lock);
674
675         return task;
676 }
677
678 /*
679  * Wake up the first task on the wait queue.
680  */
681 struct rpc_task *rpc_wake_up_first(struct rpc_wait_queue *queue,
682                 bool (*func)(struct rpc_task *, void *), void *data)
683 {
684         return rpc_wake_up_first_on_wq(rpciod_workqueue, queue, func, data);
685 }
686 EXPORT_SYMBOL_GPL(rpc_wake_up_first);
687
688 static bool rpc_wake_up_next_func(struct rpc_task *task, void *data)
689 {
690         return true;
691 }
692
693 /*
694  * Wake up the next task on the wait queue.
695 */
696 struct rpc_task *rpc_wake_up_next(struct rpc_wait_queue *queue)
697 {
698         return rpc_wake_up_first(queue, rpc_wake_up_next_func, NULL);
699 }
700 EXPORT_SYMBOL_GPL(rpc_wake_up_next);
701
702 /**
703  * rpc_wake_up_locked - wake up all rpc_tasks
704  * @queue: rpc_wait_queue on which the tasks are sleeping
705  *
706  */
707 static void rpc_wake_up_locked(struct rpc_wait_queue *queue)
708 {
709         struct rpc_task *task;
710
711         for (;;) {
712                 task = __rpc_find_next_queued(queue);
713                 if (task == NULL)
714                         break;
715                 rpc_wake_up_task_queue_locked(queue, task);
716         }
717 }
718
719 /**
720  * rpc_wake_up - wake up all rpc_tasks
721  * @queue: rpc_wait_queue on which the tasks are sleeping
722  *
723  * Grabs queue->lock
724  */
725 void rpc_wake_up(struct rpc_wait_queue *queue)
726 {
727         spin_lock(&queue->lock);
728         rpc_wake_up_locked(queue);
729         spin_unlock(&queue->lock);
730 }
731 EXPORT_SYMBOL_GPL(rpc_wake_up);
732
733 /**
734  * rpc_wake_up_status_locked - wake up all rpc_tasks and set their status value.
735  * @queue: rpc_wait_queue on which the tasks are sleeping
736  * @status: status value to set
737  */
738 static void rpc_wake_up_status_locked(struct rpc_wait_queue *queue, int status)
739 {
740         struct rpc_task *task;
741
742         for (;;) {
743                 task = __rpc_find_next_queued(queue);
744                 if (task == NULL)
745                         break;
746                 rpc_wake_up_task_queue_set_status_locked(queue, task, status);
747         }
748 }
749
750 /**
751  * rpc_wake_up_status - wake up all rpc_tasks and set their status value.
752  * @queue: rpc_wait_queue on which the tasks are sleeping
753  * @status: status value to set
754  *
755  * Grabs queue->lock
756  */
757 void rpc_wake_up_status(struct rpc_wait_queue *queue, int status)
758 {
759         spin_lock(&queue->lock);
760         rpc_wake_up_status_locked(queue, status);
761         spin_unlock(&queue->lock);
762 }
763 EXPORT_SYMBOL_GPL(rpc_wake_up_status);
764
765 static void __rpc_queue_timer_fn(struct work_struct *work)
766 {
767         struct rpc_wait_queue *queue = container_of(work,
768                         struct rpc_wait_queue,
769                         timer_list.dwork.work);
770         struct rpc_task *task, *n;
771         unsigned long expires, now, timeo;
772
773         spin_lock(&queue->lock);
774         expires = now = jiffies;
775         list_for_each_entry_safe(task, n, &queue->timer_list.list, u.tk_wait.timer_list) {
776                 timeo = task->tk_timeout;
777                 if (time_after_eq(now, timeo)) {
778                         trace_rpc_task_timeout(task, task->tk_action);
779                         task->tk_status = -ETIMEDOUT;
780                         rpc_wake_up_task_queue_locked(queue, task);
781                         continue;
782                 }
783                 if (expires == now || time_after(expires, timeo))
784                         expires = timeo;
785         }
786         if (!list_empty(&queue->timer_list.list))
787                 rpc_set_queue_timer(queue, expires);
788         spin_unlock(&queue->lock);
789 }
790
791 static void __rpc_atrun(struct rpc_task *task)
792 {
793         if (task->tk_status == -ETIMEDOUT)
794                 task->tk_status = 0;
795 }
796
797 /*
798  * Run a task at a later time
799  */
800 void rpc_delay(struct rpc_task *task, unsigned long delay)
801 {
802         rpc_sleep_on_timeout(&delay_queue, task, __rpc_atrun, jiffies + delay);
803 }
804 EXPORT_SYMBOL_GPL(rpc_delay);
805
806 /*
807  * Helper to call task->tk_ops->rpc_call_prepare
808  */
809 void rpc_prepare_task(struct rpc_task *task)
810 {
811         task->tk_ops->rpc_call_prepare(task, task->tk_calldata);
812 }
813
814 static void
815 rpc_init_task_statistics(struct rpc_task *task)
816 {
817         /* Initialize retry counters */
818         task->tk_garb_retry = 2;
819         task->tk_cred_retry = 2;
820         task->tk_rebind_retry = 2;
821
822         /* starting timestamp */
823         task->tk_start = ktime_get();
824 }
825
826 static void
827 rpc_reset_task_statistics(struct rpc_task *task)
828 {
829         task->tk_timeouts = 0;
830         task->tk_flags &= ~(RPC_CALL_MAJORSEEN|RPC_TASK_SENT);
831         rpc_init_task_statistics(task);
832 }
833
834 /*
835  * Helper that calls task->tk_ops->rpc_call_done if it exists
836  */
837 void rpc_exit_task(struct rpc_task *task)
838 {
839         trace_rpc_task_end(task, task->tk_action);
840         task->tk_action = NULL;
841         if (task->tk_ops->rpc_count_stats)
842                 task->tk_ops->rpc_count_stats(task, task->tk_calldata);
843         else if (task->tk_client)
844                 rpc_count_iostats(task, task->tk_client->cl_metrics);
845         if (task->tk_ops->rpc_call_done != NULL) {
846                 trace_rpc_task_call_done(task, task->tk_ops->rpc_call_done);
847                 task->tk_ops->rpc_call_done(task, task->tk_calldata);
848                 if (task->tk_action != NULL) {
849                         /* Always release the RPC slot and buffer memory */
850                         xprt_release(task);
851                         rpc_reset_task_statistics(task);
852                 }
853         }
854 }
855
856 void rpc_signal_task(struct rpc_task *task)
857 {
858         struct rpc_wait_queue *queue;
859
860         if (!RPC_IS_ACTIVATED(task))
861                 return;
862
863         if (!rpc_task_set_rpc_status(task, -ERESTARTSYS))
864                 return;
865         trace_rpc_task_signalled(task, task->tk_action);
866         set_bit(RPC_TASK_SIGNALLED, &task->tk_runstate);
867         smp_mb__after_atomic();
868         queue = READ_ONCE(task->tk_waitqueue);
869         if (queue)
870                 rpc_wake_up_queued_task(queue, task);
871 }
872
873 void rpc_task_try_cancel(struct rpc_task *task, int error)
874 {
875         struct rpc_wait_queue *queue;
876
877         if (!rpc_task_set_rpc_status(task, error))
878                 return;
879         queue = READ_ONCE(task->tk_waitqueue);
880         if (queue)
881                 rpc_wake_up_queued_task(queue, task);
882 }
883
884 void rpc_exit(struct rpc_task *task, int status)
885 {
886         task->tk_status = status;
887         task->tk_action = rpc_exit_task;
888         rpc_wake_up_queued_task(task->tk_waitqueue, task);
889 }
890 EXPORT_SYMBOL_GPL(rpc_exit);
891
892 void rpc_release_calldata(const struct rpc_call_ops *ops, void *calldata)
893 {
894         if (ops->rpc_release != NULL)
895                 ops->rpc_release(calldata);
896 }
897
898 static bool xprt_needs_memalloc(struct rpc_xprt *xprt, struct rpc_task *tk)
899 {
900         if (!xprt)
901                 return false;
902         if (!atomic_read(&xprt->swapper))
903                 return false;
904         return test_bit(XPRT_LOCKED, &xprt->state) && xprt->snd_task == tk;
905 }
906
907 /*
908  * This is the RPC `scheduler' (or rather, the finite state machine).
909  */
910 static void __rpc_execute(struct rpc_task *task)
911 {
912         struct rpc_wait_queue *queue;
913         int task_is_async = RPC_IS_ASYNC(task);
914         int status = 0;
915         unsigned long pflags = current->flags;
916
917         WARN_ON_ONCE(RPC_IS_QUEUED(task));
918         if (RPC_IS_QUEUED(task))
919                 return;
920
921         for (;;) {
922                 void (*do_action)(struct rpc_task *);
923
924                 /*
925                  * Perform the next FSM step or a pending callback.
926                  *
927                  * tk_action may be NULL if the task has been killed.
928                  */
929                 do_action = task->tk_action;
930                 /* Tasks with an RPC error status should exit */
931                 if (do_action != rpc_exit_task &&
932                     (status = READ_ONCE(task->tk_rpc_status)) != 0) {
933                         task->tk_status = status;
934                         if (do_action != NULL)
935                                 do_action = rpc_exit_task;
936                 }
937                 /* Callbacks override all actions */
938                 if (task->tk_callback) {
939                         do_action = task->tk_callback;
940                         task->tk_callback = NULL;
941                 }
942                 if (!do_action)
943                         break;
944                 if (RPC_IS_SWAPPER(task) ||
945                     xprt_needs_memalloc(task->tk_xprt, task))
946                         current->flags |= PF_MEMALLOC;
947
948                 trace_rpc_task_run_action(task, do_action);
949                 do_action(task);
950
951                 /*
952                  * Lockless check for whether task is sleeping or not.
953                  */
954                 if (!RPC_IS_QUEUED(task)) {
955                         cond_resched();
956                         continue;
957                 }
958
959                 /*
960                  * The queue->lock protects against races with
961                  * rpc_make_runnable().
962                  *
963                  * Note that once we clear RPC_TASK_RUNNING on an asynchronous
964                  * rpc_task, rpc_make_runnable() can assign it to a
965                  * different workqueue. We therefore cannot assume that the
966                  * rpc_task pointer may still be dereferenced.
967                  */
968                 queue = task->tk_waitqueue;
969                 spin_lock(&queue->lock);
970                 if (!RPC_IS_QUEUED(task)) {
971                         spin_unlock(&queue->lock);
972                         continue;
973                 }
974                 /* Wake up any task that has an exit status */
975                 if (READ_ONCE(task->tk_rpc_status) != 0) {
976                         rpc_wake_up_task_queue_locked(queue, task);
977                         spin_unlock(&queue->lock);
978                         continue;
979                 }
980                 rpc_clear_running(task);
981                 spin_unlock(&queue->lock);
982                 if (task_is_async)
983                         goto out;
984
985                 /* sync task: sleep here */
986                 trace_rpc_task_sync_sleep(task, task->tk_action);
987                 status = out_of_line_wait_on_bit(&task->tk_runstate,
988                                 RPC_TASK_QUEUED, rpc_wait_bit_killable,
989                                 TASK_KILLABLE|TASK_FREEZABLE);
990                 if (status < 0) {
991                         /*
992                          * When a sync task receives a signal, it exits with
993                          * -ERESTARTSYS. In order to catch any callbacks that
994                          * clean up after sleeping on some queue, we don't
995                          * break the loop here, but go around once more.
996                          */
997                         rpc_signal_task(task);
998                 }
999                 trace_rpc_task_sync_wake(task, task->tk_action);
1000         }
1001
1002         /* Release all resources associated with the task */
1003         rpc_release_task(task);
1004 out:
1005         current_restore_flags(pflags, PF_MEMALLOC);
1006 }
1007
1008 /*
1009  * User-visible entry point to the scheduler.
1010  *
1011  * This may be called recursively if e.g. an async NFS task updates
1012  * the attributes and finds that dirty pages must be flushed.
1013  * NOTE: Upon exit of this function the task is guaranteed to be
1014  *       released. In particular note that tk_release() will have
1015  *       been called, so your task memory may have been freed.
1016  */
1017 void rpc_execute(struct rpc_task *task)
1018 {
1019         bool is_async = RPC_IS_ASYNC(task);
1020
1021         rpc_set_active(task);
1022         rpc_make_runnable(rpciod_workqueue, task);
1023         if (!is_async) {
1024                 unsigned int pflags = memalloc_nofs_save();
1025                 __rpc_execute(task);
1026                 memalloc_nofs_restore(pflags);
1027         }
1028 }
1029
1030 static void rpc_async_schedule(struct work_struct *work)
1031 {
1032         unsigned int pflags = memalloc_nofs_save();
1033
1034         __rpc_execute(container_of(work, struct rpc_task, u.tk_work));
1035         memalloc_nofs_restore(pflags);
1036 }
1037
1038 /**
1039  * rpc_malloc - allocate RPC buffer resources
1040  * @task: RPC task
1041  *
1042  * A single memory region is allocated, which is split between the
1043  * RPC call and RPC reply that this task is being used for. When
1044  * this RPC is retired, the memory is released by calling rpc_free.
1045  *
1046  * To prevent rpciod from hanging, this allocator never sleeps,
1047  * returning -ENOMEM and suppressing warning if the request cannot
1048  * be serviced immediately. The caller can arrange to sleep in a
1049  * way that is safe for rpciod.
1050  *
1051  * Most requests are 'small' (under 2KiB) and can be serviced from a
1052  * mempool, ensuring that NFS reads and writes can always proceed,
1053  * and that there is good locality of reference for these buffers.
1054  */
1055 int rpc_malloc(struct rpc_task *task)
1056 {
1057         struct rpc_rqst *rqst = task->tk_rqstp;
1058         size_t size = rqst->rq_callsize + rqst->rq_rcvsize;
1059         struct rpc_buffer *buf;
1060         gfp_t gfp = rpc_task_gfp_mask();
1061
1062         size += sizeof(struct rpc_buffer);
1063         if (size <= RPC_BUFFER_MAXSIZE) {
1064                 buf = kmem_cache_alloc(rpc_buffer_slabp, gfp);
1065                 /* Reach for the mempool if dynamic allocation fails */
1066                 if (!buf && RPC_IS_ASYNC(task))
1067                         buf = mempool_alloc(rpc_buffer_mempool, GFP_NOWAIT);
1068         } else
1069                 buf = kmalloc(size, gfp);
1070
1071         if (!buf)
1072                 return -ENOMEM;
1073
1074         buf->len = size;
1075         rqst->rq_buffer = buf->data;
1076         rqst->rq_rbuffer = (char *)rqst->rq_buffer + rqst->rq_callsize;
1077         return 0;
1078 }
1079 EXPORT_SYMBOL_GPL(rpc_malloc);
1080
1081 /**
1082  * rpc_free - free RPC buffer resources allocated via rpc_malloc
1083  * @task: RPC task
1084  *
1085  */
1086 void rpc_free(struct rpc_task *task)
1087 {
1088         void *buffer = task->tk_rqstp->rq_buffer;
1089         size_t size;
1090         struct rpc_buffer *buf;
1091
1092         buf = container_of(buffer, struct rpc_buffer, data);
1093         size = buf->len;
1094
1095         if (size <= RPC_BUFFER_MAXSIZE)
1096                 mempool_free(buf, rpc_buffer_mempool);
1097         else
1098                 kfree(buf);
1099 }
1100 EXPORT_SYMBOL_GPL(rpc_free);
1101
1102 /*
1103  * Creation and deletion of RPC task structures
1104  */
1105 static void rpc_init_task(struct rpc_task *task, const struct rpc_task_setup *task_setup_data)
1106 {
1107         memset(task, 0, sizeof(*task));
1108         atomic_set(&task->tk_count, 1);
1109         task->tk_flags  = task_setup_data->flags;
1110         task->tk_ops = task_setup_data->callback_ops;
1111         task->tk_calldata = task_setup_data->callback_data;
1112         INIT_LIST_HEAD(&task->tk_task);
1113
1114         task->tk_priority = task_setup_data->priority - RPC_PRIORITY_LOW;
1115         task->tk_owner = current->tgid;
1116
1117         /* Initialize workqueue for async tasks */
1118         task->tk_workqueue = task_setup_data->workqueue;
1119
1120         task->tk_xprt = rpc_task_get_xprt(task_setup_data->rpc_client,
1121                         xprt_get(task_setup_data->rpc_xprt));
1122
1123         task->tk_op_cred = get_rpccred(task_setup_data->rpc_op_cred);
1124
1125         if (task->tk_ops->rpc_call_prepare != NULL)
1126                 task->tk_action = rpc_prepare_task;
1127
1128         rpc_init_task_statistics(task);
1129 }
1130
1131 static struct rpc_task *rpc_alloc_task(void)
1132 {
1133         struct rpc_task *task;
1134
1135         task = kmem_cache_alloc(rpc_task_slabp, rpc_task_gfp_mask());
1136         if (task)
1137                 return task;
1138         return mempool_alloc(rpc_task_mempool, GFP_NOWAIT);
1139 }
1140
1141 /*
1142  * Create a new task for the specified client.
1143  */
1144 struct rpc_task *rpc_new_task(const struct rpc_task_setup *setup_data)
1145 {
1146         struct rpc_task *task = setup_data->task;
1147         unsigned short flags = 0;
1148
1149         if (task == NULL) {
1150                 task = rpc_alloc_task();
1151                 if (task == NULL) {
1152                         rpc_release_calldata(setup_data->callback_ops,
1153                                              setup_data->callback_data);
1154                         return ERR_PTR(-ENOMEM);
1155                 }
1156                 flags = RPC_TASK_DYNAMIC;
1157         }
1158
1159         rpc_init_task(task, setup_data);
1160         task->tk_flags |= flags;
1161         return task;
1162 }
1163
1164 /*
1165  * rpc_free_task - release rpc task and perform cleanups
1166  *
1167  * Note that we free up the rpc_task _after_ rpc_release_calldata()
1168  * in order to work around a workqueue dependency issue.
1169  *
1170  * Tejun Heo states:
1171  * "Workqueue currently considers two work items to be the same if they're
1172  * on the same address and won't execute them concurrently - ie. it
1173  * makes a work item which is queued again while being executed wait
1174  * for the previous execution to complete.
1175  *
1176  * If a work function frees the work item, and then waits for an event
1177  * which should be performed by another work item and *that* work item
1178  * recycles the freed work item, it can create a false dependency loop.
1179  * There really is no reliable way to detect this short of verifying
1180  * every memory free."
1181  *
1182  */
1183 static void rpc_free_task(struct rpc_task *task)
1184 {
1185         unsigned short tk_flags = task->tk_flags;
1186
1187         put_rpccred(task->tk_op_cred);
1188         rpc_release_calldata(task->tk_ops, task->tk_calldata);
1189
1190         if (tk_flags & RPC_TASK_DYNAMIC)
1191                 mempool_free(task, rpc_task_mempool);
1192 }
1193
1194 static void rpc_async_release(struct work_struct *work)
1195 {
1196         unsigned int pflags = memalloc_nofs_save();
1197
1198         rpc_free_task(container_of(work, struct rpc_task, u.tk_work));
1199         memalloc_nofs_restore(pflags);
1200 }
1201
1202 static void rpc_release_resources_task(struct rpc_task *task)
1203 {
1204         xprt_release(task);
1205         if (task->tk_msg.rpc_cred) {
1206                 if (!(task->tk_flags & RPC_TASK_CRED_NOREF))
1207                         put_cred(task->tk_msg.rpc_cred);
1208                 task->tk_msg.rpc_cred = NULL;
1209         }
1210         rpc_task_release_client(task);
1211 }
1212
1213 static void rpc_final_put_task(struct rpc_task *task,
1214                 struct workqueue_struct *q)
1215 {
1216         if (q != NULL) {
1217                 INIT_WORK(&task->u.tk_work, rpc_async_release);
1218                 queue_work(q, &task->u.tk_work);
1219         } else
1220                 rpc_free_task(task);
1221 }
1222
1223 static void rpc_do_put_task(struct rpc_task *task, struct workqueue_struct *q)
1224 {
1225         if (atomic_dec_and_test(&task->tk_count)) {
1226                 rpc_release_resources_task(task);
1227                 rpc_final_put_task(task, q);
1228         }
1229 }
1230
1231 void rpc_put_task(struct rpc_task *task)
1232 {
1233         rpc_do_put_task(task, NULL);
1234 }
1235 EXPORT_SYMBOL_GPL(rpc_put_task);
1236
1237 void rpc_put_task_async(struct rpc_task *task)
1238 {
1239         rpc_do_put_task(task, task->tk_workqueue);
1240 }
1241 EXPORT_SYMBOL_GPL(rpc_put_task_async);
1242
1243 static void rpc_release_task(struct rpc_task *task)
1244 {
1245         WARN_ON_ONCE(RPC_IS_QUEUED(task));
1246
1247         rpc_release_resources_task(task);
1248
1249         /*
1250          * Note: at this point we have been removed from rpc_clnt->cl_tasks,
1251          * so it should be safe to use task->tk_count as a test for whether
1252          * or not any other processes still hold references to our rpc_task.
1253          */
1254         if (atomic_read(&task->tk_count) != 1 + !RPC_IS_ASYNC(task)) {
1255                 /* Wake up anyone who may be waiting for task completion */
1256                 if (!rpc_complete_task(task))
1257                         return;
1258         } else {
1259                 if (!atomic_dec_and_test(&task->tk_count))
1260                         return;
1261         }
1262         rpc_final_put_task(task, task->tk_workqueue);
1263 }
1264
1265 int rpciod_up(void)
1266 {
1267         return try_module_get(THIS_MODULE) ? 0 : -EINVAL;
1268 }
1269
1270 void rpciod_down(void)
1271 {
1272         module_put(THIS_MODULE);
1273 }
1274
1275 /*
1276  * Start up the rpciod workqueue.
1277  */
1278 static int rpciod_start(void)
1279 {
1280         struct workqueue_struct *wq;
1281
1282         /*
1283          * Create the rpciod thread and wait for it to start.
1284          */
1285         wq = alloc_workqueue("rpciod", WQ_MEM_RECLAIM | WQ_UNBOUND, 0);
1286         if (!wq)
1287                 goto out_failed;
1288         rpciod_workqueue = wq;
1289         wq = alloc_workqueue("xprtiod", WQ_UNBOUND | WQ_MEM_RECLAIM, 0);
1290         if (!wq)
1291                 goto free_rpciod;
1292         xprtiod_workqueue = wq;
1293         return 1;
1294 free_rpciod:
1295         wq = rpciod_workqueue;
1296         rpciod_workqueue = NULL;
1297         destroy_workqueue(wq);
1298 out_failed:
1299         return 0;
1300 }
1301
1302 static void rpciod_stop(void)
1303 {
1304         struct workqueue_struct *wq = NULL;
1305
1306         if (rpciod_workqueue == NULL)
1307                 return;
1308
1309         wq = rpciod_workqueue;
1310         rpciod_workqueue = NULL;
1311         destroy_workqueue(wq);
1312         wq = xprtiod_workqueue;
1313         xprtiod_workqueue = NULL;
1314         destroy_workqueue(wq);
1315 }
1316
1317 void
1318 rpc_destroy_mempool(void)
1319 {
1320         rpciod_stop();
1321         mempool_destroy(rpc_buffer_mempool);
1322         mempool_destroy(rpc_task_mempool);
1323         kmem_cache_destroy(rpc_task_slabp);
1324         kmem_cache_destroy(rpc_buffer_slabp);
1325         rpc_destroy_wait_queue(&delay_queue);
1326 }
1327
1328 int
1329 rpc_init_mempool(void)
1330 {
1331         /*
1332          * The following is not strictly a mempool initialisation,
1333          * but there is no harm in doing it here
1334          */
1335         rpc_init_wait_queue(&delay_queue, "delayq");
1336         if (!rpciod_start())
1337                 goto err_nomem;
1338
1339         rpc_task_slabp = kmem_cache_create("rpc_tasks",
1340                                              sizeof(struct rpc_task),
1341                                              0, SLAB_HWCACHE_ALIGN,
1342                                              NULL);
1343         if (!rpc_task_slabp)
1344                 goto err_nomem;
1345         rpc_buffer_slabp = kmem_cache_create("rpc_buffers",
1346                                              RPC_BUFFER_MAXSIZE,
1347                                              0, SLAB_HWCACHE_ALIGN,
1348                                              NULL);
1349         if (!rpc_buffer_slabp)
1350                 goto err_nomem;
1351         rpc_task_mempool = mempool_create_slab_pool(RPC_TASK_POOLSIZE,
1352                                                     rpc_task_slabp);
1353         if (!rpc_task_mempool)
1354                 goto err_nomem;
1355         rpc_buffer_mempool = mempool_create_slab_pool(RPC_BUFFER_POOLSIZE,
1356                                                       rpc_buffer_slabp);
1357         if (!rpc_buffer_mempool)
1358                 goto err_nomem;
1359         return 0;
1360 err_nomem:
1361         rpc_destroy_mempool();
1362         return -ENOMEM;
1363 }