Whamcloud - gitweb
LU-13199 lustre: remove cl_{offset,index,page_size} helpers
[fs/lustre-release.git] / lustre / llite / vvp_io.c
1 /*
2  * GPL HEADER START
3  *
4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 only,
8  * as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * General Public License version 2 for more details (a copy is included
14  * in the LICENSE file that accompanied this code).
15  *
16  * You should have received a copy of the GNU General Public License
17  * version 2 along with this program; If not, see
18  * http://www.gnu.org/licenses/gpl-2.0.html
19  *
20  * GPL HEADER END
21  */
22 /*
23  * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
24  * Use is subject to license terms.
25  *
26  * Copyright (c) 2011, 2017, Intel Corporation.
27  */
28 /*
29  * This file is part of Lustre, http://www.lustre.org/
30  *
31  * Implementation of cl_io for VVP layer.
32  *
33  *   Author: Nikita Danilov <nikita.danilov@sun.com>
34  *   Author: Jinshan Xiong <jinshan.xiong@whamcloud.com>
35  */
36
37 #define DEBUG_SUBSYSTEM S_LLITE
38
39 #include <obd.h>
40 #include <linux/pagevec.h>
41 #include <linux/memcontrol.h>
42 #include <linux/falloc.h>
43
44 #include "llite_internal.h"
45 #include "vvp_internal.h"
46 #include <libcfs/linux/linux-misc.h>
47
48 static struct vvp_io *cl2vvp_io(const struct lu_env *env,
49                                 const struct cl_io_slice *slice)
50 {
51         struct vvp_io *vio;
52
53         vio = container_of(slice, struct vvp_io, vui_cl);
54         LASSERT(vio == vvp_env_io(env));
55
56         return vio;
57 }
58
59 /**
60  * For swapping layout. The file's layout may have changed.
61  * To avoid populating pages to a wrong stripe, we have to verify the
62  * correctness of layout. It works because swapping layout processes
63  * have to acquire group lock.
64  */
65 static bool can_populate_pages(const struct lu_env *env, struct cl_io *io,
66                                 struct inode *inode)
67 {
68         struct ll_inode_info    *lli = ll_i2info(inode);
69         struct vvp_io           *vio = vvp_env_io(env);
70         bool rc = true;
71
72         switch (io->ci_type) {
73         case CIT_READ:
74         case CIT_WRITE:
75                 /* don't need lock here to check lli_layout_gen as we have held
76                  * extent lock and GROUP lock has to hold to swap layout */
77                 if (ll_layout_version_get(lli) != vio->vui_layout_gen ||
78                     OBD_FAIL_CHECK_RESET(OBD_FAIL_LLITE_LOST_LAYOUT, 0)) {
79                         io->ci_need_restart = 1;
80                         /* this will cause a short read/write */
81                         io->ci_continue = 0;
82                         rc = false;
83                 }
84         case CIT_FAULT:
85                 /* fault is okay because we've already had a page. */
86         default:
87                 break;
88         }
89
90         return rc;
91 }
92
93 static void vvp_object_size_lock(struct cl_object *obj)
94 {
95         struct inode *inode = vvp_object_inode(obj);
96
97         ll_inode_size_lock(inode);
98         cl_object_attr_lock(obj);
99 }
100
101 static void vvp_object_size_unlock(struct cl_object *obj)
102 {
103         struct inode *inode = vvp_object_inode(obj);
104
105         cl_object_attr_unlock(obj);
106         ll_inode_size_unlock(inode);
107 }
108
109 /**
110  * Helper function that if necessary adjusts file size (inode->i_size), when
111  * position at the offset \a pos is accessed. File size can be arbitrary stale
112  * on a Lustre client, but client at least knows KMS. If accessed area is
113  * inside [0, KMS], set file size to KMS, otherwise glimpse file size.
114  *
115  * Locking: i_size_lock is used to serialize changes to inode size and to
116  * protect consistency between inode size and cl_object
117  * attributes. cl_object_size_lock() protects consistency between cl_attr's of
118  * top-object and sub-objects.
119  */
120 static int vvp_prep_size(const struct lu_env *env, struct cl_object *obj,
121                          struct cl_io *io, loff_t start, size_t count,
122                          int *exceed)
123 {
124         struct cl_attr *attr  = vvp_env_thread_attr(env);
125         struct inode   *inode = vvp_object_inode(obj);
126         loff_t          pos   = start + count - 1;
127         loff_t kms;
128         int result;
129
130         /*
131          * Consistency guarantees: following possibilities exist for the
132          * relation between region being accessed and real file size at this
133          * moment:
134          *
135          *  (A): the region is completely inside of the file;
136          *
137          *  (B-x): x bytes of region are inside of the file, the rest is
138          *  outside;
139          *
140          *  (C): the region is completely outside of the file.
141          *
142          * This classification is stable under DLM lock already acquired by
143          * the caller, because to change the class, other client has to take
144          * DLM lock conflicting with our lock. Also, any updates to ->i_size
145          * by other threads on this client are serialized by
146          * ll_inode_size_lock(). This guarantees that short reads are handled
147          * correctly in the face of concurrent writes and truncates.
148          */
149         vvp_object_size_lock(obj);
150         result = cl_object_attr_get(env, obj, attr);
151         if (result == 0) {
152                 kms = attr->cat_kms;
153                 if (pos > kms || !attr->cat_kms_valid) {
154                         /*
155                          * A glimpse is necessary to determine whether we
156                          * return a short read (B) or some zeroes at the end
157                          * of the buffer (C)
158                          */
159                         vvp_object_size_unlock(obj);
160                         result = cl_glimpse_lock(env, io, inode, obj, 0);
161                         if (result == 0 && exceed != NULL) {
162                                 /* If objective page index exceed end-of-file
163                                  * page index, return directly. Do not expect
164                                  * kernel will check such case correctly.
165                                  * linux-2.6.18-128.1.1 miss to do that.
166                                  * --bug 17336 */
167                                 loff_t size = i_size_read(inode);
168                                 unsigned long cur_index = start >>
169                                         PAGE_SHIFT;
170
171                                 if ((size == 0 && cur_index != 0) ||
172                                     (((size - 1) >> PAGE_SHIFT) <
173                                      cur_index))
174                                         *exceed = 1;
175                         }
176
177                         return result;
178                 } else {
179                         /*
180                          * region is within kms and, hence, within real file
181                          * size (A). We need to increase i_size to cover the
182                          * read region so that generic_file_read() will do its
183                          * job, but that doesn't mean the kms size is
184                          * _correct_, it is only the _minimum_ size. If
185                          * someone does a stat they will get the correct size
186                          * which will always be >= the kms value here.
187                          * b=11081
188                          */
189                         if (i_size_read(inode) < kms) {
190                                 i_size_write(inode, kms);
191                                 CDEBUG(D_VFSTRACE,
192                                        DFID" updating i_size %llu\n",
193                                        PFID(lu_object_fid(&obj->co_lu)),
194                                        (__u64)i_size_read(inode));
195                         }
196                 }
197         }
198
199         vvp_object_size_unlock(obj);
200
201         return result;
202 }
203
204 /*****************************************************************************
205  *
206  * io operations.
207  *
208  */
209
210 static int vvp_io_one_lock_index(const struct lu_env *env, struct cl_io *io,
211                                  __u32 enqflags, enum cl_lock_mode mode,
212                                  pgoff_t start, pgoff_t end)
213 {
214         struct vvp_io          *vio   = vvp_env_io(env);
215         struct cl_lock_descr   *descr = &vio->vui_link.cill_descr;
216         struct cl_object       *obj   = io->ci_obj;
217
218         CLOBINVRNT(env, obj, vvp_object_invariant(obj));
219         ENTRY;
220
221         CDEBUG(D_VFSTRACE, "lock: %d [%lu, %lu]\n", mode, start, end);
222
223         memset(&vio->vui_link, 0, sizeof vio->vui_link);
224
225         if (vio->vui_fd && (vio->vui_fd->fd_flags & LL_FILE_GROUP_LOCKED)) {
226                 descr->cld_mode = CLM_GROUP;
227                 descr->cld_gid  = vio->vui_fd->fd_grouplock.lg_gid;
228                 enqflags |= CEF_LOCK_MATCH;
229         } else {
230                 descr->cld_mode  = mode;
231         }
232
233         descr->cld_obj   = obj;
234         descr->cld_start = start;
235         descr->cld_end   = end;
236         descr->cld_enq_flags = enqflags;
237
238         cl_io_lock_add(env, io, &vio->vui_link);
239
240         RETURN(0);
241 }
242
243 static int vvp_io_one_lock(const struct lu_env *env, struct cl_io *io,
244                            __u32 enqflags, enum cl_lock_mode mode,
245                            loff_t start, loff_t end)
246 {
247         return vvp_io_one_lock_index(env, io, enqflags, mode,
248                                      start >> PAGE_SHIFT, end >> PAGE_SHIFT);
249 }
250
251 static int vvp_io_write_iter_init(const struct lu_env *env,
252                                   const struct cl_io_slice *ios)
253 {
254         struct vvp_io *vio = cl2vvp_io(env, ios);
255
256         cl_page_list_init(&vio->u.readwrite.vui_queue);
257         vio->u.readwrite.vui_written = 0;
258         vio->u.readwrite.vui_from = 0;
259         vio->u.readwrite.vui_to = PAGE_SIZE;
260
261         return 0;
262 }
263
264 static int vvp_io_read_iter_init(const struct lu_env *env,
265                                  const struct cl_io_slice *ios)
266 {
267         struct vvp_io *vio = cl2vvp_io(env, ios);
268
269         vio->u.readwrite.vui_read = 0;
270
271         return 0;
272 }
273
274 static void vvp_io_write_iter_fini(const struct lu_env *env,
275                                    const struct cl_io_slice *ios)
276 {
277         struct vvp_io *vio = cl2vvp_io(env, ios);
278
279         LASSERT(vio->u.readwrite.vui_queue.pl_nr == 0);
280 }
281
282 static int vvp_io_fault_iter_init(const struct lu_env *env,
283                                   const struct cl_io_slice *ios)
284 {
285         struct vvp_io *vio   = cl2vvp_io(env, ios);
286         struct inode  *inode = vvp_object_inode(ios->cis_obj);
287
288         LASSERT(inode == file_inode(vio->vui_fd->fd_file));
289
290         return 0;
291 }
292
293 static void vvp_io_fini(const struct lu_env *env, const struct cl_io_slice *ios)
294 {
295         struct cl_io     *io  = ios->cis_io;
296         struct cl_object *obj = io->ci_obj;
297         struct vvp_io    *vio = cl2vvp_io(env, ios);
298         struct inode     *inode = vvp_object_inode(obj);
299         __u32             gen = 0;
300         int rc;
301         ENTRY;
302
303         CLOBINVRNT(env, obj, vvp_object_invariant(obj));
304
305         CDEBUG(D_VFSTRACE, DFID" ignore/verify layout %d/%d, layout version %d "
306                            "need write layout %d, restore needed %d\n",
307                PFID(lu_object_fid(&obj->co_lu)),
308                io->ci_ignore_layout, io->ci_verify_layout,
309                vio->vui_layout_gen, io->ci_need_write_intent,
310                io->ci_restore_needed);
311
312         if (io->ci_restore_needed) {
313                 /* file was detected release, we need to restore it
314                  * before finishing the io
315                  */
316                 rc = ll_layout_restore(inode, 0, OBD_OBJECT_EOF);
317                 /* if restore registration failed, no restart,
318                  * we will return -ENODATA */
319                 /* The layout will change after restore, so we need to
320                  * block on layout lock held by the MDT
321                  * as MDT will not send new layout in lvb (see LU-3124)
322                  * we have to explicitly fetch it, all this will be done
323                  * by ll_layout_refresh().
324                  * Even if ll_layout_restore() returns zero, it doesn't mean
325                  * that restore has been successful. Therefore it sets
326                  * ci_verify_layout so that it will check layout at the end
327                  * of this function.
328                  */
329                 if (rc) {
330                         io->ci_restore_needed = 1;
331                         io->ci_need_restart = 0;
332                         io->ci_verify_layout = 0;
333                         io->ci_result = rc;
334                         GOTO(out, rc);
335                 }
336
337                 io->ci_restore_needed = 0;
338
339                 /* Even if ll_layout_restore() returns zero, it doesn't mean
340                  * that restore has been successful. Therefore it should verify
341                  * if there was layout change and restart I/O correspondingly.
342                  */
343                 ll_layout_refresh(inode, &gen);
344                 io->ci_need_restart = vio->vui_layout_gen != gen;
345                 if (io->ci_need_restart) {
346                         CDEBUG(D_VFSTRACE,
347                                DFID" layout changed from %d to %d.\n",
348                                PFID(lu_object_fid(&obj->co_lu)),
349                                vio->vui_layout_gen, gen);
350                         /* today successful restore is the only possible
351                          * case */
352                         /* restore was done, clear restoring state */
353                         clear_bit(LLIF_FILE_RESTORING,
354                                   &ll_i2info(vvp_object_inode(obj))->lli_flags);
355                 }
356                 GOTO(out, 0);
357         }
358
359         /**
360          * dynamic layout change needed, send layout intent
361          * RPC.
362          */
363         if (io->ci_need_write_intent) {
364                 enum layout_intent_opc opc = LAYOUT_INTENT_WRITE;
365
366                 io->ci_need_write_intent = 0;
367
368                 LASSERT(io->ci_type == CIT_WRITE || cl_io_is_fallocate(io) ||
369                         cl_io_is_trunc(io) || cl_io_is_mkwrite(io));
370
371                 CDEBUG(D_VFSTRACE, DFID" write layout, type %u "DEXT"\n",
372                        PFID(lu_object_fid(&obj->co_lu)), io->ci_type,
373                        PEXT(&io->ci_write_intent));
374
375                 if (cl_io_is_trunc(io))
376                         opc = LAYOUT_INTENT_TRUNC;
377
378                 rc = ll_layout_write_intent(inode, opc, &io->ci_write_intent);
379                 io->ci_result = rc;
380                 if (!rc)
381                         io->ci_need_restart = 1;
382                 GOTO(out, rc);
383         }
384
385         if (!io->ci_need_restart &&
386             !io->ci_ignore_layout && io->ci_verify_layout) {
387                 /* check layout version */
388                 ll_layout_refresh(inode, &gen);
389                 io->ci_need_restart = vio->vui_layout_gen != gen;
390                 if (io->ci_need_restart) {
391                         CDEBUG(D_VFSTRACE,
392                                DFID" layout changed from %d to %d.\n",
393                                PFID(lu_object_fid(&obj->co_lu)),
394                                vio->vui_layout_gen, gen);
395                 }
396                 GOTO(out, 0);
397         }
398 out:
399         EXIT;
400 }
401
402 static void vvp_io_fault_fini(const struct lu_env *env,
403                               const struct cl_io_slice *ios)
404 {
405         struct cl_io   *io   = ios->cis_io;
406         struct cl_page *page = io->u.ci_fault.ft_page;
407
408         CLOBINVRNT(env, io->ci_obj, vvp_object_invariant(io->ci_obj));
409
410         if (page != NULL) {
411                 lu_ref_del(&page->cp_reference, "fault", io);
412                 cl_page_put(env, page);
413                 io->u.ci_fault.ft_page = NULL;
414         }
415         vvp_io_fini(env, ios);
416 }
417
418 static enum cl_lock_mode vvp_mode_from_vma(struct vm_area_struct *vma)
419 {
420         /*
421          * we only want to hold PW locks if the mmap() can generate
422          * writes back to the file and that only happens in shared
423          * writable vmas
424          */
425         if ((vma->vm_flags & VM_SHARED) && (vma->vm_flags & VM_WRITE))
426                 return CLM_WRITE;
427         return CLM_READ;
428 }
429
430 static int vvp_mmap_locks(const struct lu_env *env,
431                           struct vvp_io *vio, struct cl_io *io)
432 {
433         struct vvp_thread_info *vti = vvp_env_info(env);
434         struct mm_struct *mm = current->mm;
435         struct vm_area_struct *vma;
436         struct cl_lock_descr *descr = &vti->vti_descr;
437         union ldlm_policy_data policy;
438         struct iovec iov;
439         struct iov_iter i;
440         unsigned long addr;
441         ssize_t count;
442         int result = 0;
443         ENTRY;
444
445         LASSERT(io->ci_type == CIT_READ || io->ci_type == CIT_WRITE);
446
447         /* nfs or loop back device write */
448         if (vio->vui_iter == NULL)
449                 RETURN(0);
450
451         /* No MM (e.g. NFS)? No vmas too. */
452         if (mm == NULL)
453                 RETURN(0);
454
455         if (!iter_is_iovec(vio->vui_iter) && !iov_iter_is_kvec(vio->vui_iter))
456                 RETURN(0);
457
458         for (i = *vio->vui_iter;
459              iov_iter_count(&i);
460              iov_iter_advance(&i, iov.iov_len)) {
461                 iov = iov_iter_iovec(&i);
462                 addr = (unsigned long)iov.iov_base;
463                 count = iov.iov_len;
464
465                 if (count == 0)
466                         continue;
467
468                 count += addr & ~PAGE_MASK;
469                 addr &= PAGE_MASK;
470
471                 mmap_read_lock(mm);
472                 while ((vma = our_vma(mm, addr, count)) != NULL) {
473                         struct dentry *de = file_dentry(vma->vm_file);
474                         struct inode *inode = de->d_inode;
475                         int flags = CEF_MUST;
476
477                         if (ll_file_nolock(vma->vm_file)) {
478                                 /*
479                                  * For no lock case is not allowed for mmap
480                                  */
481                                 result = -EINVAL;
482                                 break;
483                         }
484
485                         /*
486                          * XXX: Required lock mode can be weakened: CIT_WRITE
487                          * io only ever reads user level buffer, and CIT_READ
488                          * only writes on it.
489                          */
490                         policy_from_vma(&policy, vma, addr, count);
491                         descr->cld_mode = vvp_mode_from_vma(vma);
492                         descr->cld_obj = ll_i2info(inode)->lli_clob;
493                         descr->cld_start = policy.l_extent.start >> PAGE_SHIFT;
494                         descr->cld_end = policy.l_extent.end >> PAGE_SHIFT;
495                         descr->cld_enq_flags = flags;
496                         result = cl_io_lock_alloc_add(env, io, descr);
497
498                         CDEBUG(D_VFSTRACE, "lock: %d: [%lu, %lu]\n",
499                                descr->cld_mode, descr->cld_start,
500                                descr->cld_end);
501
502                         if (result < 0)
503                                 break;
504
505                         if (vma->vm_end - addr >= count)
506                                 break;
507
508                         count -= vma->vm_end - addr;
509                         addr = vma->vm_end;
510                 }
511                 mmap_read_unlock(mm);
512                 if (result < 0)
513                         break;
514         }
515         RETURN(result);
516 }
517
518 static void vvp_io_advance(const struct lu_env *env,
519                            const struct cl_io_slice *ios,
520                            size_t nob)
521 {
522         struct cl_object *obj = ios->cis_io->ci_obj;
523         struct vvp_io *vio = cl2vvp_io(env, ios);
524
525         CLOBINVRNT(env, obj, vvp_object_invariant(obj));
526
527         /*
528          * Since 3.16(26978b8b4) vfs revert iov iter to
529          * original position even io succeed, so instead
530          * of relying on VFS, we move iov iter by ourselves.
531          */
532         iov_iter_advance(vio->vui_iter, nob);
533         CDEBUG(D_VFSTRACE, "advancing %ld bytes\n", nob);
534         vio->vui_tot_count -= nob;
535         iov_iter_reexpand(vio->vui_iter, vio->vui_tot_count);
536 }
537
538 static void vvp_io_update_iov(const struct lu_env *env,
539                               struct vvp_io *vio, struct cl_io *io)
540 {
541         size_t size = io->u.ci_rw.crw_count;
542
543         if (!vio->vui_iter)
544                 return;
545
546         iov_iter_truncate(vio->vui_iter, size);
547 }
548
549 static int vvp_io_rw_lock(const struct lu_env *env, struct cl_io *io,
550                           enum cl_lock_mode mode, loff_t start, loff_t end)
551 {
552         struct vvp_io *vio = vvp_env_io(env);
553         int result;
554         int ast_flags = 0;
555
556         LASSERT(io->ci_type == CIT_READ || io->ci_type == CIT_WRITE);
557         ENTRY;
558
559         vvp_io_update_iov(env, vio, io);
560
561         if (io->u.ci_rw.crw_nonblock)
562                 ast_flags |= CEF_NONBLOCK;
563         if (io->ci_lock_no_expand)
564                 ast_flags |= CEF_LOCK_NO_EXPAND;
565         if (vio->vui_fd) {
566                 /* Group lock held means no lockless any more */
567                 if (vio->vui_fd->fd_flags & LL_FILE_GROUP_LOCKED)
568                         io->ci_dio_lock = 1;
569
570                 if (ll_file_nolock(vio->vui_fd->fd_file) ||
571                     (vio->vui_fd->fd_file->f_flags & O_DIRECT &&
572                      !io->ci_dio_lock))
573                         ast_flags |= CEF_NEVER;
574         }
575
576         result = vvp_mmap_locks(env, vio, io);
577         if (result == 0)
578                 result = vvp_io_one_lock(env, io, ast_flags, mode, start, end);
579
580         RETURN(result);
581 }
582
583 static int vvp_io_read_lock(const struct lu_env *env,
584                             const struct cl_io_slice *ios)
585 {
586         struct cl_io *io = ios->cis_io;
587         struct cl_io_rw_common *rd = &io->u.ci_rd.rd;
588         int result;
589
590         ENTRY;
591         result = vvp_io_rw_lock(env, io, CLM_READ, rd->crw_pos,
592                                 rd->crw_pos + rd->crw_count - 1);
593         RETURN(result);
594 }
595
596 static int vvp_io_fault_lock(const struct lu_env *env,
597                              const struct cl_io_slice *ios)
598 {
599         struct cl_io *io   = ios->cis_io;
600         struct vvp_io *vio = cl2vvp_io(env, ios);
601         /*
602          * XXX LDLM_FL_CBPENDING
603          */
604         return vvp_io_one_lock_index(env,
605                                      io, 0,
606                                      vvp_mode_from_vma(vio->u.fault.ft_vma),
607                                      io->u.ci_fault.ft_index,
608                                      io->u.ci_fault.ft_index);
609 }
610
611 static int vvp_io_write_lock(const struct lu_env *env,
612                              const struct cl_io_slice *ios)
613 {
614         struct cl_io *io = ios->cis_io;
615         loff_t start;
616         loff_t end;
617
618         if (io->u.ci_wr.wr_append) {
619                 start = 0;
620                 end   = OBD_OBJECT_EOF;
621         } else {
622                 start = io->u.ci_wr.wr.crw_pos;
623                 end   = start + io->u.ci_wr.wr.crw_count - 1;
624         }
625
626         RETURN(vvp_io_rw_lock(env, io, CLM_WRITE, start, end));
627 }
628
629 static int vvp_io_setattr_iter_init(const struct lu_env *env,
630                                     const struct cl_io_slice *ios)
631
632 {
633         return 0;
634 }
635
636 /**
637  * Implementation of cl_io_operations::cio_lock() method for CIT_SETATTR io.
638  *
639  * Handles "lockless io" mode when extent locking is done by server.
640  */
641 static int vvp_io_setattr_lock(const struct lu_env *env,
642                                const struct cl_io_slice *ios)
643 {
644         struct cl_io  *io  = ios->cis_io;
645         __u64 lock_start = 0;
646         __u64 lock_end = OBD_OBJECT_EOF;
647         __u32 enqflags = 0;
648
649         if (cl_io_is_trunc(io)) {
650                 struct inode *inode = vvp_object_inode(io->ci_obj);
651
652                 /* set enqueue flags to CEF_MUST in case of encrypted file,
653                  * to prevent lockless truncate
654                  */
655                 if (S_ISREG(inode->i_mode) && IS_ENCRYPTED(inode))
656                         enqflags = CEF_MUST;
657                 else if (io->u.ci_setattr.sa_attr.lvb_size == 0)
658                         enqflags = CEF_DISCARD_DATA;
659         } else if (cl_io_is_fallocate(io)) {
660                 lock_start = io->u.ci_setattr.sa_falloc_offset;
661                 lock_end = io->u.ci_setattr.sa_falloc_end - 1;
662         } else {
663                 unsigned int valid = io->u.ci_setattr.sa_avalid;
664
665                 if (!(valid & TIMES_SET_FLAGS))
666                         return 0;
667
668                 if ((!(valid & ATTR_MTIME) ||
669                      io->u.ci_setattr.sa_attr.lvb_mtime >=
670                      io->u.ci_setattr.sa_attr.lvb_ctime) &&
671                     (!(valid & ATTR_ATIME) ||
672                      io->u.ci_setattr.sa_attr.lvb_atime >=
673                      io->u.ci_setattr.sa_attr.lvb_ctime))
674                         return 0;
675         }
676
677         return vvp_io_one_lock(env, io, enqflags, CLM_WRITE,
678                                lock_start, lock_end);
679 }
680
681 static int vvp_do_vmtruncate(struct inode *inode, size_t size)
682 {
683         int     result;
684
685         /*
686          * Only ll_inode_size_lock is taken at this level.
687          */
688         ll_inode_size_lock(inode);
689         result = inode_newsize_ok(inode, size);
690         if (result < 0) {
691                 ll_inode_size_unlock(inode);
692                 return result;
693         }
694         i_size_write(inode, size);
695
696         ll_truncate_pagecache(inode, size);
697         ll_inode_size_unlock(inode);
698         return result;
699 }
700
701 static int vvp_io_setattr_time(const struct lu_env *env,
702                                const struct cl_io_slice *ios)
703 {
704         struct cl_io       *io    = ios->cis_io;
705         struct cl_object   *obj   = io->ci_obj;
706         struct cl_attr     *attr  = vvp_env_thread_attr(env);
707         int result;
708         unsigned valid = CAT_CTIME;
709
710         cl_object_attr_lock(obj);
711         attr->cat_ctime = io->u.ci_setattr.sa_attr.lvb_ctime;
712         if (io->u.ci_setattr.sa_avalid & ATTR_ATIME_SET) {
713                 attr->cat_atime = io->u.ci_setattr.sa_attr.lvb_atime;
714                 valid |= CAT_ATIME;
715         }
716         if (io->u.ci_setattr.sa_avalid & ATTR_MTIME_SET) {
717                 attr->cat_mtime = io->u.ci_setattr.sa_attr.lvb_mtime;
718                 valid |= CAT_MTIME;
719         }
720         result = cl_object_attr_update(env, obj, attr, valid);
721         cl_object_attr_unlock(obj);
722
723         return result;
724 }
725
726 static int vvp_io_setattr_start(const struct lu_env *env,
727                                 const struct cl_io_slice *ios)
728 {
729         struct cl_io *io = ios->cis_io;
730         struct inode *inode = vvp_object_inode(io->ci_obj);
731         struct ll_inode_info *lli = ll_i2info(inode);
732         int mode = io->u.ci_setattr.sa_falloc_mode;
733
734         if (cl_io_is_trunc(io)) {
735                 trunc_sem_down_write(&lli->lli_trunc_sem);
736                 mutex_lock(&lli->lli_setattr_mutex);
737                 inode_dio_wait(inode);
738         } else if (cl_io_is_fallocate(io)) {
739                 loff_t size;
740
741                 trunc_sem_down_write(&lli->lli_trunc_sem);
742                 mutex_lock(&lli->lli_setattr_mutex);
743                 inode_dio_wait(inode);
744
745                 ll_merge_attr(env, inode);
746                 size = i_size_read(inode);
747                 if (io->u.ci_setattr.sa_falloc_end > size &&
748                     !(mode & FALLOC_FL_KEEP_SIZE)) {
749                         size = io->u.ci_setattr.sa_falloc_end;
750                         io->u.ci_setattr.sa_avalid |= ATTR_SIZE;
751                 }
752                 io->u.ci_setattr.sa_attr.lvb_size = size;
753         } else {
754                 mutex_lock(&lli->lli_setattr_mutex);
755         }
756
757         if (io->u.ci_setattr.sa_avalid & TIMES_SET_FLAGS)
758                 return vvp_io_setattr_time(env, ios);
759
760         return 0;
761 }
762
763 static void vvp_io_setattr_end(const struct lu_env *env,
764                                const struct cl_io_slice *ios)
765 {
766         struct cl_io *io = ios->cis_io;
767         struct inode *inode = vvp_object_inode(io->ci_obj);
768         struct ll_inode_info *lli = ll_i2info(inode);
769         loff_t size = io->u.ci_setattr.sa_attr.lvb_size;
770
771         if (cl_io_is_trunc(io)) {
772                 /* Truncate in memory pages - they must be clean pages
773                  * because osc has already notified to destroy osc_extents. */
774                 vvp_do_vmtruncate(inode, size);
775                 mutex_unlock(&lli->lli_setattr_mutex);
776                 trunc_sem_up_write(&lli->lli_trunc_sem);
777
778                 /* Update size and blocks for LSOM */
779                 if (!io->ci_ignore_layout)
780                         ll_merge_attr(env, inode);
781         } else if (cl_io_is_fallocate(io)) {
782                 int mode = io->u.ci_setattr.sa_falloc_mode;
783
784                 if (!(mode & FALLOC_FL_KEEP_SIZE) &&
785                     size > i_size_read(inode)) {
786                         ll_inode_size_lock(inode);
787                         i_size_write(inode, size);
788                         ll_inode_size_unlock(inode);
789                 }
790                 inode->i_ctime = current_time(inode);
791                 mutex_unlock(&lli->lli_setattr_mutex);
792                 trunc_sem_up_write(&lli->lli_trunc_sem);
793         } else {
794                 mutex_unlock(&lli->lli_setattr_mutex);
795         }
796 }
797
798 static void vvp_io_setattr_fini(const struct lu_env *env,
799                                 const struct cl_io_slice *ios)
800 {
801         bool restore_needed = ios->cis_io->ci_restore_needed;
802         struct inode *inode = vvp_object_inode(ios->cis_obj);
803
804         vvp_io_fini(env, ios);
805
806         if (restore_needed && !ios->cis_io->ci_restore_needed) {
807                 /* restore finished, set data modified flag for HSM */
808                 set_bit(LLIF_DATA_MODIFIED, &ll_i2info(inode)->lli_flags);
809         }
810 }
811
812 static int vvp_io_read_start(const struct lu_env *env,
813                              const struct cl_io_slice *ios)
814 {
815         struct vvp_io *vio = cl2vvp_io(env, ios);
816         struct cl_io *io = ios->cis_io;
817         struct cl_object *obj = io->ci_obj;
818         struct inode *inode = vvp_object_inode(obj);
819         struct ll_inode_info *lli = ll_i2info(inode);
820         struct file *file = vio->vui_fd->fd_file;
821         loff_t pos = io->u.ci_rd.rd.crw_pos;
822         size_t cnt = io->u.ci_rd.rd.crw_count;
823         size_t tot = vio->vui_tot_count;
824         struct ll_cl_context *lcc;
825         unsigned int seq;
826         int exceed = 0;
827         int result;
828         int total_bytes_read = 0;
829         struct iov_iter iter;
830         pgoff_t page_offset;
831
832         ENTRY;
833
834         CLOBINVRNT(env, obj, vvp_object_invariant(obj));
835
836         CDEBUG(D_VFSTRACE, "%s: read [%llu, %llu)\n",
837                 file_dentry(file)->d_name.name,
838                 pos, pos + cnt);
839
840         trunc_sem_down_read(&lli->lli_trunc_sem);
841
842         if (io->ci_async_readahead) {
843                 file_accessed(file);
844                 RETURN(0);
845         }
846
847         if (!can_populate_pages(env, io, inode))
848                 RETURN(0);
849
850         if (!(file->f_flags & O_DIRECT)) {
851                 result = cl_io_lru_reserve(env, io, pos, cnt);
852                 if (result)
853                         RETURN(result);
854         }
855
856         /* Unless this is reading a sparse file, otherwise the lock has already
857          * been acquired so vvp_prep_size() is an empty op. */
858         result = vvp_prep_size(env, obj, io, pos, cnt, &exceed);
859         if (result != 0)
860                 RETURN(result);
861         else if (exceed != 0)
862                 GOTO(out, result);
863
864         LU_OBJECT_HEADER(D_INODE, env, &obj->co_lu,
865                          "Read ino %lu, %zu bytes, offset %lld, size %llu\n",
866                          inode->i_ino, cnt, pos, i_size_read(inode));
867
868         /* initialize read-ahead window once per syscall */
869         if (!vio->vui_ra_valid) {
870                 vio->vui_ra_valid = true;
871                 vio->vui_ra_start_idx = pos >> PAGE_SHIFT;
872                 vio->vui_ra_pages = 0;
873                 page_offset = pos & ~PAGE_MASK;
874                 if (page_offset) {
875                         vio->vui_ra_pages++;
876                         if (tot > PAGE_SIZE - page_offset)
877                                 tot -= (PAGE_SIZE - page_offset);
878                         else
879                                 tot = 0;
880                 }
881                 vio->vui_ra_pages += (tot + PAGE_SIZE - 1) >> PAGE_SHIFT;
882
883                 CDEBUG(D_READA, "tot %zu, ra_start %lu, ra_count %lu\n",
884                        vio->vui_tot_count, vio->vui_ra_start_idx,
885                        vio->vui_ra_pages);
886         }
887
888         /* BUG: 5972 */
889         file_accessed(file);
890         LASSERT(vio->vui_iocb->ki_pos == pos);
891         iter = *vio->vui_iter;
892
893         lcc = ll_cl_find(inode);
894         lcc->lcc_end_index = DIV_ROUND_UP(pos + iter.count, PAGE_SIZE);
895         CDEBUG(D_VFSTRACE, "count:%ld iocb pos:%lld\n", iter.count, pos);
896
897         /* this seqlock lets us notice if a page has been deleted on this inode
898          * during the fault process, allowing us to catch an erroneous short
899          * read or EIO
900          * See LU-16160
901          */
902         do {
903                 seq = read_seqbegin(&ll_i2info(inode)->lli_page_inv_lock);
904                 result = generic_file_read_iter(vio->vui_iocb, &iter);
905                 if (result >= 0) {
906                         io->ci_nob += result;
907                         total_bytes_read += result;
908                 }
909         /* if we got a short read or -EIO and we raced with page invalidation,
910          * retry
911          */
912         } while (read_seqretry(&ll_i2info(inode)->lli_page_inv_lock, seq) &&
913                  ((result >= 0 && iov_iter_count(&iter) > 0)
914                   || result == -EIO));
915
916 out:
917         if (result >= 0) {
918                 if (total_bytes_read < cnt)
919                         io->ci_continue = 0;
920                 result = 0;
921         } else if (result == -EIOCBQUEUED) {
922                 io->ci_nob += vio->u.readwrite.vui_read;
923                 vio->vui_iocb->ki_pos = pos + vio->u.readwrite.vui_read;
924         }
925
926         return result;
927 }
928
929 static int vvp_io_commit_sync(const struct lu_env *env, struct cl_io *io,
930                               struct cl_page_list *plist, int from, int to)
931 {
932         struct cl_2queue *queue = &io->ci_queue;
933         struct cl_page *page;
934         unsigned int bytes = 0;
935         int rc = 0;
936         ENTRY;
937
938         if (plist->pl_nr == 0)
939                 RETURN(0);
940
941         if (from > 0 || to != PAGE_SIZE) {
942                 page = cl_page_list_first(plist);
943                 if (plist->pl_nr == 1) {
944                         cl_page_clip(env, page, from, to);
945                 } else {
946                         if (from > 0)
947                                 cl_page_clip(env, page, from, PAGE_SIZE);
948                         if (to != PAGE_SIZE) {
949                                 page = cl_page_list_last(plist);
950                                 cl_page_clip(env, page, 0, to);
951                         }
952                 }
953         }
954
955         cl_2queue_init(queue);
956         cl_page_list_splice(plist, &queue->c2_qin);
957         rc = cl_io_submit_sync(env, io, CRT_WRITE, queue, 0);
958
959         /* plist is not sorted any more */
960         cl_page_list_splice(&queue->c2_qin, plist);
961         cl_page_list_splice(&queue->c2_qout, plist);
962         cl_2queue_fini(env, queue);
963
964         if (rc == 0) {
965                 /* calculate bytes */
966                 bytes = plist->pl_nr << PAGE_SHIFT;
967                 bytes -= from + PAGE_SIZE - to;
968
969                 while (plist->pl_nr > 0) {
970                         page = cl_page_list_first(plist);
971                         cl_page_list_del(env, plist, page);
972
973                         cl_page_clip(env, page, 0, PAGE_SIZE);
974
975                         SetPageUptodate(cl_page_vmpage(page));
976                         cl_page_disown(env, io, page);
977
978                         /* held in ll_cl_init() */
979                         lu_ref_del(&page->cp_reference, "cl_io", io);
980                         cl_page_put(env, page);
981                 }
982         }
983
984         RETURN(bytes > 0 ? bytes : rc);
985 }
986
987 /*
988  * From kernel v4.19-rc5-248-g9b89a0355144 use XArrary
989  * Prior kernels use radix_tree for tags
990  */
991 static inline void ll_page_tag_dirty(struct page *page,
992                                      struct address_space *mapping)
993 {
994 #ifndef HAVE_RADIX_TREE_TAG_SET
995         __xa_set_mark(&mapping->i_pages, page_index(page), PAGECACHE_TAG_DIRTY);
996 #else
997         radix_tree_tag_set(&mapping->page_tree, page_index(page),
998                            PAGECACHE_TAG_DIRTY);
999 #endif
1000 }
1001
1002 /*
1003  * Kernels 4.2 - 4.5 pass memcg argument to account_page_dirtied()
1004  * Kernel v5.2-5678-gac1c3e4 no longer exports account_page_dirtied
1005  */
1006 static inline void ll_account_page_dirtied(struct page *page,
1007                                            struct address_space *mapping)
1008 {
1009 #ifdef HAVE_ACCOUNT_PAGE_DIRTIED_3ARGS
1010         struct mem_cgroup *memcg = mem_cgroup_begin_page_stat(page);
1011
1012         account_page_dirtied(page, mapping, memcg);
1013         mem_cgroup_end_page_stat(memcg);
1014 #elif defined(HAVE_ACCOUNT_PAGE_DIRTIED_EXPORT)
1015         account_page_dirtied(page, mapping);
1016 #else
1017         vvp_account_page_dirtied(page, mapping);
1018 #endif
1019         ll_page_tag_dirty(page, mapping);
1020 }
1021
1022 /* Taken from kernel set_page_dirty, __set_page_dirty_nobuffers
1023  * Last change to this area: b93b016313b3ba8003c3b8bb71f569af91f19fc7
1024  *
1025  * Current with Linus tip of tree (7/13/2019):
1026  * v5.2-rc4-224-ge01e060fe0
1027  *
1028  * Backwards compat for 3.x, 5.x kernels relating to memcg handling
1029  * & rename of radix tree to xarray.
1030  */
1031 void vvp_set_pagevec_dirty(struct pagevec *pvec)
1032 {
1033         struct page *page = pvec->pages[0];
1034         int count = pagevec_count(pvec);
1035         int i;
1036 #ifdef HAVE_KALLSYMS_LOOKUP_NAME
1037         struct address_space *mapping = page->mapping;
1038         unsigned long flags;
1039         unsigned long skip_pages = 0;
1040         int dirtied = 0;
1041 #endif
1042
1043         ENTRY;
1044
1045         BUILD_BUG_ON(PAGEVEC_SIZE > BITS_PER_LONG);
1046         LASSERTF(page->mapping,
1047                  "mapping must be set. page %p, page->private (cl_page) %p\n",
1048                  page, (void *) page->private);
1049
1050         /*
1051          * kernels without HAVE_KALLSYMS_LOOKUP_NAME also don't have
1052          * account_dirty_page exported, and if we can't access that symbol,
1053          * we can't do page dirtying in batch (taking the xarray lock only once)
1054          * so we just fall back to a looped call to __set_page_dirty_nobuffers
1055          */
1056 #ifndef HAVE_ACCOUNT_PAGE_DIRTIED_EXPORT
1057         if (!vvp_account_page_dirtied) {
1058                 for (i = 0; i < count; i++)
1059                         __set_page_dirty_nobuffers(pvec->pages[i]);
1060                 EXIT;
1061         }
1062 #endif
1063
1064 #ifdef HAVE_KALLSYMS_LOOKUP_NAME
1065         for (i = 0; i < count; i++) {
1066                 page = pvec->pages[i];
1067
1068                 ClearPageReclaim(page);
1069
1070                 vvp_lock_page_memcg(page);
1071                 if (TestSetPageDirty(page)) {
1072                         /* page is already dirty .. no extra work needed
1073                          * set a flag for the i'th page to be skipped
1074                          */
1075                         vvp_unlock_page_memcg(page);
1076                         skip_pages |= (1 << i);
1077                 }
1078         }
1079
1080         ll_xa_lock_irqsave(&mapping->i_pages, flags);
1081
1082         /* Notes on differences with __set_page_dirty_nobuffers:
1083          * 1. We don't need to call page_mapping because we know this is a page
1084          * cache page.
1085          * 2. We have the pages locked, so there is no need for the careful
1086          * mapping/mapping2 dance.
1087          * 3. No mapping is impossible. (Race w/truncate mentioned in
1088          * dirty_nobuffers should be impossible because we hold the page lock.)
1089          * 4. All mappings are the same because i/o is only to one file.
1090          */
1091         for (i = 0; i < count; i++) {
1092                 page = pvec->pages[i];
1093                 /* if the i'th page was unlocked above, skip it here */
1094                 if ((skip_pages >> i) & 1)
1095                         continue;
1096
1097                 LASSERTF(page->mapping == mapping,
1098                          "all pages must have the same mapping.  page %p, mapping %p, first mapping %p\n",
1099                          page, page->mapping, mapping);
1100                 WARN_ON_ONCE(!PagePrivate(page) && !PageUptodate(page));
1101                 ll_account_page_dirtied(page, mapping);
1102                 dirtied++;
1103                 vvp_unlock_page_memcg(page);
1104         }
1105         ll_xa_unlock_irqrestore(&mapping->i_pages, flags);
1106
1107         CDEBUG(D_VFSTRACE, "mapping %p, count %d, dirtied %d\n", mapping,
1108                count, dirtied);
1109
1110         if (mapping->host && dirtied) {
1111                 /* !PageAnon && !swapper_space */
1112                 __mark_inode_dirty(mapping->host, I_DIRTY_PAGES);
1113         }
1114 #endif
1115         EXIT;
1116 }
1117
1118 static void write_commit_callback(const struct lu_env *env, struct cl_io *io,
1119                                   struct pagevec *pvec)
1120 {
1121         int count = 0;
1122         int i = 0;
1123
1124         ENTRY;
1125
1126         count = pagevec_count(pvec);
1127         LASSERT(count > 0);
1128
1129         for (i = 0; i < count; i++) {
1130                 struct page *vmpage = pvec->pages[i];
1131                 SetPageUptodate(vmpage);
1132         }
1133
1134         vvp_set_pagevec_dirty(pvec);
1135
1136         for (i = 0; i < count; i++) {
1137                 struct page *vmpage = pvec->pages[i];
1138                 struct cl_page *page = (struct cl_page *) vmpage->private;
1139                 cl_page_disown(env, io, page);
1140                 lu_ref_del(&page->cp_reference, "cl_io", cl_io_top(io));
1141                 cl_page_put(env, page);
1142         }
1143
1144         EXIT;
1145 }
1146
1147 /* make sure the page list is contiguous */
1148 static bool page_list_sanity_check(struct cl_object *obj,
1149                                    struct cl_page_list *plist)
1150 {
1151         struct cl_page *page;
1152         pgoff_t index = CL_PAGE_EOF;
1153
1154         cl_page_list_for_each(page, plist) {
1155                 if (index == CL_PAGE_EOF) {
1156                         index = cl_page_index(page);
1157                         continue;
1158                 }
1159
1160                 ++index;
1161                 if (index == cl_page_index(page))
1162                         continue;
1163
1164                 return false;
1165         }
1166         return true;
1167 }
1168
1169 /* Return how many bytes have queued or written */
1170 int vvp_io_write_commit(const struct lu_env *env, struct cl_io *io)
1171 {
1172         struct cl_object *obj = io->ci_obj;
1173         struct inode *inode = vvp_object_inode(obj);
1174         struct vvp_io *vio = vvp_env_io(env);
1175         struct cl_page_list *queue = &vio->u.readwrite.vui_queue;
1176         struct cl_page *page;
1177         int rc = 0;
1178         int bytes = 0;
1179         unsigned int npages = vio->u.readwrite.vui_queue.pl_nr;
1180         ENTRY;
1181
1182         if (npages == 0)
1183                 RETURN(0);
1184
1185         CDEBUG(D_VFSTRACE, "commit async pages: %d, from %d, to %d\n",
1186                 npages, vio->u.readwrite.vui_from, vio->u.readwrite.vui_to);
1187
1188         LASSERT(page_list_sanity_check(obj, queue));
1189
1190         /* submit IO with async write */
1191         rc = cl_io_commit_async(env, io, queue,
1192                                 vio->u.readwrite.vui_from,
1193                                 vio->u.readwrite.vui_to,
1194                                 write_commit_callback);
1195         npages -= queue->pl_nr; /* already committed pages */
1196         if (npages > 0) {
1197                 /* calculate how many bytes were written */
1198                 bytes = npages << PAGE_SHIFT;
1199
1200                 /* first page */
1201                 bytes -= vio->u.readwrite.vui_from;
1202                 if (queue->pl_nr == 0) /* last page */
1203                         bytes -= PAGE_SIZE - vio->u.readwrite.vui_to;
1204                 LASSERTF(bytes > 0, "bytes = %d, pages = %d\n", bytes, npages);
1205
1206                 vio->u.readwrite.vui_written += bytes;
1207
1208                 CDEBUG(D_VFSTRACE, "Committed %d pages %d bytes, tot: %ld\n",
1209                         npages, bytes, vio->u.readwrite.vui_written);
1210
1211                 /* the first page must have been written. */
1212                 vio->u.readwrite.vui_from = 0;
1213         }
1214         LASSERT(page_list_sanity_check(obj, queue));
1215         LASSERT(ergo(rc == 0, queue->pl_nr == 0));
1216
1217         /* out of quota, try sync write */
1218         if (rc == -EDQUOT && !cl_io_is_mkwrite(io)) {
1219                 struct ll_inode_info *lli = ll_i2info(inode);
1220
1221                 rc = vvp_io_commit_sync(env, io, queue,
1222                                         vio->u.readwrite.vui_from,
1223                                         vio->u.readwrite.vui_to);
1224                 if (rc > 0) {
1225                         vio->u.readwrite.vui_written += rc;
1226                         rc = 0;
1227                 }
1228                 if (lli->lli_clob != NULL)
1229                         lov_read_and_clear_async_rc(lli->lli_clob);
1230                 lli->lli_async_rc = 0;
1231         }
1232
1233         /* update inode size */
1234         ll_merge_attr(env, inode);
1235
1236         /* Now the pages in queue were failed to commit, discard them
1237          * unless they were dirtied before. */
1238         while (queue->pl_nr > 0) {
1239                 page = cl_page_list_first(queue);
1240                 cl_page_list_del(env, queue, page);
1241
1242                 if (!PageDirty(cl_page_vmpage(page)))
1243                         cl_page_discard(env, io, page);
1244
1245                 cl_page_disown(env, io, page);
1246
1247                 /* held in ll_cl_init() */
1248                 lu_ref_del(&page->cp_reference, "cl_io", io);
1249                 cl_page_put(env, page);
1250         }
1251         cl_page_list_fini(env, queue);
1252
1253         RETURN(rc);
1254 }
1255
1256 static int vvp_io_write_start(const struct lu_env *env,
1257                               const struct cl_io_slice *ios)
1258 {
1259         struct vvp_io           *vio   = cl2vvp_io(env, ios);
1260         struct cl_io            *io    = ios->cis_io;
1261         struct cl_object        *obj   = io->ci_obj;
1262         struct inode            *inode = vvp_object_inode(obj);
1263         struct ll_inode_info    *lli   = ll_i2info(inode);
1264         struct file             *file  = vio->vui_fd->fd_file;
1265         ssize_t                  result = 0;
1266         loff_t                   pos = io->u.ci_wr.wr.crw_pos;
1267         size_t                   cnt = io->u.ci_wr.wr.crw_count;
1268         bool                     lock_inode = !IS_NOSEC(inode);
1269         size_t nob = io->ci_nob;
1270         struct iov_iter iter;
1271         size_t written = 0;
1272
1273         ENTRY;
1274
1275         trunc_sem_down_read(&lli->lli_trunc_sem);
1276
1277         if (!can_populate_pages(env, io, inode))
1278                 RETURN(0);
1279
1280         if (cl_io_is_append(io)) {
1281                 /*
1282                  * PARALLEL IO This has to be changed for parallel IO doing
1283                  * out-of-order writes.
1284                  */
1285                 ll_merge_attr(env, inode);
1286                 pos = io->u.ci_wr.wr.crw_pos = i_size_read(inode);
1287                 vio->vui_iocb->ki_pos = pos;
1288         } else {
1289                 LASSERTF(vio->vui_iocb->ki_pos == pos,
1290                          "ki_pos %lld [%lld, %lld)\n",
1291                          vio->vui_iocb->ki_pos,
1292                          pos, pos + cnt);
1293         }
1294
1295         CDEBUG(D_VFSTRACE, "%s: write [%llu, %llu)\n",
1296                 file_dentry(file)->d_name.name,
1297                 pos, pos + cnt);
1298
1299         /* The maximum Lustre file size is variable, based on the OST maximum
1300          * object size and number of stripes.  This needs another check in
1301          * addition to the VFS checks earlier. */
1302         if (pos + cnt > ll_file_maxbytes(inode)) {
1303                 CDEBUG(D_INODE,
1304                        "%s: file %s ("DFID") offset %llu > maxbytes %llu\n",
1305                        ll_i2sbi(inode)->ll_fsname,
1306                        file_dentry(file)->d_name.name,
1307                        PFID(ll_inode2fid(inode)), pos + cnt,
1308                        ll_file_maxbytes(inode));
1309                 RETURN(-EFBIG);
1310         }
1311
1312         /* Tests to verify we take the i_mutex correctly */
1313         if (OBD_FAIL_CHECK(OBD_FAIL_LLITE_IMUTEX_SEC) && !lock_inode)
1314                 RETURN(-EINVAL);
1315
1316         if (OBD_FAIL_CHECK(OBD_FAIL_LLITE_IMUTEX_NOSEC) && lock_inode)
1317                 RETURN(-EINVAL);
1318
1319         if (!(file->f_flags & O_DIRECT)) {
1320                 result = cl_io_lru_reserve(env, io, pos, cnt);
1321                 if (result)
1322                         RETURN(result);
1323         }
1324
1325         if (vio->vui_iter == NULL) {
1326                 /* from a temp io in ll_cl_init(). */
1327                 result = 0;
1328         } else {
1329                 /*
1330                  * When using the locked AIO function (generic_file_aio_write())
1331                  * testing has shown the inode mutex to be a limiting factor
1332                  * with multi-threaded single shared file performance. To get
1333                  * around this, we now use the lockless version. To maintain
1334                  * consistency, proper locking to protect against writes,
1335                  * trucates, etc. is handled in the higher layers of lustre.
1336                  */
1337                 lock_inode = !IS_NOSEC(inode);
1338                 iter = *vio->vui_iter;
1339
1340                 if (unlikely(lock_inode))
1341                         inode_lock(inode);
1342                 result = __generic_file_write_iter(vio->vui_iocb, &iter);
1343                 if (unlikely(lock_inode))
1344                         inode_unlock(inode);
1345
1346                 written = result;
1347                 if (result > 0)
1348 #ifdef HAVE_GENERIC_WRITE_SYNC_2ARGS
1349                         result = generic_write_sync(vio->vui_iocb, result);
1350 #else
1351                 {
1352                         ssize_t err;
1353
1354                         err = generic_write_sync(vio->vui_iocb->ki_filp, pos,
1355                                                  result);
1356                         if (err < 0 && result > 0)
1357                                 result = err;
1358                 }
1359 #endif
1360         }
1361
1362         if (result > 0) {
1363                 result = vvp_io_write_commit(env, io);
1364                 /* Simulate short commit */
1365                 if (CFS_FAULT_CHECK(OBD_FAIL_LLITE_SHORT_COMMIT)) {
1366                         vio->u.readwrite.vui_written >>= 1;
1367                         if (vio->u.readwrite.vui_written > 0)
1368                                 io->ci_need_restart = 1;
1369                 }
1370                 if (vio->u.readwrite.vui_written > 0) {
1371                         result = vio->u.readwrite.vui_written;
1372                         CDEBUG(D_VFSTRACE, "%s: write nob %zd, result: %zd\n",
1373                                 file_dentry(file)->d_name.name,
1374                                 io->ci_nob, result);
1375                         io->ci_nob += result;
1376                 } else {
1377                         io->ci_continue = 0;
1378                 }
1379         }
1380         if (vio->vui_iocb->ki_pos != (pos + io->ci_nob - nob)) {
1381                 CDEBUG(D_VFSTRACE,
1382                        "%s: write position mismatch: ki_pos %lld vs. pos %lld, written %zd, commit %zd: rc = %zd\n",
1383                        file_dentry(file)->d_name.name,
1384                        vio->vui_iocb->ki_pos, pos + io->ci_nob - nob,
1385                        written, io->ci_nob - nob, result);
1386                 /*
1387                  * Rewind ki_pos and vui_iter to where it has
1388                  * successfully committed.
1389                  */
1390                 vio->vui_iocb->ki_pos = pos + io->ci_nob - nob;
1391         }
1392         if (result > 0 || result == -EIOCBQUEUED) {
1393                 set_bit(LLIF_DATA_MODIFIED, &ll_i2info(inode)->lli_flags);
1394
1395                 if (result != -EIOCBQUEUED && result < cnt)
1396                         io->ci_continue = 0;
1397                 if (result > 0)
1398                         result = 0;
1399                 /* move forward */
1400                 if (result == -EIOCBQUEUED) {
1401                         io->ci_nob += vio->u.readwrite.vui_written;
1402                         vio->vui_iocb->ki_pos = pos +
1403                                         vio->u.readwrite.vui_written;
1404                 }
1405         }
1406
1407         RETURN(result);
1408 }
1409
1410 static void vvp_io_rw_end(const struct lu_env *env,
1411                           const struct cl_io_slice *ios)
1412 {
1413         struct inode            *inode = vvp_object_inode(ios->cis_obj);
1414         struct ll_inode_info    *lli = ll_i2info(inode);
1415
1416         trunc_sem_up_read(&lli->lli_trunc_sem);
1417 }
1418
1419 static void vvp_io_write_end(const struct lu_env *env,
1420                              const struct cl_io_slice *ios)
1421 {
1422         struct inode *inode = vvp_object_inode(ios->cis_obj);
1423         struct cl_io *io = ios->cis_io;
1424
1425         vvp_io_rw_end(env, ios);
1426
1427         /* Update size and blocks for LSOM (best effort) */
1428         if (!io->ci_ignore_layout && cl_io_is_sync_write(io))
1429                 ll_merge_attr_try(env, inode);
1430 }
1431
1432
1433 static int vvp_io_kernel_fault(struct vvp_fault_io *cfio)
1434 {
1435         struct vm_fault *vmf = cfio->ft_vmf;
1436
1437         cfio->ft_flags = ll_filemap_fault(cfio->ft_vma, vmf);
1438         cfio->ft_flags_valid = 1;
1439
1440         if (vmf->page) {
1441                 /* success, vmpage is locked */
1442                 LL_CDEBUG_PAGE(D_PAGE, vmf->page, "got addr %p type NOPAGE\n",
1443                                get_vmf_address(vmf));
1444                 if (unlikely(!(cfio->ft_flags & VM_FAULT_LOCKED))) {
1445                         lock_page(vmf->page);
1446                         cfio->ft_flags |= VM_FAULT_LOCKED;
1447                 }
1448
1449                 cfio->ft_vmpage = vmf->page;
1450
1451                 return 0;
1452         }
1453
1454         if (cfio->ft_flags & VM_FAULT_SIGBUS) {
1455                 CDEBUG(D_PAGE, "got addr %p - SIGBUS\n", get_vmf_address(vmf));
1456                 return -EFAULT;
1457         }
1458
1459         if (cfio->ft_flags & VM_FAULT_OOM) {
1460                 CDEBUG(D_PAGE, "got addr %p - OOM\n", get_vmf_address(vmf));
1461                 return -ENOMEM;
1462         }
1463
1464         if (cfio->ft_flags & VM_FAULT_RETRY)
1465                 return -EAGAIN;
1466
1467         CERROR("unknown error in page fault %d\n", cfio->ft_flags);
1468
1469         return -EINVAL;
1470 }
1471
1472 static void mkwrite_commit_callback(const struct lu_env *env, struct cl_io *io,
1473                                     struct pagevec *pvec)
1474 {
1475         vvp_set_pagevec_dirty(pvec);
1476 }
1477
1478 static int vvp_io_fault_start(const struct lu_env *env,
1479                               const struct cl_io_slice *ios)
1480 {
1481         struct vvp_io           *vio   = cl2vvp_io(env, ios);
1482         struct cl_io            *io    = ios->cis_io;
1483         struct cl_object        *obj   = io->ci_obj;
1484         struct inode            *inode = vvp_object_inode(obj);
1485         struct ll_inode_info    *lli   = ll_i2info(inode);
1486         struct cl_fault_io      *fio   = &io->u.ci_fault;
1487         struct vvp_fault_io     *cfio  = &vio->u.fault;
1488         loff_t                   offset;
1489         int                      result = 0;
1490         struct page             *vmpage = NULL;
1491         struct cl_page          *page;
1492         loff_t                   size;
1493         pgoff_t                  last_index;
1494         ENTRY;
1495
1496         trunc_sem_down_read_nowait(&lli->lli_trunc_sem);
1497
1498         /* offset of the last byte on the page */
1499         offset = ((fio->ft_index + 1) << PAGE_SHIFT) - 1;
1500         LASSERT((offset >> PAGE_SHIFT) == fio->ft_index);
1501         result = vvp_prep_size(env, obj, io, 0, offset + 1, NULL);
1502         if (result != 0)
1503                 RETURN(result);
1504
1505         /* must return locked page */
1506         if (fio->ft_mkwrite) {
1507                 LASSERT(cfio->ft_vmpage != NULL);
1508                 lock_page(cfio->ft_vmpage);
1509         } else {
1510                 result = vvp_io_kernel_fault(cfio);
1511                 if (result != 0)
1512                         RETURN(result);
1513         }
1514
1515         vmpage = cfio->ft_vmpage;
1516         LASSERT(PageLocked(vmpage));
1517
1518         if (OBD_FAIL_CHECK(OBD_FAIL_LLITE_FAULT_TRUNC_RACE))
1519                 generic_error_remove_page(vmpage->mapping, vmpage);
1520
1521         size = i_size_read(inode);
1522         /* Though we have already held a cl_lock upon this page, but
1523          * it still can be truncated locally. */
1524         if (unlikely((vmpage->mapping != inode->i_mapping) ||
1525                      (page_offset(vmpage) > size))) {
1526                 CDEBUG(D_PAGE, "llite: fault and truncate race happened!\n");
1527
1528                 /* return +1 to stop cl_io_loop() and ll_fault() will catch
1529                  * and retry. */
1530                 GOTO(out, result = +1);
1531         }
1532
1533         last_index = (size - 1) >> PAGE_SHIFT;
1534
1535         if (fio->ft_mkwrite ) {
1536                 /*
1537                  * Capture the size while holding the lli_trunc_sem from above
1538                  * we want to make sure that we complete the mkwrite action
1539                  * while holding this lock. We need to make sure that we are
1540                  * not past the end of the file.
1541                  */
1542                 if (last_index < fio->ft_index) {
1543                         CDEBUG(D_PAGE,
1544                                 "llite: mkwrite and truncate race happened: "
1545                                 "%p: 0x%lx 0x%lx\n",
1546                                 vmpage->mapping,fio->ft_index,last_index);
1547                         /*
1548                          * We need to return if we are
1549                          * passed the end of the file. This will propagate
1550                          * up the call stack to ll_page_mkwrite where
1551                          * we will return VM_FAULT_NOPAGE. Any non-negative
1552                          * value returned here will be silently
1553                          * converted to 0. If the vmpage->mapping is null
1554                          * the error code would be converted back to ENODATA
1555                          * in ll_page_mkwrite0. Thus we return -ENODATA
1556                          * to handle both cases
1557                          */
1558                         GOTO(out, result = -ENODATA);
1559                 }
1560         }
1561
1562         page = cl_page_find(env, obj, fio->ft_index, vmpage, CPT_CACHEABLE);
1563         if (IS_ERR(page))
1564                 GOTO(out, result = PTR_ERR(page));
1565
1566         /* if page is going to be written, we should add this page into cache
1567          * earlier. */
1568         if (fio->ft_mkwrite) {
1569                 wait_on_page_writeback(vmpage);
1570                 if (!PageDirty(vmpage)) {
1571                         struct cl_page_list *plist = &vio->u.fault.ft_queue;
1572                         int to = PAGE_SIZE;
1573
1574                         /* vvp_page_assume() calls wait_on_page_writeback(). */
1575                         cl_page_assume(env, io, page);
1576
1577                         cl_page_list_init(plist);
1578                         cl_page_list_add(plist, page, true);
1579
1580                         /* size fixup */
1581                         if (last_index == cl_page_index(page))
1582                                 to = ((size - 1) & ~PAGE_MASK) + 1;
1583
1584                         /* Do not set Dirty bit here so that in case IO is
1585                          * started before the page is really made dirty, we
1586                          * still have chance to detect it. */
1587                         result = cl_io_commit_async(env, io, plist, 0, to,
1588                                                     mkwrite_commit_callback);
1589                         /* Have overquota flag, trying sync write to check
1590                          * whether indeed out of quota */
1591                         if (result == -EDQUOT) {
1592                                 cl_page_get(page);
1593                                 result = vvp_io_commit_sync(env, io,
1594                                                             plist, 0, to);
1595                                 if (result >= 0) {
1596                                         io->ci_noquota = 1;
1597                                         cl_page_own(env, io, page);
1598                                         cl_page_list_add(plist, page, true);
1599                                         lu_ref_add(&page->cp_reference,
1600                                                    "cl_io", io);
1601                                         result = cl_io_commit_async(env, io,
1602                                                 plist, 0, to,
1603                                                 mkwrite_commit_callback);
1604                                         io->ci_noquota = 0;
1605                                 } else {
1606                                         cl_page_put(env, page);
1607                                 }
1608                         }
1609
1610                         LASSERT(cl_page_is_owned(page, io));
1611                         cl_page_list_fini(env, plist);
1612
1613                         vmpage = NULL;
1614                         if (result < 0) {
1615                                 cl_page_discard(env, io, page);
1616                                 cl_page_disown(env, io, page);
1617
1618                                 cl_page_put(env, page);
1619
1620                                 /* we're in big trouble, what can we do now? */
1621                                 if (result == -EDQUOT)
1622                                         result = -ENOSPC;
1623                                 GOTO(out, result);
1624                         } else {
1625                                 cl_page_disown(env, io, page);
1626                         }
1627                 }
1628         }
1629
1630         /*
1631          * The ft_index is only used in the case of
1632          * a mkwrite action. We need to check
1633          * our assertions are correct, since
1634          * we should have caught this above
1635          */
1636         LASSERT(!fio->ft_mkwrite || fio->ft_index <= last_index);
1637         if (fio->ft_index == last_index)
1638                 /*
1639                  * Last page is mapped partially.
1640                  */
1641                 fio->ft_nob = size - (fio->ft_index << PAGE_SHIFT);
1642         else
1643                 fio->ft_nob = PAGE_SIZE;
1644
1645         lu_ref_add(&page->cp_reference, "fault", io);
1646         fio->ft_page = page;
1647         EXIT;
1648
1649 out:
1650         /* return unlocked vmpage to avoid deadlocking */
1651         if (vmpage != NULL)
1652                 unlock_page(vmpage);
1653
1654         cfio->ft_flags &= ~VM_FAULT_LOCKED;
1655
1656         return result;
1657 }
1658
1659 static void vvp_io_fault_end(const struct lu_env *env,
1660                              const struct cl_io_slice *ios)
1661 {
1662         struct inode            *inode = vvp_object_inode(ios->cis_obj);
1663         struct ll_inode_info    *lli   = ll_i2info(inode);
1664
1665         CLOBINVRNT(env, ios->cis_io->ci_obj,
1666                    vvp_object_invariant(ios->cis_io->ci_obj));
1667         trunc_sem_up_read(&lli->lli_trunc_sem);
1668 }
1669
1670 static int vvp_io_fsync_start(const struct lu_env *env,
1671                               const struct cl_io_slice *ios)
1672 {
1673         /* we should mark TOWRITE bit to each dirty page in radix tree to
1674          * verify pages have been written, but this is difficult because of
1675          * race. */
1676         return 0;
1677 }
1678
1679 static void vvp_io_fsync_end(const struct lu_env *env,
1680                              const struct cl_io_slice *ios)
1681 {
1682         struct inode *inode = vvp_object_inode(ios->cis_obj);
1683         struct cl_io *io = ios->cis_io;
1684
1685         /* Update size and blocks for LSOM (best effort) */
1686         if (!io->ci_ignore_layout)
1687                 ll_merge_attr_try(env, inode);
1688 }
1689
1690 static int vvp_io_read_ahead(const struct lu_env *env,
1691                              const struct cl_io_slice *ios,
1692                              pgoff_t start, struct cl_read_ahead *ra)
1693 {
1694         int result = 0;
1695         ENTRY;
1696
1697         if (ios->cis_io->ci_type == CIT_READ ||
1698             ios->cis_io->ci_type == CIT_FAULT) {
1699                 struct vvp_io *vio = cl2vvp_io(env, ios);
1700
1701                 if (unlikely(vio->vui_fd->fd_flags & LL_FILE_GROUP_LOCKED)) {
1702                         ra->cra_end_idx = CL_PAGE_EOF;
1703                         result = +1; /* no need to call down */
1704                 }
1705         }
1706
1707         RETURN(result);
1708 }
1709
1710 static int vvp_io_lseek_lock(const struct lu_env *env,
1711                              const struct cl_io_slice *ios)
1712 {
1713         struct cl_io *io = ios->cis_io;
1714         __u64 lock_start = io->u.ci_lseek.ls_start;
1715         __u64 lock_end = OBD_OBJECT_EOF;
1716         __u32 enqflags = CEF_MUST; /* always take client lock */
1717
1718         return vvp_io_one_lock(env, io, enqflags, CLM_READ,
1719                                lock_start, lock_end);
1720 }
1721
1722 static int vvp_io_lseek_start(const struct lu_env *env,
1723                               const struct cl_io_slice *ios)
1724 {
1725         struct cl_io *io = ios->cis_io;
1726         struct inode *inode = vvp_object_inode(io->ci_obj);
1727         __u64 start = io->u.ci_lseek.ls_start;
1728
1729         inode_lock(inode);
1730         inode_dio_wait(inode);
1731
1732         /* At the moment we have DLM lock so just update inode
1733          * to know the file size.
1734          */
1735         ll_merge_attr(env, inode);
1736         if (start >= i_size_read(inode)) {
1737                 io->u.ci_lseek.ls_result = -ENXIO;
1738                 return -ENXIO;
1739         }
1740         return 0;
1741 }
1742
1743 static void vvp_io_lseek_end(const struct lu_env *env,
1744                              const struct cl_io_slice *ios)
1745 {
1746         struct cl_io *io = ios->cis_io;
1747         struct inode *inode = vvp_object_inode(io->ci_obj);
1748
1749         if (io->u.ci_lseek.ls_result > i_size_read(inode))
1750                 io->u.ci_lseek.ls_result = -ENXIO;
1751
1752         inode_unlock(inode);
1753 }
1754
1755 static const struct cl_io_operations vvp_io_ops = {
1756         .op = {
1757                 [CIT_READ] = {
1758                         .cio_fini       = vvp_io_fini,
1759                         .cio_iter_init = vvp_io_read_iter_init,
1760                         .cio_lock       = vvp_io_read_lock,
1761                         .cio_start      = vvp_io_read_start,
1762                         .cio_end        = vvp_io_rw_end,
1763                         .cio_advance    = vvp_io_advance,
1764                 },
1765                 [CIT_WRITE] = {
1766                         .cio_fini      = vvp_io_fini,
1767                         .cio_iter_init = vvp_io_write_iter_init,
1768                         .cio_iter_fini = vvp_io_write_iter_fini,
1769                         .cio_lock      = vvp_io_write_lock,
1770                         .cio_start     = vvp_io_write_start,
1771                         .cio_end       = vvp_io_write_end,
1772                         .cio_advance   = vvp_io_advance,
1773                 },
1774                 [CIT_SETATTR] = {
1775                         .cio_fini       = vvp_io_setattr_fini,
1776                         .cio_iter_init  = vvp_io_setattr_iter_init,
1777                         .cio_lock       = vvp_io_setattr_lock,
1778                         .cio_start      = vvp_io_setattr_start,
1779                         .cio_end        = vvp_io_setattr_end
1780                 },
1781                 [CIT_FAULT] = {
1782                         .cio_fini      = vvp_io_fault_fini,
1783                         .cio_iter_init = vvp_io_fault_iter_init,
1784                         .cio_lock      = vvp_io_fault_lock,
1785                         .cio_start     = vvp_io_fault_start,
1786                         .cio_end       = vvp_io_fault_end,
1787                 },
1788                 [CIT_FSYNC] = {
1789                         .cio_start      = vvp_io_fsync_start,
1790                         .cio_fini       = vvp_io_fini,
1791                         .cio_end        = vvp_io_fsync_end,
1792                 },
1793                 [CIT_GLIMPSE] = {
1794                         .cio_fini       = vvp_io_fini
1795                 },
1796                 [CIT_MISC] = {
1797                         .cio_fini       = vvp_io_fini
1798                 },
1799                 [CIT_LADVISE] = {
1800                         .cio_fini       = vvp_io_fini
1801                 },
1802                 [CIT_LSEEK] = {
1803                         .cio_fini      = vvp_io_fini,
1804                         .cio_lock      = vvp_io_lseek_lock,
1805                         .cio_start     = vvp_io_lseek_start,
1806                         .cio_end       = vvp_io_lseek_end,
1807                 },
1808         },
1809         .cio_read_ahead = vvp_io_read_ahead
1810 };
1811
1812 int vvp_io_init(const struct lu_env *env, struct cl_object *obj,
1813                 struct cl_io *io)
1814 {
1815         struct vvp_io      *vio   = vvp_env_io(env);
1816         struct inode       *inode = vvp_object_inode(obj);
1817         int                 result;
1818
1819         CLOBINVRNT(env, obj, vvp_object_invariant(obj));
1820         ENTRY;
1821
1822         CDEBUG(D_VFSTRACE, DFID" ignore/verify layout %d/%d, layout version %d "
1823                "restore needed %d\n",
1824                PFID(lu_object_fid(&obj->co_lu)),
1825                io->ci_ignore_layout, io->ci_verify_layout,
1826                vio->vui_layout_gen, io->ci_restore_needed);
1827
1828         CL_IO_SLICE_CLEAN(vio, vui_cl);
1829         cl_io_slice_add(io, &vio->vui_cl, obj, &vvp_io_ops);
1830         vio->vui_ra_valid = false;
1831         result = 0;
1832         if (io->ci_type == CIT_READ || io->ci_type == CIT_WRITE) {
1833                 size_t count;
1834                 struct ll_inode_info *lli = ll_i2info(inode);
1835
1836                 count = io->u.ci_rw.crw_count;
1837                 /* "If nbyte is 0, read() will return 0 and have no other
1838                  *  results."  -- Single Unix Spec */
1839                 if (count == 0)
1840                         result = 1;
1841                 else
1842                         vio->vui_tot_count = count;
1843
1844                 /* for read/write, we store the process jobid/gid/uid in the
1845                  * inode, and it'll be fetched by osc when building RPC.
1846                  *
1847                  * it's not accurate if the file is shared by different
1848                  * jobs/user/group.
1849                  */
1850                 lustre_get_jobid(lli->lli_jobid, sizeof(lli->lli_jobid));
1851                 lli->lli_uid = from_kuid(&init_user_ns, current_uid());
1852                 lli->lli_gid = from_kgid(&init_user_ns, current_gid());
1853         } else if (io->ci_type == CIT_SETATTR) {
1854                 if (!cl_io_is_trunc(io))
1855                         io->ci_lockreq = CILR_MANDATORY;
1856         }
1857
1858         /* Enqueue layout lock and get layout version. We need to do this
1859          * even for operations requiring to open file, such as read and write,
1860          * because it might not grant layout lock in IT_OPEN. */
1861         if (result == 0 && !io->ci_ignore_layout) {
1862                 result = ll_layout_refresh(inode, &vio->vui_layout_gen);
1863                 if (result == -ENOENT)
1864                         /* If the inode on MDS has been removed, but the objects
1865                          * on OSTs haven't been destroyed (async unlink), layout
1866                          * fetch will return -ENOENT, we'd ingore this error
1867                          * and continue with dirty flush. LU-3230. */
1868                         result = 0;
1869                 if (result < 0)
1870                         CERROR("%s: refresh file layout " DFID " error %d.\n",
1871                                ll_i2sbi(inode)->ll_fsname,
1872                                PFID(lu_object_fid(&obj->co_lu)), result);
1873         }
1874
1875         io->ci_result = result < 0 ? result : 0;
1876         RETURN(result);
1877 }