staging/lustre/llite: Adjust comments to better conform to coding style
[cascardo/linux.git] / drivers / staging / lustre / lustre / llite / vvp_page.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.sun.com/software/products/lustre/docs/GPLv2.pdf
19  *
20  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21  * CA 95054 USA or visit www.sun.com if you need additional information or
22  * have any questions.
23  *
24  * GPL HEADER END
25  */
26 /*
27  * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
28  * Use is subject to license terms.
29  *
30  * Copyright (c) 2011, 2015, Intel Corporation.
31  */
32 /*
33  * This file is part of Lustre, http://www.lustre.org/
34  * Lustre is a trademark of Sun Microsystems, Inc.
35  *
36  * Implementation of cl_page for VVP layer.
37  *
38  *   Author: Nikita Danilov <nikita.danilov@sun.com>
39  *   Author: Jinshan Xiong <jinshan.xiong@whamcloud.com>
40  */
41
42 #define DEBUG_SUBSYSTEM S_LLITE
43
44 #include "../include/obd.h"
45 #include "../include/lustre_lite.h"
46
47 #include "vvp_internal.h"
48
49 /*****************************************************************************
50  *
51  * Page operations.
52  *
53  */
54
55 static void vvp_page_fini_common(struct ccc_page *cp)
56 {
57         struct page *vmpage = cp->cpg_page;
58
59         LASSERT(vmpage);
60         page_cache_release(vmpage);
61 }
62
63 static void vvp_page_fini(const struct lu_env *env,
64                           struct cl_page_slice *slice)
65 {
66         struct ccc_page *cp = cl2ccc_page(slice);
67         struct page *vmpage  = cp->cpg_page;
68
69         /*
70          * vmpage->private was already cleared when page was moved into
71          * VPG_FREEING state.
72          */
73         LASSERT((struct cl_page *)vmpage->private != slice->cpl_page);
74         vvp_page_fini_common(cp);
75 }
76
77 static int vvp_page_own(const struct lu_env *env,
78                         const struct cl_page_slice *slice, struct cl_io *io,
79                         int nonblock)
80 {
81         struct ccc_page *vpg    = cl2ccc_page(slice);
82         struct page      *vmpage = vpg->cpg_page;
83
84         LASSERT(vmpage);
85         if (nonblock) {
86                 if (!trylock_page(vmpage))
87                         return -EAGAIN;
88
89                 if (unlikely(PageWriteback(vmpage))) {
90                         unlock_page(vmpage);
91                         return -EAGAIN;
92                 }
93
94                 return 0;
95         }
96
97         lock_page(vmpage);
98         wait_on_page_writeback(vmpage);
99         return 0;
100 }
101
102 static void vvp_page_assume(const struct lu_env *env,
103                             const struct cl_page_slice *slice,
104                             struct cl_io *unused)
105 {
106         struct page *vmpage = cl2vm_page(slice);
107
108         LASSERT(vmpage);
109         LASSERT(PageLocked(vmpage));
110         wait_on_page_writeback(vmpage);
111 }
112
113 static void vvp_page_unassume(const struct lu_env *env,
114                               const struct cl_page_slice *slice,
115                               struct cl_io *unused)
116 {
117         struct page *vmpage = cl2vm_page(slice);
118
119         LASSERT(vmpage);
120         LASSERT(PageLocked(vmpage));
121 }
122
123 static void vvp_page_disown(const struct lu_env *env,
124                             const struct cl_page_slice *slice, struct cl_io *io)
125 {
126         struct page *vmpage = cl2vm_page(slice);
127
128         LASSERT(vmpage);
129         LASSERT(PageLocked(vmpage));
130
131         unlock_page(cl2vm_page(slice));
132 }
133
134 static void vvp_page_discard(const struct lu_env *env,
135                              const struct cl_page_slice *slice,
136                              struct cl_io *unused)
137 {
138         struct page        *vmpage  = cl2vm_page(slice);
139         struct address_space *mapping;
140         struct ccc_page      *cpg     = cl2ccc_page(slice);
141
142         LASSERT(vmpage);
143         LASSERT(PageLocked(vmpage));
144
145         mapping = vmpage->mapping;
146
147         if (cpg->cpg_defer_uptodate && !cpg->cpg_ra_used)
148                 ll_ra_stats_inc(mapping, RA_STAT_DISCARDED);
149
150         /*
151          * truncate_complete_page() calls
152          * a_ops->invalidatepage()->cl_page_delete()->vvp_page_delete().
153          */
154         truncate_complete_page(mapping, vmpage);
155 }
156
157 static int vvp_page_unmap(const struct lu_env *env,
158                           const struct cl_page_slice *slice,
159                           struct cl_io *unused)
160 {
161         struct page *vmpage = cl2vm_page(slice);
162         __u64       offset;
163
164         LASSERT(vmpage);
165         LASSERT(PageLocked(vmpage));
166
167         offset = vmpage->index << PAGE_CACHE_SHIFT;
168
169         /*
170          * XXX is it safe to call this with the page lock held?
171          */
172         ll_teardown_mmaps(vmpage->mapping, offset, offset + PAGE_CACHE_SIZE);
173         return 0;
174 }
175
176 static void vvp_page_delete(const struct lu_env *env,
177                             const struct cl_page_slice *slice)
178 {
179         struct page       *vmpage = cl2vm_page(slice);
180         struct inode     *inode  = vmpage->mapping->host;
181         struct cl_object *obj    = slice->cpl_obj;
182
183         LASSERT(PageLocked(vmpage));
184         LASSERT((struct cl_page *)vmpage->private == slice->cpl_page);
185         LASSERT(inode == ccc_object_inode(obj));
186
187         vvp_write_complete(cl2ccc(obj), cl2ccc_page(slice));
188         ClearPagePrivate(vmpage);
189         vmpage->private = 0;
190         /*
191          * Reference from vmpage to cl_page is removed, but the reference back
192          * is still here. It is removed later in vvp_page_fini().
193          */
194 }
195
196 static void vvp_page_export(const struct lu_env *env,
197                             const struct cl_page_slice *slice,
198                             int uptodate)
199 {
200         struct page *vmpage = cl2vm_page(slice);
201
202         LASSERT(vmpage);
203         LASSERT(PageLocked(vmpage));
204         if (uptodate)
205                 SetPageUptodate(vmpage);
206         else
207                 ClearPageUptodate(vmpage);
208 }
209
210 static int vvp_page_is_vmlocked(const struct lu_env *env,
211                                 const struct cl_page_slice *slice)
212 {
213         return PageLocked(cl2vm_page(slice)) ? -EBUSY : -ENODATA;
214 }
215
216 static int vvp_page_prep_read(const struct lu_env *env,
217                               const struct cl_page_slice *slice,
218                               struct cl_io *unused)
219 {
220         /* Skip the page already marked as PG_uptodate. */
221         return PageUptodate(cl2vm_page(slice)) ? -EALREADY : 0;
222 }
223
224 static int vvp_page_prep_write(const struct lu_env *env,
225                                const struct cl_page_slice *slice,
226                                struct cl_io *unused)
227 {
228         struct page *vmpage = cl2vm_page(slice);
229         struct cl_page *pg = slice->cpl_page;
230
231         LASSERT(PageLocked(vmpage));
232         LASSERT(!PageDirty(vmpage));
233
234         /* ll_writepage path is not a sync write, so need to set page writeback
235          * flag
236          */
237         if (!pg->cp_sync_io)
238                 set_page_writeback(vmpage);
239
240         vvp_write_pending(cl2ccc(slice->cpl_obj), cl2ccc_page(slice));
241
242         return 0;
243 }
244
245 /**
246  * Handles page transfer errors at VM level.
247  *
248  * This takes inode as a separate argument, because inode on which error is to
249  * be set can be different from \a vmpage inode in case of direct-io.
250  */
251 static void vvp_vmpage_error(struct inode *inode, struct page *vmpage, int ioret)
252 {
253         struct ccc_object *obj = cl_inode2ccc(inode);
254
255         if (ioret == 0) {
256                 ClearPageError(vmpage);
257                 obj->cob_discard_page_warned = 0;
258         } else {
259                 SetPageError(vmpage);
260                 if (ioret == -ENOSPC)
261                         set_bit(AS_ENOSPC, &inode->i_mapping->flags);
262                 else
263                         set_bit(AS_EIO, &inode->i_mapping->flags);
264
265                 if ((ioret == -ESHUTDOWN || ioret == -EINTR) &&
266                      obj->cob_discard_page_warned == 0) {
267                         obj->cob_discard_page_warned = 1;
268                         ll_dirty_page_discard_warn(vmpage, ioret);
269                 }
270         }
271 }
272
273 static void vvp_page_completion_read(const struct lu_env *env,
274                                      const struct cl_page_slice *slice,
275                                      int ioret)
276 {
277         struct ccc_page *cp     = cl2ccc_page(slice);
278         struct page      *vmpage = cp->cpg_page;
279         struct cl_page  *page   = cl_page_top(slice->cpl_page);
280         struct inode    *inode  = ccc_object_inode(page->cp_obj);
281
282         LASSERT(PageLocked(vmpage));
283         CL_PAGE_HEADER(D_PAGE, env, page, "completing READ with %d\n", ioret);
284
285         if (cp->cpg_defer_uptodate)
286                 ll_ra_count_put(ll_i2sbi(inode), 1);
287
288         if (ioret == 0)  {
289                 if (!cp->cpg_defer_uptodate)
290                         cl_page_export(env, page, 1);
291         } else
292                 cp->cpg_defer_uptodate = 0;
293
294         if (!page->cp_sync_io)
295                 unlock_page(vmpage);
296 }
297
298 static void vvp_page_completion_write(const struct lu_env *env,
299                                       const struct cl_page_slice *slice,
300                                       int ioret)
301 {
302         struct ccc_page *cp     = cl2ccc_page(slice);
303         struct cl_page  *pg     = slice->cpl_page;
304         struct page      *vmpage = cp->cpg_page;
305
306         CL_PAGE_HEADER(D_PAGE, env, pg, "completing WRITE with %d\n", ioret);
307
308         /*
309          * TODO: Actually it makes sense to add the page into oap pending
310          * list again and so that we don't need to take the page out from
311          * SoM write pending list, if we just meet a recoverable error,
312          * -ENOMEM, etc.
313          * To implement this, we just need to return a non zero value in
314          * ->cpo_completion method. The underlying transfer should be notified
315          * and then re-add the page into pending transfer queue.  -jay
316          */
317
318         cp->cpg_write_queued = 0;
319         vvp_write_complete(cl2ccc(slice->cpl_obj), cp);
320
321         if (pg->cp_sync_io) {
322                 LASSERT(PageLocked(vmpage));
323                 LASSERT(!PageWriteback(vmpage));
324         } else {
325                 LASSERT(PageWriteback(vmpage));
326                 /*
327                  * Only mark the page error only when it's an async write
328                  * because applications won't wait for IO to finish.
329                  */
330                 vvp_vmpage_error(ccc_object_inode(pg->cp_obj), vmpage, ioret);
331
332                 end_page_writeback(vmpage);
333         }
334 }
335
336 /**
337  * Implements cl_page_operations::cpo_make_ready() method.
338  *
339  * This is called to yank a page from the transfer cache and to send it out as
340  * a part of transfer. This function try-locks the page. If try-lock failed,
341  * page is owned by some concurrent IO, and should be skipped (this is bad,
342  * but hopefully rare situation, as it usually results in transfer being
343  * shorter than possible).
344  *
345  * \retval 0      success, page can be placed into transfer
346  *
347  * \retval -EAGAIN page is either used by concurrent IO has been
348  * truncated. Skip it.
349  */
350 static int vvp_page_make_ready(const struct lu_env *env,
351                                const struct cl_page_slice *slice)
352 {
353         struct page *vmpage = cl2vm_page(slice);
354         struct cl_page *pg = slice->cpl_page;
355         int result = 0;
356
357         lock_page(vmpage);
358         if (clear_page_dirty_for_io(vmpage)) {
359                 LASSERT(pg->cp_state == CPS_CACHED);
360                 /* This actually clears the dirty bit in the radix tree. */
361                 set_page_writeback(vmpage);
362                 vvp_write_pending(cl2ccc(slice->cpl_obj),
363                                 cl2ccc_page(slice));
364                 CL_PAGE_HEADER(D_PAGE, env, pg, "readied\n");
365         } else if (pg->cp_state == CPS_PAGEOUT) {
366                 /* is it possible for osc_flush_async_page() to already
367                  * make it ready?
368                  */
369                 result = -EALREADY;
370         } else {
371                 CL_PAGE_DEBUG(D_ERROR, env, pg, "Unexpecting page state %d.\n",
372                               pg->cp_state);
373                 LBUG();
374         }
375         unlock_page(vmpage);
376         return result;
377 }
378
379 static int vvp_page_print(const struct lu_env *env,
380                           const struct cl_page_slice *slice,
381                           void *cookie, lu_printer_t printer)
382 {
383         struct ccc_page *vp = cl2ccc_page(slice);
384         struct page      *vmpage = vp->cpg_page;
385
386         (*printer)(env, cookie, LUSTRE_VVP_NAME "-page@%p(%d:%d:%d) vm@%p ",
387                    vp, vp->cpg_defer_uptodate, vp->cpg_ra_used,
388                    vp->cpg_write_queued, vmpage);
389         if (vmpage) {
390                 (*printer)(env, cookie, "%lx %d:%d %lx %lu %slru",
391                            (long)vmpage->flags, page_count(vmpage),
392                            page_mapcount(vmpage), vmpage->private,
393                            page_index(vmpage),
394                            list_empty(&vmpage->lru) ? "not-" : "");
395         }
396         (*printer)(env, cookie, "\n");
397         return 0;
398 }
399
400 static const struct cl_page_operations vvp_page_ops = {
401         .cpo_own           = vvp_page_own,
402         .cpo_assume     = vvp_page_assume,
403         .cpo_unassume      = vvp_page_unassume,
404         .cpo_disown     = vvp_page_disown,
405         .cpo_vmpage     = ccc_page_vmpage,
406         .cpo_discard       = vvp_page_discard,
407         .cpo_delete     = vvp_page_delete,
408         .cpo_unmap       = vvp_page_unmap,
409         .cpo_export     = vvp_page_export,
410         .cpo_is_vmlocked   = vvp_page_is_vmlocked,
411         .cpo_fini         = vvp_page_fini,
412         .cpo_print       = vvp_page_print,
413         .cpo_is_under_lock = ccc_page_is_under_lock,
414         .io = {
415                 [CRT_READ] = {
416                         .cpo_prep       = vvp_page_prep_read,
417                         .cpo_completion  = vvp_page_completion_read,
418                         .cpo_make_ready  = ccc_fail,
419                 },
420                 [CRT_WRITE] = {
421                         .cpo_prep       = vvp_page_prep_write,
422                         .cpo_completion  = vvp_page_completion_write,
423                         .cpo_make_ready  = vvp_page_make_ready,
424                 }
425         }
426 };
427
428 static void vvp_transient_page_verify(const struct cl_page *page)
429 {
430         struct inode *inode = ccc_object_inode(page->cp_obj);
431
432         LASSERT(!inode_trylock(inode));
433 }
434
435 static int vvp_transient_page_own(const struct lu_env *env,
436                                   const struct cl_page_slice *slice,
437                                   struct cl_io *unused, int nonblock)
438 {
439         vvp_transient_page_verify(slice->cpl_page);
440         return 0;
441 }
442
443 static void vvp_transient_page_assume(const struct lu_env *env,
444                                       const struct cl_page_slice *slice,
445                                       struct cl_io *unused)
446 {
447         vvp_transient_page_verify(slice->cpl_page);
448 }
449
450 static void vvp_transient_page_unassume(const struct lu_env *env,
451                                         const struct cl_page_slice *slice,
452                                         struct cl_io *unused)
453 {
454         vvp_transient_page_verify(slice->cpl_page);
455 }
456
457 static void vvp_transient_page_disown(const struct lu_env *env,
458                                       const struct cl_page_slice *slice,
459                                       struct cl_io *unused)
460 {
461         vvp_transient_page_verify(slice->cpl_page);
462 }
463
464 static void vvp_transient_page_discard(const struct lu_env *env,
465                                        const struct cl_page_slice *slice,
466                                        struct cl_io *unused)
467 {
468         struct cl_page *page = slice->cpl_page;
469
470         vvp_transient_page_verify(slice->cpl_page);
471
472         /*
473          * For transient pages, remove it from the radix tree.
474          */
475         cl_page_delete(env, page);
476 }
477
478 static int vvp_transient_page_is_vmlocked(const struct lu_env *env,
479                                           const struct cl_page_slice *slice)
480 {
481         struct inode    *inode = ccc_object_inode(slice->cpl_obj);
482         int     locked;
483
484         locked = !inode_trylock(inode);
485         if (!locked)
486                 inode_unlock(inode);
487         return locked ? -EBUSY : -ENODATA;
488 }
489
490 static void
491 vvp_transient_page_completion(const struct lu_env *env,
492                               const struct cl_page_slice *slice,
493                               int ioret)
494 {
495         vvp_transient_page_verify(slice->cpl_page);
496 }
497
498 static void vvp_transient_page_fini(const struct lu_env *env,
499                                     struct cl_page_slice *slice)
500 {
501         struct ccc_page *cp = cl2ccc_page(slice);
502         struct cl_page *clp = slice->cpl_page;
503         struct ccc_object *clobj = cl2ccc(clp->cp_obj);
504
505         vvp_page_fini_common(cp);
506         LASSERT(!inode_trylock(clobj->cob_inode));
507         clobj->cob_transient_pages--;
508 }
509
510 static const struct cl_page_operations vvp_transient_page_ops = {
511         .cpo_own           = vvp_transient_page_own,
512         .cpo_assume     = vvp_transient_page_assume,
513         .cpo_unassume      = vvp_transient_page_unassume,
514         .cpo_disown     = vvp_transient_page_disown,
515         .cpo_discard       = vvp_transient_page_discard,
516         .cpo_vmpage     = ccc_page_vmpage,
517         .cpo_fini         = vvp_transient_page_fini,
518         .cpo_is_vmlocked   = vvp_transient_page_is_vmlocked,
519         .cpo_print       = vvp_page_print,
520         .cpo_is_under_lock = ccc_page_is_under_lock,
521         .io = {
522                 [CRT_READ] = {
523                         .cpo_prep       = ccc_transient_page_prep,
524                         .cpo_completion  = vvp_transient_page_completion,
525                 },
526                 [CRT_WRITE] = {
527                         .cpo_prep       = ccc_transient_page_prep,
528                         .cpo_completion  = vvp_transient_page_completion,
529                 }
530         }
531 };
532
533 int vvp_page_init(const struct lu_env *env, struct cl_object *obj,
534                 struct cl_page *page, struct page *vmpage)
535 {
536         struct ccc_page *cpg = cl_object_page_slice(obj, page);
537
538         CLOBINVRNT(env, obj, ccc_object_invariant(obj));
539
540         cpg->cpg_page = vmpage;
541         page_cache_get(vmpage);
542
543         INIT_LIST_HEAD(&cpg->cpg_pending_linkage);
544         if (page->cp_type == CPT_CACHEABLE) {
545                 SetPagePrivate(vmpage);
546                 vmpage->private = (unsigned long)page;
547                 cl_page_slice_add(page, &cpg->cpg_cl, obj,
548                                 &vvp_page_ops);
549         } else {
550                 struct ccc_object *clobj = cl2ccc(obj);
551
552                 LASSERT(!inode_trylock(clobj->cob_inode));
553                 cl_page_slice_add(page, &cpg->cpg_cl, obj,
554                                 &vvp_transient_page_ops);
555                 clobj->cob_transient_pages++;
556         }
557         return 0;
558 }