]> err.no Git - linux-2.6/blob - security/keys/keyctl.c
keys: increase the payload size when instantiating a key
[linux-2.6] / security / keys / keyctl.c
1 /* keyctl.c: userspace keyctl operations
2  *
3  * Copyright (C) 2004-5 Red Hat, Inc. All Rights Reserved.
4  * Written by David Howells (dhowells@redhat.com)
5  *
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  */
11
12 #include <linux/module.h>
13 #include <linux/init.h>
14 #include <linux/sched.h>
15 #include <linux/slab.h>
16 #include <linux/syscalls.h>
17 #include <linux/keyctl.h>
18 #include <linux/fs.h>
19 #include <linux/capability.h>
20 #include <linux/string.h>
21 #include <linux/err.h>
22 #include <linux/vmalloc.h>
23 #include <asm/uaccess.h>
24 #include "internal.h"
25
26 static int key_get_type_from_user(char *type,
27                                   const char __user *_type,
28                                   unsigned len)
29 {
30         int ret;
31
32         ret = strncpy_from_user(type, _type, len);
33
34         if (ret < 0)
35                 return -EFAULT;
36
37         if (ret == 0 || ret >= len)
38                 return -EINVAL;
39
40         if (type[0] == '.')
41                 return -EPERM;
42
43         type[len - 1] = '\0';
44
45         return 0;
46 }
47
48 /*****************************************************************************/
49 /*
50  * extract the description of a new key from userspace and either add it as a
51  * new key to the specified keyring or update a matching key in that keyring
52  * - the keyring must be writable
53  * - returns the new key's serial number
54  * - implements add_key()
55  */
56 asmlinkage long sys_add_key(const char __user *_type,
57                             const char __user *_description,
58                             const void __user *_payload,
59                             size_t plen,
60                             key_serial_t ringid)
61 {
62         key_ref_t keyring_ref, key_ref;
63         char type[32], *description;
64         void *payload;
65         long ret;
66         bool vm;
67
68         ret = -EINVAL;
69         if (plen > 1024 * 1024 - 1)
70                 goto error;
71
72         /* draw all the data into kernel space */
73         ret = key_get_type_from_user(type, _type, sizeof(type));
74         if (ret < 0)
75                 goto error;
76
77         description = strndup_user(_description, PAGE_SIZE);
78         if (IS_ERR(description)) {
79                 ret = PTR_ERR(description);
80                 goto error;
81         }
82
83         /* pull the payload in if one was supplied */
84         payload = NULL;
85
86         vm = false;
87         if (_payload) {
88                 ret = -ENOMEM;
89                 payload = kmalloc(plen, GFP_KERNEL);
90                 if (!payload) {
91                         if (plen <= PAGE_SIZE)
92                                 goto error2;
93                         vm = true;
94                         payload = vmalloc(plen);
95                         if (!payload)
96                                 goto error2;
97                 }
98
99                 ret = -EFAULT;
100                 if (copy_from_user(payload, _payload, plen) != 0)
101                         goto error3;
102         }
103
104         /* find the target keyring (which must be writable) */
105         keyring_ref = lookup_user_key(NULL, ringid, 1, 0, KEY_WRITE);
106         if (IS_ERR(keyring_ref)) {
107                 ret = PTR_ERR(keyring_ref);
108                 goto error3;
109         }
110
111         /* create or update the requested key and add it to the target
112          * keyring */
113         key_ref = key_create_or_update(keyring_ref, type, description,
114                                        payload, plen, KEY_ALLOC_IN_QUOTA);
115         if (!IS_ERR(key_ref)) {
116                 ret = key_ref_to_ptr(key_ref)->serial;
117                 key_ref_put(key_ref);
118         }
119         else {
120                 ret = PTR_ERR(key_ref);
121         }
122
123         key_ref_put(keyring_ref);
124  error3:
125         if (!vm)
126                 kfree(payload);
127         else
128                 vfree(payload);
129  error2:
130         kfree(description);
131  error:
132         return ret;
133
134 } /* end sys_add_key() */
135
136 /*****************************************************************************/
137 /*
138  * search the process keyrings for a matching key
139  * - nested keyrings may also be searched if they have Search permission
140  * - if a key is found, it will be attached to the destination keyring if
141  *   there's one specified
142  * - /sbin/request-key will be invoked if _callout_info is non-NULL
143  *   - the _callout_info string will be passed to /sbin/request-key
144  *   - if the _callout_info string is empty, it will be rendered as "-"
145  * - implements request_key()
146  */
147 asmlinkage long sys_request_key(const char __user *_type,
148                                 const char __user *_description,
149                                 const char __user *_callout_info,
150                                 key_serial_t destringid)
151 {
152         struct key_type *ktype;
153         struct key *key;
154         key_ref_t dest_ref;
155         char type[32], *description, *callout_info;
156         long ret;
157
158         /* pull the type into kernel space */
159         ret = key_get_type_from_user(type, _type, sizeof(type));
160         if (ret < 0)
161                 goto error;
162
163         /* pull the description into kernel space */
164         description = strndup_user(_description, PAGE_SIZE);
165         if (IS_ERR(description)) {
166                 ret = PTR_ERR(description);
167                 goto error;
168         }
169
170         /* pull the callout info into kernel space */
171         callout_info = NULL;
172         if (_callout_info) {
173                 callout_info = strndup_user(_callout_info, PAGE_SIZE);
174                 if (IS_ERR(callout_info)) {
175                         ret = PTR_ERR(callout_info);
176                         goto error2;
177                 }
178         }
179
180         /* get the destination keyring if specified */
181         dest_ref = NULL;
182         if (destringid) {
183                 dest_ref = lookup_user_key(NULL, destringid, 1, 0, KEY_WRITE);
184                 if (IS_ERR(dest_ref)) {
185                         ret = PTR_ERR(dest_ref);
186                         goto error3;
187                 }
188         }
189
190         /* find the key type */
191         ktype = key_type_lookup(type);
192         if (IS_ERR(ktype)) {
193                 ret = PTR_ERR(ktype);
194                 goto error4;
195         }
196
197         /* do the search */
198         key = request_key_and_link(ktype, description, callout_info, NULL,
199                                    key_ref_to_ptr(dest_ref),
200                                    KEY_ALLOC_IN_QUOTA);
201         if (IS_ERR(key)) {
202                 ret = PTR_ERR(key);
203                 goto error5;
204         }
205
206         ret = key->serial;
207
208         key_put(key);
209  error5:
210         key_type_put(ktype);
211  error4:
212         key_ref_put(dest_ref);
213  error3:
214         kfree(callout_info);
215  error2:
216         kfree(description);
217  error:
218         return ret;
219
220 } /* end sys_request_key() */
221
222 /*****************************************************************************/
223 /*
224  * get the ID of the specified process keyring
225  * - the keyring must have search permission to be found
226  * - implements keyctl(KEYCTL_GET_KEYRING_ID)
227  */
228 long keyctl_get_keyring_ID(key_serial_t id, int create)
229 {
230         key_ref_t key_ref;
231         long ret;
232
233         key_ref = lookup_user_key(NULL, id, create, 0, KEY_SEARCH);
234         if (IS_ERR(key_ref)) {
235                 ret = PTR_ERR(key_ref);
236                 goto error;
237         }
238
239         ret = key_ref_to_ptr(key_ref)->serial;
240         key_ref_put(key_ref);
241  error:
242         return ret;
243
244 } /* end keyctl_get_keyring_ID() */
245
246 /*****************************************************************************/
247 /*
248  * join the session keyring
249  * - implements keyctl(KEYCTL_JOIN_SESSION_KEYRING)
250  */
251 long keyctl_join_session_keyring(const char __user *_name)
252 {
253         char *name;
254         long ret;
255
256         /* fetch the name from userspace */
257         name = NULL;
258         if (_name) {
259                 name = strndup_user(_name, PAGE_SIZE);
260                 if (IS_ERR(name)) {
261                         ret = PTR_ERR(name);
262                         goto error;
263                 }
264         }
265
266         /* join the session */
267         ret = join_session_keyring(name);
268
269  error:
270         return ret;
271
272 } /* end keyctl_join_session_keyring() */
273
274 /*****************************************************************************/
275 /*
276  * update a key's data payload
277  * - the key must be writable
278  * - implements keyctl(KEYCTL_UPDATE)
279  */
280 long keyctl_update_key(key_serial_t id,
281                        const void __user *_payload,
282                        size_t plen)
283 {
284         key_ref_t key_ref;
285         void *payload;
286         long ret;
287
288         ret = -EINVAL;
289         if (plen > PAGE_SIZE)
290                 goto error;
291
292         /* pull the payload in if one was supplied */
293         payload = NULL;
294         if (_payload) {
295                 ret = -ENOMEM;
296                 payload = kmalloc(plen, GFP_KERNEL);
297                 if (!payload)
298                         goto error;
299
300                 ret = -EFAULT;
301                 if (copy_from_user(payload, _payload, plen) != 0)
302                         goto error2;
303         }
304
305         /* find the target key (which must be writable) */
306         key_ref = lookup_user_key(NULL, id, 0, 0, KEY_WRITE);
307         if (IS_ERR(key_ref)) {
308                 ret = PTR_ERR(key_ref);
309                 goto error2;
310         }
311
312         /* update the key */
313         ret = key_update(key_ref, payload, plen);
314
315         key_ref_put(key_ref);
316  error2:
317         kfree(payload);
318  error:
319         return ret;
320
321 } /* end keyctl_update_key() */
322
323 /*****************************************************************************/
324 /*
325  * revoke a key
326  * - the key must be writable
327  * - implements keyctl(KEYCTL_REVOKE)
328  */
329 long keyctl_revoke_key(key_serial_t id)
330 {
331         key_ref_t key_ref;
332         long ret;
333
334         key_ref = lookup_user_key(NULL, id, 0, 0, KEY_WRITE);
335         if (IS_ERR(key_ref)) {
336                 ret = PTR_ERR(key_ref);
337                 goto error;
338         }
339
340         key_revoke(key_ref_to_ptr(key_ref));
341         ret = 0;
342
343         key_ref_put(key_ref);
344  error:
345         return ret;
346
347 } /* end keyctl_revoke_key() */
348
349 /*****************************************************************************/
350 /*
351  * clear the specified process keyring
352  * - the keyring must be writable
353  * - implements keyctl(KEYCTL_CLEAR)
354  */
355 long keyctl_keyring_clear(key_serial_t ringid)
356 {
357         key_ref_t keyring_ref;
358         long ret;
359
360         keyring_ref = lookup_user_key(NULL, ringid, 1, 0, KEY_WRITE);
361         if (IS_ERR(keyring_ref)) {
362                 ret = PTR_ERR(keyring_ref);
363                 goto error;
364         }
365
366         ret = keyring_clear(key_ref_to_ptr(keyring_ref));
367
368         key_ref_put(keyring_ref);
369  error:
370         return ret;
371
372 } /* end keyctl_keyring_clear() */
373
374 /*****************************************************************************/
375 /*
376  * link a key into a keyring
377  * - the keyring must be writable
378  * - the key must be linkable
379  * - implements keyctl(KEYCTL_LINK)
380  */
381 long keyctl_keyring_link(key_serial_t id, key_serial_t ringid)
382 {
383         key_ref_t keyring_ref, key_ref;
384         long ret;
385
386         keyring_ref = lookup_user_key(NULL, ringid, 1, 0, KEY_WRITE);
387         if (IS_ERR(keyring_ref)) {
388                 ret = PTR_ERR(keyring_ref);
389                 goto error;
390         }
391
392         key_ref = lookup_user_key(NULL, id, 1, 0, KEY_LINK);
393         if (IS_ERR(key_ref)) {
394                 ret = PTR_ERR(key_ref);
395                 goto error2;
396         }
397
398         ret = key_link(key_ref_to_ptr(keyring_ref), key_ref_to_ptr(key_ref));
399
400         key_ref_put(key_ref);
401  error2:
402         key_ref_put(keyring_ref);
403  error:
404         return ret;
405
406 } /* end keyctl_keyring_link() */
407
408 /*****************************************************************************/
409 /*
410  * unlink the first attachment of a key from a keyring
411  * - the keyring must be writable
412  * - we don't need any permissions on the key
413  * - implements keyctl(KEYCTL_UNLINK)
414  */
415 long keyctl_keyring_unlink(key_serial_t id, key_serial_t ringid)
416 {
417         key_ref_t keyring_ref, key_ref;
418         long ret;
419
420         keyring_ref = lookup_user_key(NULL, ringid, 0, 0, KEY_WRITE);
421         if (IS_ERR(keyring_ref)) {
422                 ret = PTR_ERR(keyring_ref);
423                 goto error;
424         }
425
426         key_ref = lookup_user_key(NULL, id, 0, 0, 0);
427         if (IS_ERR(key_ref)) {
428                 ret = PTR_ERR(key_ref);
429                 goto error2;
430         }
431
432         ret = key_unlink(key_ref_to_ptr(keyring_ref), key_ref_to_ptr(key_ref));
433
434         key_ref_put(key_ref);
435  error2:
436         key_ref_put(keyring_ref);
437  error:
438         return ret;
439
440 } /* end keyctl_keyring_unlink() */
441
442 /*****************************************************************************/
443 /*
444  * describe a user key
445  * - the key must have view permission
446  * - if there's a buffer, we place up to buflen bytes of data into it
447  * - unless there's an error, we return the amount of description available,
448  *   irrespective of how much we may have copied
449  * - the description is formatted thus:
450  *      type;uid;gid;perm;description<NUL>
451  * - implements keyctl(KEYCTL_DESCRIBE)
452  */
453 long keyctl_describe_key(key_serial_t keyid,
454                          char __user *buffer,
455                          size_t buflen)
456 {
457         struct key *key, *instkey;
458         key_ref_t key_ref;
459         char *tmpbuf;
460         long ret;
461
462         key_ref = lookup_user_key(NULL, keyid, 0, 1, KEY_VIEW);
463         if (IS_ERR(key_ref)) {
464                 /* viewing a key under construction is permitted if we have the
465                  * authorisation token handy */
466                 if (PTR_ERR(key_ref) == -EACCES) {
467                         instkey = key_get_instantiation_authkey(keyid);
468                         if (!IS_ERR(instkey)) {
469                                 key_put(instkey);
470                                 key_ref = lookup_user_key(NULL, keyid,
471                                                           0, 1, 0);
472                                 if (!IS_ERR(key_ref))
473                                         goto okay;
474                         }
475                 }
476
477                 ret = PTR_ERR(key_ref);
478                 goto error;
479         }
480
481 okay:
482         /* calculate how much description we're going to return */
483         ret = -ENOMEM;
484         tmpbuf = kmalloc(PAGE_SIZE, GFP_KERNEL);
485         if (!tmpbuf)
486                 goto error2;
487
488         key = key_ref_to_ptr(key_ref);
489
490         ret = snprintf(tmpbuf, PAGE_SIZE - 1,
491                        "%s;%d;%d;%08x;%s",
492                        key_ref_to_ptr(key_ref)->type->name,
493                        key_ref_to_ptr(key_ref)->uid,
494                        key_ref_to_ptr(key_ref)->gid,
495                        key_ref_to_ptr(key_ref)->perm,
496                        key_ref_to_ptr(key_ref)->description ?
497                        key_ref_to_ptr(key_ref)->description : ""
498                        );
499
500         /* include a NUL char at the end of the data */
501         if (ret > PAGE_SIZE - 1)
502                 ret = PAGE_SIZE - 1;
503         tmpbuf[ret] = 0;
504         ret++;
505
506         /* consider returning the data */
507         if (buffer && buflen > 0) {
508                 if (buflen > ret)
509                         buflen = ret;
510
511                 if (copy_to_user(buffer, tmpbuf, buflen) != 0)
512                         ret = -EFAULT;
513         }
514
515         kfree(tmpbuf);
516  error2:
517         key_ref_put(key_ref);
518  error:
519         return ret;
520
521 } /* end keyctl_describe_key() */
522
523 /*****************************************************************************/
524 /*
525  * search the specified keyring for a matching key
526  * - the start keyring must be searchable
527  * - nested keyrings may also be searched if they are searchable
528  * - only keys with search permission may be found
529  * - if a key is found, it will be attached to the destination keyring if
530  *   there's one specified
531  * - implements keyctl(KEYCTL_SEARCH)
532  */
533 long keyctl_keyring_search(key_serial_t ringid,
534                            const char __user *_type,
535                            const char __user *_description,
536                            key_serial_t destringid)
537 {
538         struct key_type *ktype;
539         key_ref_t keyring_ref, key_ref, dest_ref;
540         char type[32], *description;
541         long ret;
542
543         /* pull the type and description into kernel space */
544         ret = key_get_type_from_user(type, _type, sizeof(type));
545         if (ret < 0)
546                 goto error;
547
548         description = strndup_user(_description, PAGE_SIZE);
549         if (IS_ERR(description)) {
550                 ret = PTR_ERR(description);
551                 goto error;
552         }
553
554         /* get the keyring at which to begin the search */
555         keyring_ref = lookup_user_key(NULL, ringid, 0, 0, KEY_SEARCH);
556         if (IS_ERR(keyring_ref)) {
557                 ret = PTR_ERR(keyring_ref);
558                 goto error2;
559         }
560
561         /* get the destination keyring if specified */
562         dest_ref = NULL;
563         if (destringid) {
564                 dest_ref = lookup_user_key(NULL, destringid, 1, 0, KEY_WRITE);
565                 if (IS_ERR(dest_ref)) {
566                         ret = PTR_ERR(dest_ref);
567                         goto error3;
568                 }
569         }
570
571         /* find the key type */
572         ktype = key_type_lookup(type);
573         if (IS_ERR(ktype)) {
574                 ret = PTR_ERR(ktype);
575                 goto error4;
576         }
577
578         /* do the search */
579         key_ref = keyring_search(keyring_ref, ktype, description);
580         if (IS_ERR(key_ref)) {
581                 ret = PTR_ERR(key_ref);
582
583                 /* treat lack or presence of a negative key the same */
584                 if (ret == -EAGAIN)
585                         ret = -ENOKEY;
586                 goto error5;
587         }
588
589         /* link the resulting key to the destination keyring if we can */
590         if (dest_ref) {
591                 ret = key_permission(key_ref, KEY_LINK);
592                 if (ret < 0)
593                         goto error6;
594
595                 ret = key_link(key_ref_to_ptr(dest_ref), key_ref_to_ptr(key_ref));
596                 if (ret < 0)
597                         goto error6;
598         }
599
600         ret = key_ref_to_ptr(key_ref)->serial;
601
602  error6:
603         key_ref_put(key_ref);
604  error5:
605         key_type_put(ktype);
606  error4:
607         key_ref_put(dest_ref);
608  error3:
609         key_ref_put(keyring_ref);
610  error2:
611         kfree(description);
612  error:
613         return ret;
614
615 } /* end keyctl_keyring_search() */
616
617 /*****************************************************************************/
618 /*
619  * read a user key's payload
620  * - the keyring must be readable or the key must be searchable from the
621  *   process's keyrings
622  * - if there's a buffer, we place up to buflen bytes of data into it
623  * - unless there's an error, we return the amount of data in the key,
624  *   irrespective of how much we may have copied
625  * - implements keyctl(KEYCTL_READ)
626  */
627 long keyctl_read_key(key_serial_t keyid, char __user *buffer, size_t buflen)
628 {
629         struct key *key;
630         key_ref_t key_ref;
631         long ret;
632
633         /* find the key first */
634         key_ref = lookup_user_key(NULL, keyid, 0, 0, 0);
635         if (IS_ERR(key_ref)) {
636                 ret = -ENOKEY;
637                 goto error;
638         }
639
640         key = key_ref_to_ptr(key_ref);
641
642         /* see if we can read it directly */
643         ret = key_permission(key_ref, KEY_READ);
644         if (ret == 0)
645                 goto can_read_key;
646         if (ret != -EACCES)
647                 goto error;
648
649         /* we can't; see if it's searchable from this process's keyrings
650          * - we automatically take account of the fact that it may be
651          *   dangling off an instantiation key
652          */
653         if (!is_key_possessed(key_ref)) {
654                 ret = -EACCES;
655                 goto error2;
656         }
657
658         /* the key is probably readable - now try to read it */
659  can_read_key:
660         ret = key_validate(key);
661         if (ret == 0) {
662                 ret = -EOPNOTSUPP;
663                 if (key->type->read) {
664                         /* read the data with the semaphore held (since we
665                          * might sleep) */
666                         down_read(&key->sem);
667                         ret = key->type->read(key, buffer, buflen);
668                         up_read(&key->sem);
669                 }
670         }
671
672  error2:
673         key_put(key);
674  error:
675         return ret;
676
677 } /* end keyctl_read_key() */
678
679 /*****************************************************************************/
680 /*
681  * change the ownership of a key
682  * - the keyring owned by the changer
683  * - if the uid or gid is -1, then that parameter is not changed
684  * - implements keyctl(KEYCTL_CHOWN)
685  */
686 long keyctl_chown_key(key_serial_t id, uid_t uid, gid_t gid)
687 {
688         struct key_user *newowner, *zapowner = NULL;
689         struct key *key;
690         key_ref_t key_ref;
691         long ret;
692
693         ret = 0;
694         if (uid == (uid_t) -1 && gid == (gid_t) -1)
695                 goto error;
696
697         key_ref = lookup_user_key(NULL, id, 1, 1, KEY_SETATTR);
698         if (IS_ERR(key_ref)) {
699                 ret = PTR_ERR(key_ref);
700                 goto error;
701         }
702
703         key = key_ref_to_ptr(key_ref);
704
705         /* make the changes with the locks held to prevent chown/chown races */
706         ret = -EACCES;
707         down_write(&key->sem);
708
709         if (!capable(CAP_SYS_ADMIN)) {
710                 /* only the sysadmin can chown a key to some other UID */
711                 if (uid != (uid_t) -1 && key->uid != uid)
712                         goto error_put;
713
714                 /* only the sysadmin can set the key's GID to a group other
715                  * than one of those that the current process subscribes to */
716                 if (gid != (gid_t) -1 && gid != key->gid && !in_group_p(gid))
717                         goto error_put;
718         }
719
720         /* change the UID */
721         if (uid != (uid_t) -1 && uid != key->uid) {
722                 ret = -ENOMEM;
723                 newowner = key_user_lookup(uid);
724                 if (!newowner)
725                         goto error_put;
726
727                 /* transfer the quota burden to the new user */
728                 if (test_bit(KEY_FLAG_IN_QUOTA, &key->flags)) {
729                         spin_lock(&newowner->lock);
730                         if (newowner->qnkeys + 1 >= KEYQUOTA_MAX_KEYS ||
731                             newowner->qnbytes + key->quotalen >=
732                             KEYQUOTA_MAX_BYTES)
733                                 goto quota_overrun;
734
735                         newowner->qnkeys++;
736                         newowner->qnbytes += key->quotalen;
737                         spin_unlock(&newowner->lock);
738
739                         spin_lock(&key->user->lock);
740                         key->user->qnkeys--;
741                         key->user->qnbytes -= key->quotalen;
742                         spin_unlock(&key->user->lock);
743                 }
744
745                 atomic_dec(&key->user->nkeys);
746                 atomic_inc(&newowner->nkeys);
747
748                 if (test_bit(KEY_FLAG_INSTANTIATED, &key->flags)) {
749                         atomic_dec(&key->user->nikeys);
750                         atomic_inc(&newowner->nikeys);
751                 }
752
753                 zapowner = key->user;
754                 key->user = newowner;
755                 key->uid = uid;
756         }
757
758         /* change the GID */
759         if (gid != (gid_t) -1)
760                 key->gid = gid;
761
762         ret = 0;
763
764 error_put:
765         up_write(&key->sem);
766         key_put(key);
767         if (zapowner)
768                 key_user_put(zapowner);
769 error:
770         return ret;
771
772 quota_overrun:
773         spin_unlock(&newowner->lock);
774         zapowner = newowner;
775         ret = -EDQUOT;
776         goto error_put;
777
778 } /* end keyctl_chown_key() */
779
780 /*****************************************************************************/
781 /*
782  * change the permission mask on a key
783  * - the keyring owned by the changer
784  * - implements keyctl(KEYCTL_SETPERM)
785  */
786 long keyctl_setperm_key(key_serial_t id, key_perm_t perm)
787 {
788         struct key *key;
789         key_ref_t key_ref;
790         long ret;
791
792         ret = -EINVAL;
793         if (perm & ~(KEY_POS_ALL | KEY_USR_ALL | KEY_GRP_ALL | KEY_OTH_ALL))
794                 goto error;
795
796         key_ref = lookup_user_key(NULL, id, 1, 1, KEY_SETATTR);
797         if (IS_ERR(key_ref)) {
798                 ret = PTR_ERR(key_ref);
799                 goto error;
800         }
801
802         key = key_ref_to_ptr(key_ref);
803
804         /* make the changes with the locks held to prevent chown/chmod races */
805         ret = -EACCES;
806         down_write(&key->sem);
807
808         /* if we're not the sysadmin, we can only change a key that we own */
809         if (capable(CAP_SYS_ADMIN) || key->uid == current->fsuid) {
810                 key->perm = perm;
811                 ret = 0;
812         }
813
814         up_write(&key->sem);
815         key_put(key);
816 error:
817         return ret;
818
819 } /* end keyctl_setperm_key() */
820
821 /*****************************************************************************/
822 /*
823  * instantiate the key with the specified payload, and, if one is given, link
824  * the key into the keyring
825  */
826 long keyctl_instantiate_key(key_serial_t id,
827                             const void __user *_payload,
828                             size_t plen,
829                             key_serial_t ringid)
830 {
831         struct request_key_auth *rka;
832         struct key *instkey;
833         key_ref_t keyring_ref;
834         void *payload;
835         long ret;
836         bool vm = false;
837
838         ret = -EINVAL;
839         if (plen > 1024 * 1024 - 1)
840                 goto error;
841
842         /* the appropriate instantiation authorisation key must have been
843          * assumed before calling this */
844         ret = -EPERM;
845         instkey = current->request_key_auth;
846         if (!instkey)
847                 goto error;
848
849         rka = instkey->payload.data;
850         if (rka->target_key->serial != id)
851                 goto error;
852
853         /* pull the payload in if one was supplied */
854         payload = NULL;
855
856         if (_payload) {
857                 ret = -ENOMEM;
858                 payload = kmalloc(plen, GFP_KERNEL);
859                 if (!payload) {
860                         if (plen <= PAGE_SIZE)
861                                 goto error;
862                         vm = true;
863                         payload = vmalloc(plen);
864                         if (!payload)
865                                 goto error;
866                 }
867
868                 ret = -EFAULT;
869                 if (copy_from_user(payload, _payload, plen) != 0)
870                         goto error2;
871         }
872
873         /* find the destination keyring amongst those belonging to the
874          * requesting task */
875         keyring_ref = NULL;
876         if (ringid) {
877                 keyring_ref = lookup_user_key(rka->context, ringid, 1, 0,
878                                               KEY_WRITE);
879                 if (IS_ERR(keyring_ref)) {
880                         ret = PTR_ERR(keyring_ref);
881                         goto error2;
882                 }
883         }
884
885         /* instantiate the key and link it into a keyring */
886         ret = key_instantiate_and_link(rka->target_key, payload, plen,
887                                        key_ref_to_ptr(keyring_ref), instkey);
888
889         key_ref_put(keyring_ref);
890
891         /* discard the assumed authority if it's just been disabled by
892          * instantiation of the key */
893         if (ret == 0) {
894                 key_put(current->request_key_auth);
895                 current->request_key_auth = NULL;
896         }
897
898 error2:
899         if (!vm)
900                 kfree(payload);
901         else
902                 vfree(payload);
903 error:
904         return ret;
905
906 } /* end keyctl_instantiate_key() */
907
908 /*****************************************************************************/
909 /*
910  * negatively instantiate the key with the given timeout (in seconds), and, if
911  * one is given, link the key into the keyring
912  */
913 long keyctl_negate_key(key_serial_t id, unsigned timeout, key_serial_t ringid)
914 {
915         struct request_key_auth *rka;
916         struct key *instkey;
917         key_ref_t keyring_ref;
918         long ret;
919
920         /* the appropriate instantiation authorisation key must have been
921          * assumed before calling this */
922         ret = -EPERM;
923         instkey = current->request_key_auth;
924         if (!instkey)
925                 goto error;
926
927         rka = instkey->payload.data;
928         if (rka->target_key->serial != id)
929                 goto error;
930
931         /* find the destination keyring if present (which must also be
932          * writable) */
933         keyring_ref = NULL;
934         if (ringid) {
935                 keyring_ref = lookup_user_key(NULL, ringid, 1, 0, KEY_WRITE);
936                 if (IS_ERR(keyring_ref)) {
937                         ret = PTR_ERR(keyring_ref);
938                         goto error;
939                 }
940         }
941
942         /* instantiate the key and link it into a keyring */
943         ret = key_negate_and_link(rka->target_key, timeout,
944                                   key_ref_to_ptr(keyring_ref), instkey);
945
946         key_ref_put(keyring_ref);
947
948         /* discard the assumed authority if it's just been disabled by
949          * instantiation of the key */
950         if (ret == 0) {
951                 key_put(current->request_key_auth);
952                 current->request_key_auth = NULL;
953         }
954
955 error:
956         return ret;
957
958 } /* end keyctl_negate_key() */
959
960 /*****************************************************************************/
961 /*
962  * set the default keyring in which request_key() will cache keys
963  * - return the old setting
964  */
965 long keyctl_set_reqkey_keyring(int reqkey_defl)
966 {
967         int ret;
968
969         switch (reqkey_defl) {
970         case KEY_REQKEY_DEFL_THREAD_KEYRING:
971                 ret = install_thread_keyring(current);
972                 if (ret < 0)
973                         return ret;
974                 goto set;
975
976         case KEY_REQKEY_DEFL_PROCESS_KEYRING:
977                 ret = install_process_keyring(current);
978                 if (ret < 0)
979                         return ret;
980
981         case KEY_REQKEY_DEFL_DEFAULT:
982         case KEY_REQKEY_DEFL_SESSION_KEYRING:
983         case KEY_REQKEY_DEFL_USER_KEYRING:
984         case KEY_REQKEY_DEFL_USER_SESSION_KEYRING:
985         set:
986                 current->jit_keyring = reqkey_defl;
987
988         case KEY_REQKEY_DEFL_NO_CHANGE:
989                 return current->jit_keyring;
990
991         case KEY_REQKEY_DEFL_GROUP_KEYRING:
992         default:
993                 return -EINVAL;
994         }
995
996 } /* end keyctl_set_reqkey_keyring() */
997
998 /*****************************************************************************/
999 /*
1000  * set or clear the timeout for a key
1001  */
1002 long keyctl_set_timeout(key_serial_t id, unsigned timeout)
1003 {
1004         struct timespec now;
1005         struct key *key;
1006         key_ref_t key_ref;
1007         time_t expiry;
1008         long ret;
1009
1010         key_ref = lookup_user_key(NULL, id, 1, 1, KEY_SETATTR);
1011         if (IS_ERR(key_ref)) {
1012                 ret = PTR_ERR(key_ref);
1013                 goto error;
1014         }
1015
1016         key = key_ref_to_ptr(key_ref);
1017
1018         /* make the changes with the locks held to prevent races */
1019         down_write(&key->sem);
1020
1021         expiry = 0;
1022         if (timeout > 0) {
1023                 now = current_kernel_time();
1024                 expiry = now.tv_sec + timeout;
1025         }
1026
1027         key->expiry = expiry;
1028
1029         up_write(&key->sem);
1030         key_put(key);
1031
1032         ret = 0;
1033 error:
1034         return ret;
1035
1036 } /* end keyctl_set_timeout() */
1037
1038 /*****************************************************************************/
1039 /*
1040  * assume the authority to instantiate the specified key
1041  */
1042 long keyctl_assume_authority(key_serial_t id)
1043 {
1044         struct key *authkey;
1045         long ret;
1046
1047         /* special key IDs aren't permitted */
1048         ret = -EINVAL;
1049         if (id < 0)
1050                 goto error;
1051
1052         /* we divest ourselves of authority if given an ID of 0 */
1053         if (id == 0) {
1054                 key_put(current->request_key_auth);
1055                 current->request_key_auth = NULL;
1056                 ret = 0;
1057                 goto error;
1058         }
1059
1060         /* attempt to assume the authority temporarily granted to us whilst we
1061          * instantiate the specified key
1062          * - the authorisation key must be in the current task's keyrings
1063          *   somewhere
1064          */
1065         authkey = key_get_instantiation_authkey(id);
1066         if (IS_ERR(authkey)) {
1067                 ret = PTR_ERR(authkey);
1068                 goto error;
1069         }
1070
1071         key_put(current->request_key_auth);
1072         current->request_key_auth = authkey;
1073         ret = authkey->serial;
1074
1075 error:
1076         return ret;
1077
1078 } /* end keyctl_assume_authority() */
1079
1080 /*****************************************************************************/
1081 /*
1082  * the key control system call
1083  */
1084 asmlinkage long sys_keyctl(int option, unsigned long arg2, unsigned long arg3,
1085                            unsigned long arg4, unsigned long arg5)
1086 {
1087         switch (option) {
1088         case KEYCTL_GET_KEYRING_ID:
1089                 return keyctl_get_keyring_ID((key_serial_t) arg2,
1090                                              (int) arg3);
1091
1092         case KEYCTL_JOIN_SESSION_KEYRING:
1093                 return keyctl_join_session_keyring((const char __user *) arg2);
1094
1095         case KEYCTL_UPDATE:
1096                 return keyctl_update_key((key_serial_t) arg2,
1097                                          (const void __user *) arg3,
1098                                          (size_t) arg4);
1099
1100         case KEYCTL_REVOKE:
1101                 return keyctl_revoke_key((key_serial_t) arg2);
1102
1103         case KEYCTL_DESCRIBE:
1104                 return keyctl_describe_key((key_serial_t) arg2,
1105                                            (char __user *) arg3,
1106                                            (unsigned) arg4);
1107
1108         case KEYCTL_CLEAR:
1109                 return keyctl_keyring_clear((key_serial_t) arg2);
1110
1111         case KEYCTL_LINK:
1112                 return keyctl_keyring_link((key_serial_t) arg2,
1113                                            (key_serial_t) arg3);
1114
1115         case KEYCTL_UNLINK:
1116                 return keyctl_keyring_unlink((key_serial_t) arg2,
1117                                              (key_serial_t) arg3);
1118
1119         case KEYCTL_SEARCH:
1120                 return keyctl_keyring_search((key_serial_t) arg2,
1121                                              (const char __user *) arg3,
1122                                              (const char __user *) arg4,
1123                                              (key_serial_t) arg5);
1124
1125         case KEYCTL_READ:
1126                 return keyctl_read_key((key_serial_t) arg2,
1127                                        (char __user *) arg3,
1128                                        (size_t) arg4);
1129
1130         case KEYCTL_CHOWN:
1131                 return keyctl_chown_key((key_serial_t) arg2,
1132                                         (uid_t) arg3,
1133                                         (gid_t) arg4);
1134
1135         case KEYCTL_SETPERM:
1136                 return keyctl_setperm_key((key_serial_t) arg2,
1137                                           (key_perm_t) arg3);
1138
1139         case KEYCTL_INSTANTIATE:
1140                 return keyctl_instantiate_key((key_serial_t) arg2,
1141                                               (const void __user *) arg3,
1142                                               (size_t) arg4,
1143                                               (key_serial_t) arg5);
1144
1145         case KEYCTL_NEGATE:
1146                 return keyctl_negate_key((key_serial_t) arg2,
1147                                          (unsigned) arg3,
1148                                          (key_serial_t) arg4);
1149
1150         case KEYCTL_SET_REQKEY_KEYRING:
1151                 return keyctl_set_reqkey_keyring(arg2);
1152
1153         case KEYCTL_SET_TIMEOUT:
1154                 return keyctl_set_timeout((key_serial_t) arg2,
1155                                           (unsigned) arg3);
1156
1157         case KEYCTL_ASSUME_AUTHORITY:
1158                 return keyctl_assume_authority((key_serial_t) arg2);
1159
1160         default:
1161                 return -EOPNOTSUPP;
1162         }
1163
1164 } /* end sys_keyctl() */