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 */
....@@ -230,7 +226,6 @@
230226 extern void __fscache_disable_cookie(struct fscache_cookie *, const void *, bool);
231227 extern void __fscache_enable_cookie(struct fscache_cookie *, const void *, loff_t,
232228 bool (*)(void *), void *);
233
-extern void fscache_cookie_init(void);
234229
235230 /**
236231 * fscache_register_netfs - Register a filesystem as desiring caching services
....@@ -238,7 +233,7 @@
238233 *
239234 * Register a filesystem as desiring caching services if they're available.
240235 *
241
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
236
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
242237 * description.
243238 */
244239 static inline
....@@ -258,7 +253,7 @@
258253 * Indicate that a filesystem no longer desires caching services for the
259254 * moment.
260255 *
261
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
256
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
262257 * description.
263258 */
264259 static inline
....@@ -275,7 +270,7 @@
275270 * Acquire a specific cache referral tag that can be used to select a specific
276271 * cache in which to cache an index.
277272 *
278
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
273
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
279274 * description.
280275 */
281276 static inline
....@@ -293,7 +288,7 @@
293288 *
294289 * Release a reference to a cache referral tag previously looked up.
295290 *
296
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
291
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
297292 * description.
298293 */
299294 static inline
....@@ -320,7 +315,7 @@
320315 * that can be used to locate files. This is done by requesting a cookie for
321316 * each index in the path to the file.
322317 *
323
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
318
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
324319 * description.
325320 */
326321 static inline
....@@ -356,7 +351,7 @@
356351 * provided to update the auxiliary data in the cache before the object is
357352 * disconnected.
358353 *
359
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
354
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
360355 * description.
361356 */
362357 static inline
....@@ -399,7 +394,7 @@
399394 * cookie. The auxiliary data on the cookie will be updated first if @aux_data
400395 * is set.
401396 *
402
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
397
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
403398 * description.
404399 */
405400 static inline
....@@ -415,7 +410,7 @@
415410 *
416411 * Permit data-storage cache objects to be pinned in the cache.
417412 *
418
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
413
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
419414 * description.
420415 */
421416 static inline
....@@ -430,7 +425,7 @@
430425 *
431426 * Permit data-storage cache objects to be unpinned from the cache.
432427 *
433
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
428
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
434429 * description.
435430 */
436431 static inline
....@@ -446,7 +441,7 @@
446441 * changed. This includes the data size. These attributes will be obtained
447442 * through the get_attr() cookie definition op.
448443 *
449
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
444
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
450445 * description.
451446 */
452447 static inline
....@@ -468,7 +463,7 @@
468463 *
469464 * This can be called with spinlocks held.
470465 *
471
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
466
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
472467 * description.
473468 */
474469 static inline
....@@ -484,7 +479,7 @@
484479 *
485480 * Wait for the invalidation of an object to complete.
486481 *
487
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
482
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
488483 * description.
489484 */
490485 static inline
....@@ -503,7 +498,7 @@
503498 * cookie so that a write to that object within the space can always be
504499 * honoured.
505500 *
506
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
501
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
507502 * description.
508503 */
509504 static inline
....@@ -538,7 +533,7 @@
538533 * Else, if the page is unbacked, -ENODATA is returned and a block may have
539534 * been allocated in the cache.
540535 *
541
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
536
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
542537 * description.
543538 */
544539 static inline
....@@ -587,7 +582,7 @@
587582 * regard to different pages, the return values are prioritised in that order.
588583 * Any pages submitted for reading are removed from the pages list.
589584 *
590
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
585
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
591586 * description.
592587 */
593588 static inline
....@@ -622,7 +617,7 @@
622617 * Else, a block will be allocated if one wasn't already, and 0 will be
623618 * returned
624619 *
625
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
620
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
626621 * description.
627622 */
628623 static inline
....@@ -672,7 +667,7 @@
672667 * be cleared at the completion of the write to indicate the success or failure
673668 * of the operation. Note that the completion may happen before the return.
674669 *
675
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
670
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
676671 * description.
677672 */
678673 static inline
....@@ -698,7 +693,7 @@
698693 * Note that this cannot cancel any outstanding I/O operations between this
699694 * page and the cache.
700695 *
701
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
696
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
702697 * description.
703698 */
704699 static inline
....@@ -716,7 +711,7 @@
716711 *
717712 * Ask the cache if a page is being written to the cache.
718713 *
719
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
714
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
720715 * description.
721716 */
722717 static inline
....@@ -736,7 +731,7 @@
736731 * Ask the cache to wake us up when a page is no longer being written to the
737732 * cache.
738733 *
739
- * See Documentation/filesystems/caching/netfs-api.txt for a complete
734
+ * See Documentation/filesystems/caching/netfs-api.rst for a complete
740735 * description.
741736 */
742737 static inline