2 * linux/net/sunrpc/auth.c
4 * Generic RPC client authentication API.
6 * Copyright (C) 1996, Olaf Kirch <okir@monad.swb.de>
9 #include <linux/types.h>
10 #include <linux/sched.h>
11 #include <linux/module.h>
12 #include <linux/slab.h>
13 #include <linux/errno.h>
14 #include <linux/hash.h>
15 #include <linux/sunrpc/clnt.h>
16 #include <linux/spinlock.h>
19 # define RPCDBG_FACILITY RPCDBG_AUTH
22 static DEFINE_SPINLOCK(rpc_authflavor_lock
);
23 static const struct rpc_authops
*auth_flavors
[RPC_AUTH_MAXFLAVOR
] = {
24 &authnull_ops
, /* AUTH_NULL */
25 &authunix_ops
, /* AUTH_UNIX */
26 NULL
, /* others can be loadable modules */
29 static LIST_HEAD(cred_unused
);
30 static unsigned long number_cred_unused
;
33 pseudoflavor_to_flavor(u32 flavor
) {
34 if (flavor
>= RPC_AUTH_MAXFLAVOR
)
40 rpcauth_register(const struct rpc_authops
*ops
)
42 rpc_authflavor_t flavor
;
45 if ((flavor
= ops
->au_flavor
) >= RPC_AUTH_MAXFLAVOR
)
47 spin_lock(&rpc_authflavor_lock
);
48 if (auth_flavors
[flavor
] == NULL
) {
49 auth_flavors
[flavor
] = ops
;
52 spin_unlock(&rpc_authflavor_lock
);
55 EXPORT_SYMBOL_GPL(rpcauth_register
);
58 rpcauth_unregister(const struct rpc_authops
*ops
)
60 rpc_authflavor_t flavor
;
63 if ((flavor
= ops
->au_flavor
) >= RPC_AUTH_MAXFLAVOR
)
65 spin_lock(&rpc_authflavor_lock
);
66 if (auth_flavors
[flavor
] == ops
) {
67 auth_flavors
[flavor
] = NULL
;
70 spin_unlock(&rpc_authflavor_lock
);
73 EXPORT_SYMBOL_GPL(rpcauth_unregister
);
76 rpcauth_create(rpc_authflavor_t pseudoflavor
, struct rpc_clnt
*clnt
)
78 struct rpc_auth
*auth
;
79 const struct rpc_authops
*ops
;
80 u32 flavor
= pseudoflavor_to_flavor(pseudoflavor
);
82 auth
= ERR_PTR(-EINVAL
);
83 if (flavor
>= RPC_AUTH_MAXFLAVOR
)
86 if ((ops
= auth_flavors
[flavor
]) == NULL
)
87 request_module("rpc-auth-%u", flavor
);
88 spin_lock(&rpc_authflavor_lock
);
89 ops
= auth_flavors
[flavor
];
90 if (ops
== NULL
|| !try_module_get(ops
->owner
)) {
91 spin_unlock(&rpc_authflavor_lock
);
94 spin_unlock(&rpc_authflavor_lock
);
95 auth
= ops
->create(clnt
, pseudoflavor
);
96 module_put(ops
->owner
);
100 rpcauth_release(clnt
->cl_auth
);
101 clnt
->cl_auth
= auth
;
106 EXPORT_SYMBOL_GPL(rpcauth_create
);
109 rpcauth_release(struct rpc_auth
*auth
)
111 if (!atomic_dec_and_test(&auth
->au_count
))
113 auth
->au_ops
->destroy(auth
);
116 static DEFINE_SPINLOCK(rpc_credcache_lock
);
119 rpcauth_unhash_cred_locked(struct rpc_cred
*cred
)
121 hlist_del_rcu(&cred
->cr_hash
);
122 smp_mb__before_clear_bit();
123 clear_bit(RPCAUTH_CRED_HASHED
, &cred
->cr_flags
);
127 rpcauth_unhash_cred(struct rpc_cred
*cred
)
129 spinlock_t
*cache_lock
;
132 cache_lock
= &cred
->cr_auth
->au_credcache
->lock
;
133 spin_lock(cache_lock
);
134 ret
= atomic_read(&cred
->cr_count
) == 0;
136 rpcauth_unhash_cred_locked(cred
);
137 spin_unlock(cache_lock
);
142 * Initialize RPC credential cache
145 rpcauth_init_credcache(struct rpc_auth
*auth
)
147 struct rpc_cred_cache
*new;
150 new = kmalloc(sizeof(*new), GFP_KERNEL
);
153 for (i
= 0; i
< RPC_CREDCACHE_NR
; i
++)
154 INIT_HLIST_HEAD(&new->hashtable
[i
]);
155 spin_lock_init(&new->lock
);
156 auth
->au_credcache
= new;
159 EXPORT_SYMBOL_GPL(rpcauth_init_credcache
);
162 * Destroy a list of credentials
165 void rpcauth_destroy_credlist(struct list_head
*head
)
167 struct rpc_cred
*cred
;
169 while (!list_empty(head
)) {
170 cred
= list_entry(head
->next
, struct rpc_cred
, cr_lru
);
171 list_del_init(&cred
->cr_lru
);
177 * Clear the RPC credential cache, and delete those credentials
178 * that are not referenced.
181 rpcauth_clear_credcache(struct rpc_cred_cache
*cache
)
184 struct hlist_head
*head
;
185 struct rpc_cred
*cred
;
188 spin_lock(&rpc_credcache_lock
);
189 spin_lock(&cache
->lock
);
190 for (i
= 0; i
< RPC_CREDCACHE_NR
; i
++) {
191 head
= &cache
->hashtable
[i
];
192 while (!hlist_empty(head
)) {
193 cred
= hlist_entry(head
->first
, struct rpc_cred
, cr_hash
);
195 if (!list_empty(&cred
->cr_lru
)) {
196 list_del(&cred
->cr_lru
);
197 number_cred_unused
--;
199 list_add_tail(&cred
->cr_lru
, &free
);
200 rpcauth_unhash_cred_locked(cred
);
203 spin_unlock(&cache
->lock
);
204 spin_unlock(&rpc_credcache_lock
);
205 rpcauth_destroy_credlist(&free
);
209 * Destroy the RPC credential cache
212 rpcauth_destroy_credcache(struct rpc_auth
*auth
)
214 struct rpc_cred_cache
*cache
= auth
->au_credcache
;
217 auth
->au_credcache
= NULL
;
218 rpcauth_clear_credcache(cache
);
222 EXPORT_SYMBOL_GPL(rpcauth_destroy_credcache
);
225 #define RPC_AUTH_EXPIRY_MORATORIUM (60 * HZ)
228 * Remove stale credentials. Avoid sleeping inside the loop.
231 rpcauth_prune_expired(struct list_head
*free
, int nr_to_scan
)
233 spinlock_t
*cache_lock
;
234 struct rpc_cred
*cred
, *next
;
235 unsigned long expired
= jiffies
- RPC_AUTH_EXPIRY_MORATORIUM
;
237 list_for_each_entry_safe(cred
, next
, &cred_unused
, cr_lru
) {
239 if (nr_to_scan
-- == 0)
242 * Enforce a 60 second garbage collection moratorium
243 * Note that the cred_unused list must be time-ordered.
245 if (time_in_range(cred
->cr_expire
, expired
, jiffies
) &&
246 test_bit(RPCAUTH_CRED_HASHED
, &cred
->cr_flags
) != 0)
249 list_del_init(&cred
->cr_lru
);
250 number_cred_unused
--;
251 if (atomic_read(&cred
->cr_count
) != 0)
254 cache_lock
= &cred
->cr_auth
->au_credcache
->lock
;
255 spin_lock(cache_lock
);
256 if (atomic_read(&cred
->cr_count
) == 0) {
258 list_add_tail(&cred
->cr_lru
, free
);
259 rpcauth_unhash_cred_locked(cred
);
261 spin_unlock(cache_lock
);
263 return (number_cred_unused
/ 100) * sysctl_vfs_cache_pressure
;
267 * Run memory cache shrinker.
270 rpcauth_cache_shrinker(int nr_to_scan
, gfp_t gfp_mask
)
275 if ((gfp_mask
& GFP_KERNEL
) != GFP_KERNEL
)
276 return (nr_to_scan
== 0) ? 0 : -1;
277 if (list_empty(&cred_unused
))
279 spin_lock(&rpc_credcache_lock
);
280 res
= rpcauth_prune_expired(&free
, nr_to_scan
);
281 spin_unlock(&rpc_credcache_lock
);
282 rpcauth_destroy_credlist(&free
);
287 * Look up a process' credentials in the authentication cache
290 rpcauth_lookup_credcache(struct rpc_auth
*auth
, struct auth_cred
* acred
,
294 struct rpc_cred_cache
*cache
= auth
->au_credcache
;
295 struct hlist_node
*pos
;
296 struct rpc_cred
*cred
= NULL
,
300 nr
= hash_long(acred
->uid
, RPC_CREDCACHE_HASHBITS
);
303 hlist_for_each_entry_rcu(entry
, pos
, &cache
->hashtable
[nr
], cr_hash
) {
304 if (!entry
->cr_ops
->crmatch(acred
, entry
, flags
))
306 spin_lock(&cache
->lock
);
307 if (test_bit(RPCAUTH_CRED_HASHED
, &entry
->cr_flags
) == 0) {
308 spin_unlock(&cache
->lock
);
311 cred
= get_rpccred(entry
);
312 spin_unlock(&cache
->lock
);
320 new = auth
->au_ops
->crcreate(auth
, acred
, flags
);
326 spin_lock(&cache
->lock
);
327 hlist_for_each_entry(entry
, pos
, &cache
->hashtable
[nr
], cr_hash
) {
328 if (!entry
->cr_ops
->crmatch(acred
, entry
, flags
))
330 cred
= get_rpccred(entry
);
335 set_bit(RPCAUTH_CRED_HASHED
, &cred
->cr_flags
);
336 hlist_add_head_rcu(&cred
->cr_hash
, &cache
->hashtable
[nr
]);
338 list_add_tail(&new->cr_lru
, &free
);
339 spin_unlock(&cache
->lock
);
341 if (test_bit(RPCAUTH_CRED_NEW
, &cred
->cr_flags
) &&
342 cred
->cr_ops
->cr_init
!= NULL
&&
343 !(flags
& RPCAUTH_LOOKUP_NEW
)) {
344 int res
= cred
->cr_ops
->cr_init(auth
, cred
);
350 rpcauth_destroy_credlist(&free
);
354 EXPORT_SYMBOL_GPL(rpcauth_lookup_credcache
);
357 rpcauth_lookupcred(struct rpc_auth
*auth
, int flags
)
359 struct auth_cred acred
;
360 struct rpc_cred
*ret
;
361 const struct cred
*cred
= current_cred();
363 dprintk("RPC: looking up %s cred\n",
364 auth
->au_ops
->au_name
);
366 memset(&acred
, 0, sizeof(acred
));
367 acred
.uid
= cred
->fsuid
;
368 acred
.gid
= cred
->fsgid
;
369 acred
.group_info
= get_group_info(((struct cred
*)cred
)->group_info
);
371 ret
= auth
->au_ops
->lookup_cred(auth
, &acred
, flags
);
372 put_group_info(acred
.group_info
);
377 rpcauth_init_cred(struct rpc_cred
*cred
, const struct auth_cred
*acred
,
378 struct rpc_auth
*auth
, const struct rpc_credops
*ops
)
380 INIT_HLIST_NODE(&cred
->cr_hash
);
381 INIT_LIST_HEAD(&cred
->cr_lru
);
382 atomic_set(&cred
->cr_count
, 1);
383 cred
->cr_auth
= auth
;
385 cred
->cr_expire
= jiffies
;
387 cred
->cr_magic
= RPCAUTH_CRED_MAGIC
;
389 cred
->cr_uid
= acred
->uid
;
391 EXPORT_SYMBOL_GPL(rpcauth_init_cred
);
394 rpcauth_generic_bind_cred(struct rpc_task
*task
, struct rpc_cred
*cred
, int lookupflags
)
396 task
->tk_msg
.rpc_cred
= get_rpccred(cred
);
397 dprintk("RPC: %5u holding %s cred %p\n", task
->tk_pid
,
398 cred
->cr_auth
->au_ops
->au_name
, cred
);
400 EXPORT_SYMBOL_GPL(rpcauth_generic_bind_cred
);
403 rpcauth_bind_root_cred(struct rpc_task
*task
, int lookupflags
)
405 struct rpc_auth
*auth
= task
->tk_client
->cl_auth
;
406 struct auth_cred acred
= {
410 struct rpc_cred
*ret
;
412 dprintk("RPC: %5u looking up %s cred\n",
413 task
->tk_pid
, task
->tk_client
->cl_auth
->au_ops
->au_name
);
414 ret
= auth
->au_ops
->lookup_cred(auth
, &acred
, lookupflags
);
416 task
->tk_msg
.rpc_cred
= ret
;
418 task
->tk_status
= PTR_ERR(ret
);
422 rpcauth_bind_new_cred(struct rpc_task
*task
, int lookupflags
)
424 struct rpc_auth
*auth
= task
->tk_client
->cl_auth
;
425 struct rpc_cred
*ret
;
427 dprintk("RPC: %5u looking up %s cred\n",
428 task
->tk_pid
, auth
->au_ops
->au_name
);
429 ret
= rpcauth_lookupcred(auth
, lookupflags
);
431 task
->tk_msg
.rpc_cred
= ret
;
433 task
->tk_status
= PTR_ERR(ret
);
437 rpcauth_bindcred(struct rpc_task
*task
, struct rpc_cred
*cred
, int flags
)
441 if (flags
& RPC_TASK_ASYNC
)
442 lookupflags
|= RPCAUTH_LOOKUP_NEW
;
444 cred
->cr_ops
->crbind(task
, cred
, lookupflags
);
445 else if (flags
& RPC_TASK_ROOTCREDS
)
446 rpcauth_bind_root_cred(task
, lookupflags
);
448 rpcauth_bind_new_cred(task
, lookupflags
);
452 put_rpccred(struct rpc_cred
*cred
)
454 /* Fast path for unhashed credentials */
455 if (test_bit(RPCAUTH_CRED_HASHED
, &cred
->cr_flags
) == 0) {
456 if (atomic_dec_and_test(&cred
->cr_count
))
457 cred
->cr_ops
->crdestroy(cred
);
461 if (!atomic_dec_and_lock(&cred
->cr_count
, &rpc_credcache_lock
))
463 if (!list_empty(&cred
->cr_lru
)) {
464 number_cred_unused
--;
465 list_del_init(&cred
->cr_lru
);
467 if (test_bit(RPCAUTH_CRED_HASHED
, &cred
->cr_flags
) != 0) {
468 if (test_bit(RPCAUTH_CRED_UPTODATE
, &cred
->cr_flags
) != 0) {
469 cred
->cr_expire
= jiffies
;
470 list_add_tail(&cred
->cr_lru
, &cred_unused
);
471 number_cred_unused
++;
474 if (!rpcauth_unhash_cred(cred
)) {
475 /* We were hashed and someone looked us up... */
479 spin_unlock(&rpc_credcache_lock
);
480 cred
->cr_ops
->crdestroy(cred
);
483 spin_unlock(&rpc_credcache_lock
);
485 EXPORT_SYMBOL_GPL(put_rpccred
);
488 rpcauth_unbindcred(struct rpc_task
*task
)
490 struct rpc_cred
*cred
= task
->tk_msg
.rpc_cred
;
492 dprintk("RPC: %5u releasing %s cred %p\n",
493 task
->tk_pid
, cred
->cr_auth
->au_ops
->au_name
, cred
);
496 task
->tk_msg
.rpc_cred
= NULL
;
500 rpcauth_marshcred(struct rpc_task
*task
, __be32
*p
)
502 struct rpc_cred
*cred
= task
->tk_msg
.rpc_cred
;
504 dprintk("RPC: %5u marshaling %s cred %p\n",
505 task
->tk_pid
, cred
->cr_auth
->au_ops
->au_name
, cred
);
507 return cred
->cr_ops
->crmarshal(task
, p
);
511 rpcauth_checkverf(struct rpc_task
*task
, __be32
*p
)
513 struct rpc_cred
*cred
= task
->tk_msg
.rpc_cred
;
515 dprintk("RPC: %5u validating %s cred %p\n",
516 task
->tk_pid
, cred
->cr_auth
->au_ops
->au_name
, cred
);
518 return cred
->cr_ops
->crvalidate(task
, p
);
522 rpcauth_wrap_req(struct rpc_task
*task
, kxdrproc_t encode
, void *rqstp
,
523 __be32
*data
, void *obj
)
525 struct rpc_cred
*cred
= task
->tk_msg
.rpc_cred
;
527 dprintk("RPC: %5u using %s cred %p to wrap rpc data\n",
528 task
->tk_pid
, cred
->cr_ops
->cr_name
, cred
);
529 if (cred
->cr_ops
->crwrap_req
)
530 return cred
->cr_ops
->crwrap_req(task
, encode
, rqstp
, data
, obj
);
531 /* By default, we encode the arguments normally. */
532 return encode(rqstp
, data
, obj
);
536 rpcauth_unwrap_resp(struct rpc_task
*task
, kxdrproc_t decode
, void *rqstp
,
537 __be32
*data
, void *obj
)
539 struct rpc_cred
*cred
= task
->tk_msg
.rpc_cred
;
541 dprintk("RPC: %5u using %s cred %p to unwrap rpc data\n",
542 task
->tk_pid
, cred
->cr_ops
->cr_name
, cred
);
543 if (cred
->cr_ops
->crunwrap_resp
)
544 return cred
->cr_ops
->crunwrap_resp(task
, decode
, rqstp
,
546 /* By default, we decode the arguments normally. */
547 return decode(rqstp
, data
, obj
);
551 rpcauth_refreshcred(struct rpc_task
*task
)
553 struct rpc_cred
*cred
= task
->tk_msg
.rpc_cred
;
556 dprintk("RPC: %5u refreshing %s cred %p\n",
557 task
->tk_pid
, cred
->cr_auth
->au_ops
->au_name
, cred
);
559 err
= cred
->cr_ops
->crrefresh(task
);
561 task
->tk_status
= err
;
566 rpcauth_invalcred(struct rpc_task
*task
)
568 struct rpc_cred
*cred
= task
->tk_msg
.rpc_cred
;
570 dprintk("RPC: %5u invalidating %s cred %p\n",
571 task
->tk_pid
, cred
->cr_auth
->au_ops
->au_name
, cred
);
573 clear_bit(RPCAUTH_CRED_UPTODATE
, &cred
->cr_flags
);
577 rpcauth_uptodatecred(struct rpc_task
*task
)
579 struct rpc_cred
*cred
= task
->tk_msg
.rpc_cred
;
581 return cred
== NULL
||
582 test_bit(RPCAUTH_CRED_UPTODATE
, &cred
->cr_flags
) != 0;
585 static struct shrinker rpc_cred_shrinker
= {
586 .shrink
= rpcauth_cache_shrinker
,
587 .seeks
= DEFAULT_SEEKS
,
590 void __init
rpcauth_init_module(void)
593 rpc_init_generic_auth();
594 register_shrinker(&rpc_cred_shrinker
);
597 void __exit
rpcauth_remove_module(void)
599 unregister_shrinker(&rpc_cred_shrinker
);