hc
2023-12-08 01573e231f18eb2d99162747186f59511f56b64d
kernel/include/linux/fscache.h
....@@ -1,16 +1,12 @@
1
+/* SPDX-License-Identifier: GPL-2.0-or-later */
12 /* General filesystem caching interface
23 *
34 * Copyright (C) 2004-2007 Red Hat, Inc. All Rights Reserved.
45 * Written by David Howells (dhowells@redhat.com)
56 *
6
- * This program is free software; you can redistribute it and/or
7
- * modify it under the terms of the GNU General Public License
8
- * as published by the Free Software Foundation; either version
9
- * 2 of the License, or (at your option) any later version.
10
- *
117 * NOTE!!! See:
128 *
13
- * Documentation/filesystems/caching/netfs-api.txt
9
+ * Documentation/filesystems/caching/netfs-api.rst
1410 *
1511 * for a description of the network filesystem interface declared here.
1612 */
....@@ -237,7 +233,7 @@
237233 *
238234 * Register a filesystem as desiring caching services if they're available.
239235 *
240
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
236
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
241237 * description.
242238 */
243239 static inline
....@@ -257,7 +253,7 @@
257253 * Indicate that a filesystem no longer desires caching services for the
258254 * moment.
259255 *
260
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
256
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
261257 * description.
262258 */
263259 static inline
....@@ -274,7 +270,7 @@
274270 * Acquire a specific cache referral tag that can be used to select a specific
275271 * cache in which to cache an index.
276272 *
277
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
273
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
278274 * description.
279275 */
280276 static inline
....@@ -292,7 +288,7 @@
292288 *
293289 * Release a reference to a cache referral tag previously looked up.
294290 *
295
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
291
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
296292 * description.
297293 */
298294 static inline
....@@ -319,7 +315,7 @@
319315 * that can be used to locate files. This is done by requesting a cookie for
320316 * each index in the path to the file.
321317 *
322
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
318
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
323319 * description.
324320 */
325321 static inline
....@@ -355,7 +351,7 @@
355351 * provided to update the auxiliary data in the cache before the object is
356352 * disconnected.
357353 *
358
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
354
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
359355 * description.
360356 */
361357 static inline
....@@ -398,7 +394,7 @@
398394 * cookie. The auxiliary data on the cookie will be updated first if @aux_data
399395 * is set.
400396 *
401
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
397
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
402398 * description.
403399 */
404400 static inline
....@@ -414,7 +410,7 @@
414410 *
415411 * Permit data-storage cache objects to be pinned in the cache.
416412 *
417
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
413
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
418414 * description.
419415 */
420416 static inline
....@@ -429,7 +425,7 @@
429425 *
430426 * Permit data-storage cache objects to be unpinned from the cache.
431427 *
432
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
428
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
433429 * description.
434430 */
435431 static inline
....@@ -445,7 +441,7 @@
445441 * changed. This includes the data size. These attributes will be obtained
446442 * through the get_attr() cookie definition op.
447443 *
448
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
444
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
449445 * description.
450446 */
451447 static inline
....@@ -467,7 +463,7 @@
467463 *
468464 * This can be called with spinlocks held.
469465 *
470
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
466
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
471467 * description.
472468 */
473469 static inline
....@@ -483,7 +479,7 @@
483479 *
484480 * Wait for the invalidation of an object to complete.
485481 *
486
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
482
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
487483 * description.
488484 */
489485 static inline
....@@ -502,7 +498,7 @@
502498 * cookie so that a write to that object within the space can always be
503499 * honoured.
504500 *
505
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
501
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
506502 * description.
507503 */
508504 static inline
....@@ -537,7 +533,7 @@
537533 * Else, if the page is unbacked, -ENODATA is returned and a block may have
538534 * been allocated in the cache.
539535 *
540
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
536
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
541537 * description.
542538 */
543539 static inline
....@@ -586,7 +582,7 @@
586582 * regard to different pages, the return values are prioritised in that order.
587583 * Any pages submitted for reading are removed from the pages list.
588584 *
589
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
585
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
590586 * description.
591587 */
592588 static inline
....@@ -621,7 +617,7 @@
621617 * Else, a block will be allocated if one wasn't already, and 0 will be
622618 * returned
623619 *
624
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
620
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
625621 * description.
626622 */
627623 static inline
....@@ -671,7 +667,7 @@
671667 * be cleared at the completion of the write to indicate the success or failure
672668 * of the operation. Note that the completion may happen before the return.
673669 *
674
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
670
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
675671 * description.
676672 */
677673 static inline
....@@ -697,7 +693,7 @@
697693 * Note that this cannot cancel any outstanding I/O operations between this
698694 * page and the cache.
699695 *
700
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
696
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
701697 * description.
702698 */
703699 static inline
....@@ -715,7 +711,7 @@
715711 *
716712 * Ask the cache if a page is being written to the cache.
717713 *
718
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
714
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
719715 * description.
720716 */
721717 static inline
....@@ -735,7 +731,7 @@
735731 * Ask the cache to wake us up when a page is no longer being written to the
736732 * cache.
737733 *
738
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
734
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
739735 * description.
740736 */
741737 static inline