1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-or-later
2*4882a593Smuzhiyun /* General filesystem local caching manager
3*4882a593Smuzhiyun *
4*4882a593Smuzhiyun * Copyright (C) 2004-2007 Red Hat, Inc. All Rights Reserved.
5*4882a593Smuzhiyun * Written by David Howells (dhowells@redhat.com)
6*4882a593Smuzhiyun */
7*4882a593Smuzhiyun
8*4882a593Smuzhiyun #define FSCACHE_DEBUG_LEVEL CACHE
9*4882a593Smuzhiyun #include <linux/module.h>
10*4882a593Smuzhiyun #include <linux/init.h>
11*4882a593Smuzhiyun #include <linux/sched.h>
12*4882a593Smuzhiyun #include <linux/completion.h>
13*4882a593Smuzhiyun #include <linux/slab.h>
14*4882a593Smuzhiyun #include <linux/seq_file.h>
15*4882a593Smuzhiyun #define CREATE_TRACE_POINTS
16*4882a593Smuzhiyun #include "internal.h"
17*4882a593Smuzhiyun
18*4882a593Smuzhiyun MODULE_DESCRIPTION("FS Cache Manager");
19*4882a593Smuzhiyun MODULE_AUTHOR("Red Hat, Inc.");
20*4882a593Smuzhiyun MODULE_LICENSE("GPL");
21*4882a593Smuzhiyun
22*4882a593Smuzhiyun unsigned fscache_defer_lookup = 1;
23*4882a593Smuzhiyun module_param_named(defer_lookup, fscache_defer_lookup, uint,
24*4882a593Smuzhiyun S_IWUSR | S_IRUGO);
25*4882a593Smuzhiyun MODULE_PARM_DESC(fscache_defer_lookup,
26*4882a593Smuzhiyun "Defer cookie lookup to background thread");
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun unsigned fscache_defer_create = 1;
29*4882a593Smuzhiyun module_param_named(defer_create, fscache_defer_create, uint,
30*4882a593Smuzhiyun S_IWUSR | S_IRUGO);
31*4882a593Smuzhiyun MODULE_PARM_DESC(fscache_defer_create,
32*4882a593Smuzhiyun "Defer cookie creation to background thread");
33*4882a593Smuzhiyun
34*4882a593Smuzhiyun unsigned fscache_debug;
35*4882a593Smuzhiyun module_param_named(debug, fscache_debug, uint,
36*4882a593Smuzhiyun S_IWUSR | S_IRUGO);
37*4882a593Smuzhiyun MODULE_PARM_DESC(fscache_debug,
38*4882a593Smuzhiyun "FS-Cache debugging mask");
39*4882a593Smuzhiyun
40*4882a593Smuzhiyun struct kobject *fscache_root;
41*4882a593Smuzhiyun struct workqueue_struct *fscache_object_wq;
42*4882a593Smuzhiyun struct workqueue_struct *fscache_op_wq;
43*4882a593Smuzhiyun
44*4882a593Smuzhiyun DEFINE_PER_CPU(wait_queue_head_t, fscache_object_cong_wait);
45*4882a593Smuzhiyun
46*4882a593Smuzhiyun /* these values serve as lower bounds, will be adjusted in fscache_init() */
47*4882a593Smuzhiyun static unsigned fscache_object_max_active = 4;
48*4882a593Smuzhiyun static unsigned fscache_op_max_active = 2;
49*4882a593Smuzhiyun
50*4882a593Smuzhiyun #ifdef CONFIG_SYSCTL
51*4882a593Smuzhiyun static struct ctl_table_header *fscache_sysctl_header;
52*4882a593Smuzhiyun
fscache_max_active_sysctl(struct ctl_table * table,int write,void * buffer,size_t * lenp,loff_t * ppos)53*4882a593Smuzhiyun static int fscache_max_active_sysctl(struct ctl_table *table, int write,
54*4882a593Smuzhiyun void *buffer, size_t *lenp, loff_t *ppos)
55*4882a593Smuzhiyun {
56*4882a593Smuzhiyun struct workqueue_struct **wqp = table->extra1;
57*4882a593Smuzhiyun unsigned int *datap = table->data;
58*4882a593Smuzhiyun int ret;
59*4882a593Smuzhiyun
60*4882a593Smuzhiyun ret = proc_dointvec(table, write, buffer, lenp, ppos);
61*4882a593Smuzhiyun if (ret == 0)
62*4882a593Smuzhiyun workqueue_set_max_active(*wqp, *datap);
63*4882a593Smuzhiyun return ret;
64*4882a593Smuzhiyun }
65*4882a593Smuzhiyun
66*4882a593Smuzhiyun static struct ctl_table fscache_sysctls[] = {
67*4882a593Smuzhiyun {
68*4882a593Smuzhiyun .procname = "object_max_active",
69*4882a593Smuzhiyun .data = &fscache_object_max_active,
70*4882a593Smuzhiyun .maxlen = sizeof(unsigned),
71*4882a593Smuzhiyun .mode = 0644,
72*4882a593Smuzhiyun .proc_handler = fscache_max_active_sysctl,
73*4882a593Smuzhiyun .extra1 = &fscache_object_wq,
74*4882a593Smuzhiyun },
75*4882a593Smuzhiyun {
76*4882a593Smuzhiyun .procname = "operation_max_active",
77*4882a593Smuzhiyun .data = &fscache_op_max_active,
78*4882a593Smuzhiyun .maxlen = sizeof(unsigned),
79*4882a593Smuzhiyun .mode = 0644,
80*4882a593Smuzhiyun .proc_handler = fscache_max_active_sysctl,
81*4882a593Smuzhiyun .extra1 = &fscache_op_wq,
82*4882a593Smuzhiyun },
83*4882a593Smuzhiyun {}
84*4882a593Smuzhiyun };
85*4882a593Smuzhiyun
86*4882a593Smuzhiyun static struct ctl_table fscache_sysctls_root[] = {
87*4882a593Smuzhiyun {
88*4882a593Smuzhiyun .procname = "fscache",
89*4882a593Smuzhiyun .mode = 0555,
90*4882a593Smuzhiyun .child = fscache_sysctls,
91*4882a593Smuzhiyun },
92*4882a593Smuzhiyun {}
93*4882a593Smuzhiyun };
94*4882a593Smuzhiyun #endif
95*4882a593Smuzhiyun
96*4882a593Smuzhiyun /*
97*4882a593Smuzhiyun * Mixing scores (in bits) for (7,20):
98*4882a593Smuzhiyun * Input delta: 1-bit 2-bit
99*4882a593Smuzhiyun * 1 round: 330.3 9201.6
100*4882a593Smuzhiyun * 2 rounds: 1246.4 25475.4
101*4882a593Smuzhiyun * 3 rounds: 1907.1 31295.1
102*4882a593Smuzhiyun * 4 rounds: 2042.3 31718.6
103*4882a593Smuzhiyun * Perfect: 2048 31744
104*4882a593Smuzhiyun * (32*64) (32*31/2 * 64)
105*4882a593Smuzhiyun */
106*4882a593Smuzhiyun #define HASH_MIX(x, y, a) \
107*4882a593Smuzhiyun ( x ^= (a), \
108*4882a593Smuzhiyun y ^= x, x = rol32(x, 7),\
109*4882a593Smuzhiyun x += y, y = rol32(y,20),\
110*4882a593Smuzhiyun y *= 9 )
111*4882a593Smuzhiyun
fold_hash(unsigned long x,unsigned long y)112*4882a593Smuzhiyun static inline unsigned int fold_hash(unsigned long x, unsigned long y)
113*4882a593Smuzhiyun {
114*4882a593Smuzhiyun /* Use arch-optimized multiply if one exists */
115*4882a593Smuzhiyun return __hash_32(y ^ __hash_32(x));
116*4882a593Smuzhiyun }
117*4882a593Smuzhiyun
118*4882a593Smuzhiyun /*
119*4882a593Smuzhiyun * Generate a hash. This is derived from full_name_hash(), but we want to be
120*4882a593Smuzhiyun * sure it is arch independent and that it doesn't change as bits of the
121*4882a593Smuzhiyun * computed hash value might appear on disk. The caller also guarantees that
122*4882a593Smuzhiyun * the hashed data will be a series of aligned 32-bit words.
123*4882a593Smuzhiyun */
fscache_hash(unsigned int salt,unsigned int * data,unsigned int n)124*4882a593Smuzhiyun unsigned int fscache_hash(unsigned int salt, unsigned int *data, unsigned int n)
125*4882a593Smuzhiyun {
126*4882a593Smuzhiyun unsigned int a, x = 0, y = salt;
127*4882a593Smuzhiyun
128*4882a593Smuzhiyun for (; n; n--) {
129*4882a593Smuzhiyun a = *data++;
130*4882a593Smuzhiyun HASH_MIX(x, y, a);
131*4882a593Smuzhiyun }
132*4882a593Smuzhiyun return fold_hash(x, y);
133*4882a593Smuzhiyun }
134*4882a593Smuzhiyun
135*4882a593Smuzhiyun /*
136*4882a593Smuzhiyun * initialise the fs caching module
137*4882a593Smuzhiyun */
fscache_init(void)138*4882a593Smuzhiyun static int __init fscache_init(void)
139*4882a593Smuzhiyun {
140*4882a593Smuzhiyun unsigned int nr_cpus = num_possible_cpus();
141*4882a593Smuzhiyun unsigned int cpu;
142*4882a593Smuzhiyun int ret;
143*4882a593Smuzhiyun
144*4882a593Smuzhiyun fscache_object_max_active =
145*4882a593Smuzhiyun clamp_val(nr_cpus,
146*4882a593Smuzhiyun fscache_object_max_active, WQ_UNBOUND_MAX_ACTIVE);
147*4882a593Smuzhiyun
148*4882a593Smuzhiyun ret = -ENOMEM;
149*4882a593Smuzhiyun fscache_object_wq = alloc_workqueue("fscache_object", WQ_UNBOUND,
150*4882a593Smuzhiyun fscache_object_max_active);
151*4882a593Smuzhiyun if (!fscache_object_wq)
152*4882a593Smuzhiyun goto error_object_wq;
153*4882a593Smuzhiyun
154*4882a593Smuzhiyun fscache_op_max_active =
155*4882a593Smuzhiyun clamp_val(fscache_object_max_active / 2,
156*4882a593Smuzhiyun fscache_op_max_active, WQ_UNBOUND_MAX_ACTIVE);
157*4882a593Smuzhiyun
158*4882a593Smuzhiyun ret = -ENOMEM;
159*4882a593Smuzhiyun fscache_op_wq = alloc_workqueue("fscache_operation", WQ_UNBOUND,
160*4882a593Smuzhiyun fscache_op_max_active);
161*4882a593Smuzhiyun if (!fscache_op_wq)
162*4882a593Smuzhiyun goto error_op_wq;
163*4882a593Smuzhiyun
164*4882a593Smuzhiyun for_each_possible_cpu(cpu)
165*4882a593Smuzhiyun init_waitqueue_head(&per_cpu(fscache_object_cong_wait, cpu));
166*4882a593Smuzhiyun
167*4882a593Smuzhiyun ret = fscache_proc_init();
168*4882a593Smuzhiyun if (ret < 0)
169*4882a593Smuzhiyun goto error_proc;
170*4882a593Smuzhiyun
171*4882a593Smuzhiyun #ifdef CONFIG_SYSCTL
172*4882a593Smuzhiyun ret = -ENOMEM;
173*4882a593Smuzhiyun fscache_sysctl_header = register_sysctl_table(fscache_sysctls_root);
174*4882a593Smuzhiyun if (!fscache_sysctl_header)
175*4882a593Smuzhiyun goto error_sysctl;
176*4882a593Smuzhiyun #endif
177*4882a593Smuzhiyun
178*4882a593Smuzhiyun fscache_cookie_jar = kmem_cache_create("fscache_cookie_jar",
179*4882a593Smuzhiyun sizeof(struct fscache_cookie),
180*4882a593Smuzhiyun 0, 0, NULL);
181*4882a593Smuzhiyun if (!fscache_cookie_jar) {
182*4882a593Smuzhiyun pr_notice("Failed to allocate a cookie jar\n");
183*4882a593Smuzhiyun ret = -ENOMEM;
184*4882a593Smuzhiyun goto error_cookie_jar;
185*4882a593Smuzhiyun }
186*4882a593Smuzhiyun
187*4882a593Smuzhiyun fscache_root = kobject_create_and_add("fscache", kernel_kobj);
188*4882a593Smuzhiyun if (!fscache_root)
189*4882a593Smuzhiyun goto error_kobj;
190*4882a593Smuzhiyun
191*4882a593Smuzhiyun pr_notice("Loaded\n");
192*4882a593Smuzhiyun return 0;
193*4882a593Smuzhiyun
194*4882a593Smuzhiyun error_kobj:
195*4882a593Smuzhiyun kmem_cache_destroy(fscache_cookie_jar);
196*4882a593Smuzhiyun error_cookie_jar:
197*4882a593Smuzhiyun #ifdef CONFIG_SYSCTL
198*4882a593Smuzhiyun unregister_sysctl_table(fscache_sysctl_header);
199*4882a593Smuzhiyun error_sysctl:
200*4882a593Smuzhiyun #endif
201*4882a593Smuzhiyun fscache_proc_cleanup();
202*4882a593Smuzhiyun error_proc:
203*4882a593Smuzhiyun destroy_workqueue(fscache_op_wq);
204*4882a593Smuzhiyun error_op_wq:
205*4882a593Smuzhiyun destroy_workqueue(fscache_object_wq);
206*4882a593Smuzhiyun error_object_wq:
207*4882a593Smuzhiyun return ret;
208*4882a593Smuzhiyun }
209*4882a593Smuzhiyun
210*4882a593Smuzhiyun fs_initcall(fscache_init);
211*4882a593Smuzhiyun
212*4882a593Smuzhiyun /*
213*4882a593Smuzhiyun * clean up on module removal
214*4882a593Smuzhiyun */
fscache_exit(void)215*4882a593Smuzhiyun static void __exit fscache_exit(void)
216*4882a593Smuzhiyun {
217*4882a593Smuzhiyun _enter("");
218*4882a593Smuzhiyun
219*4882a593Smuzhiyun kobject_put(fscache_root);
220*4882a593Smuzhiyun kmem_cache_destroy(fscache_cookie_jar);
221*4882a593Smuzhiyun #ifdef CONFIG_SYSCTL
222*4882a593Smuzhiyun unregister_sysctl_table(fscache_sysctl_header);
223*4882a593Smuzhiyun #endif
224*4882a593Smuzhiyun fscache_proc_cleanup();
225*4882a593Smuzhiyun destroy_workqueue(fscache_op_wq);
226*4882a593Smuzhiyun destroy_workqueue(fscache_object_wq);
227*4882a593Smuzhiyun pr_notice("Unloaded\n");
228*4882a593Smuzhiyun }
229*4882a593Smuzhiyun
230*4882a593Smuzhiyun module_exit(fscache_exit);
231