Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]

Diff markup

Differences between /linux/security/keys/internal.h (Version 2.6.25) and /linux/security/keys/internal.h (Version 2.6.11.8)


  1 /* internal.h: authentication token and access      1 /* internal.h: authentication token and access key management internal defs
  2  *                                                  2  *
  3  * Copyright (C) 2003-5, 2007 Red Hat, Inc. Al !!   3  * Copyright (C) 2003 Red Hat, Inc. All Rights Reserved.
  4  * Written by David Howells (dhowells@redhat.c      4  * Written by David Howells (dhowells@redhat.com)
  5  *                                                  5  *
  6  * This program is free software; you can redi      6  * This program is free software; you can redistribute it and/or
  7  * modify it under the terms of the GNU Genera      7  * modify it under the terms of the GNU General Public License
  8  * as published by the Free Software Foundatio      8  * as published by the Free Software Foundation; either version
  9  * 2 of the License, or (at your option) any l      9  * 2 of the License, or (at your option) any later version.
 10  */                                                10  */
 11                                                    11 
 12 #ifndef _INTERNAL_H                                12 #ifndef _INTERNAL_H
 13 #define _INTERNAL_H                                13 #define _INTERNAL_H
 14                                                    14 
 15 #include <linux/key-type.h>                    !!  15 #include <linux/key.h>
 16 #include <linux/key-ui.h>                          16 #include <linux/key-ui.h>
 17                                                    17 
 18 static inline __attribute__((format(printf, 1, !!  18 extern struct key_type key_type_dead;
 19 void no_printk(const char *fmt, ...)           << 
 20 {                                              << 
 21 }                                              << 
 22                                                << 
 23 #ifdef __KDEBUG                                << 
 24 #define kenter(FMT, ...) \                     << 
 25         printk(KERN_DEBUG "==> %s("FMT")\n", _ << 
 26 #define kleave(FMT, ...) \                     << 
 27         printk(KERN_DEBUG "<== %s()"FMT"\n", _ << 
 28 #define kdebug(FMT, ...) \                     << 
 29         printk(KERN_DEBUG "xxx" FMT"yyy\n", ## << 
 30 #else                                          << 
 31 #define kenter(FMT, ...) \                     << 
 32         no_printk(KERN_DEBUG "==> %s("FMT")\n" << 
 33 #define kleave(FMT, ...) \                     << 
 34         no_printk(KERN_DEBUG "<== %s()"FMT"\n" << 
 35 #define kdebug(FMT, ...) \                     << 
 36         no_printk(KERN_DEBUG FMT"\n", ##__VA_A << 
 37 #endif                                         << 
 38                                                << 
 39 extern struct key_type key_type_user;              19 extern struct key_type key_type_user;
 40                                                    20 
 41 /*********************************************     21 /*****************************************************************************/
 42 /*                                                 22 /*
 43  * keep track of keys for a user                   23  * keep track of keys for a user
 44  * - this needs to be separate to user_struct      24  * - this needs to be separate to user_struct to avoid a refcount-loop
 45  *   (user_struct pins some keyrings which pin     25  *   (user_struct pins some keyrings which pin this struct)
 46  * - this also keeps track of keys under reque     26  * - this also keeps track of keys under request from userspace for this UID
 47  */                                                27  */
 48 struct key_user {                                  28 struct key_user {
 49         struct rb_node          node;              29         struct rb_node          node;
 50         struct mutex            cons_lock;     !!  30         struct list_head        consq;          /* construction queue */
 51         spinlock_t              lock;              31         spinlock_t              lock;
 52         atomic_t                usage;             32         atomic_t                usage;          /* for accessing qnkeys & qnbytes */
 53         atomic_t                nkeys;             33         atomic_t                nkeys;          /* number of keys */
 54         atomic_t                nikeys;            34         atomic_t                nikeys;         /* number of instantiated keys */
 55         uid_t                   uid;               35         uid_t                   uid;
 56         int                     qnkeys;            36         int                     qnkeys;         /* number of keys allocated to this user */
 57         int                     qnbytes;           37         int                     qnbytes;        /* number of bytes allocated to this user */
 58 };                                                 38 };
 59                                                    39 
 60 #define KEYQUOTA_MAX_KEYS       100                40 #define KEYQUOTA_MAX_KEYS       100
 61 #define KEYQUOTA_MAX_BYTES      10000              41 #define KEYQUOTA_MAX_BYTES      10000
 62 #define KEYQUOTA_LINK_BYTES     4                  42 #define KEYQUOTA_LINK_BYTES     4               /* a link in a keyring is worth 4 bytes */
 63                                                    43 
 64 extern struct rb_root   key_user_tree;             44 extern struct rb_root   key_user_tree;
 65 extern spinlock_t       key_user_lock;             45 extern spinlock_t       key_user_lock;
 66 extern struct key_user  root_key_user;             46 extern struct key_user  root_key_user;
 67                                                    47 
 68 extern struct key_user *key_user_lookup(uid_t      48 extern struct key_user *key_user_lookup(uid_t uid);
 69 extern void key_user_put(struct key_user *user     49 extern void key_user_put(struct key_user *user);
 70                                                    50 
 71                                                    51 
 72                                                    52 
 73 extern struct rb_root key_serial_tree;             53 extern struct rb_root key_serial_tree;
 74 extern spinlock_t key_serial_lock;                 54 extern spinlock_t key_serial_lock;
 75 extern struct semaphore key_alloc_sem;             55 extern struct semaphore key_alloc_sem;
 76 extern struct mutex key_construction_mutex;    !!  56 extern struct rw_semaphore key_construction_sem;
 77 extern wait_queue_head_t request_key_conswq;       57 extern wait_queue_head_t request_key_conswq;
 78                                                    58 
 79                                                    59 
 80 extern void keyring_publish_name(struct key *k     60 extern void keyring_publish_name(struct key *keyring);
 81                                                    61 
 82 extern int __key_link(struct key *keyring, str     62 extern int __key_link(struct key *keyring, struct key *key);
 83                                                    63 
 84 extern key_ref_t __keyring_search_one(key_ref_ !!  64 extern struct key *__keyring_search_one(struct key *keyring,
 85                                       const st !!  65                                         const struct key_type *type,
 86                                       const ch !!  66                                         const char *description,
 87                                       key_perm !!  67                                         key_perm_t perm);
 88                                                << 
 89 extern struct key *keyring_search_instkey(stru << 
 90                                           key_ << 
 91                                                    68 
 92 typedef int (*key_match_func_t)(const struct k     69 typedef int (*key_match_func_t)(const struct key *, const void *);
 93                                                    70 
 94 extern key_ref_t keyring_search_aux(key_ref_t  !!  71 extern struct key *keyring_search_aux(struct key *keyring,
 95                                     struct tas !!  72                                       struct key_type *type,
 96                                     struct key !!  73                                       const void *description,
 97                                     const void !!  74                                       key_match_func_t match);
 98                                     key_match_ !!  75 
 99                                                !!  76 extern struct key *search_process_keyrings_aux(struct key_type *type,
100 extern key_ref_t search_process_keyrings(struc !!  77                                                const void *description,
101                                          const !!  78                                                key_match_func_t match);
102                                          key_m << 
103                                          struc << 
104                                                    79 
105 extern struct key *find_keyring_by_name(const      80 extern struct key *find_keyring_by_name(const char *name, key_serial_t bound);
106                                                    81 
107 extern int install_thread_keyring(struct task_     82 extern int install_thread_keyring(struct task_struct *tsk);
108 extern int install_process_keyring(struct task << 
109                                                << 
110 extern struct key *request_key_and_link(struct << 
111                                         const  << 
112                                         const  << 
113                                         void * << 
114                                         struct << 
115                                         unsign << 
116                                                << 
117 /*                                             << 
118  * request_key authorisation                   << 
119  */                                            << 
120 struct request_key_auth {                      << 
121         struct key              *target_key;   << 
122         struct task_struct      *context;      << 
123         char                    *callout_info; << 
124         pid_t                   pid;           << 
125 };                                             << 
126                                                << 
127 extern struct key_type key_type_request_key_au << 
128 extern struct key *request_key_auth_new(struct << 
129                                         const  << 
130                                                << 
131 extern struct key *key_get_instantiation_authk << 
132                                                    83 
133 /*                                                 84 /*
134  * keyctl functions                                85  * keyctl functions
135  */                                                86  */
136 extern long keyctl_get_keyring_ID(key_serial_t     87 extern long keyctl_get_keyring_ID(key_serial_t, int);
137 extern long keyctl_join_session_keyring(const      88 extern long keyctl_join_session_keyring(const char __user *);
138 extern long keyctl_update_key(key_serial_t, co     89 extern long keyctl_update_key(key_serial_t, const void __user *, size_t);
139 extern long keyctl_revoke_key(key_serial_t);       90 extern long keyctl_revoke_key(key_serial_t);
140 extern long keyctl_keyring_clear(key_serial_t)     91 extern long keyctl_keyring_clear(key_serial_t);
141 extern long keyctl_keyring_link(key_serial_t,      92 extern long keyctl_keyring_link(key_serial_t, key_serial_t);
142 extern long keyctl_keyring_unlink(key_serial_t     93 extern long keyctl_keyring_unlink(key_serial_t, key_serial_t);
143 extern long keyctl_describe_key(key_serial_t,      94 extern long keyctl_describe_key(key_serial_t, char __user *, size_t);
144 extern long keyctl_keyring_search(key_serial_t     95 extern long keyctl_keyring_search(key_serial_t, const char __user *,
145                                   const char _     96                                   const char __user *, key_serial_t);
146 extern long keyctl_read_key(key_serial_t, char     97 extern long keyctl_read_key(key_serial_t, char __user *, size_t);
147 extern long keyctl_chown_key(key_serial_t, uid     98 extern long keyctl_chown_key(key_serial_t, uid_t, gid_t);
148 extern long keyctl_setperm_key(key_serial_t, k     99 extern long keyctl_setperm_key(key_serial_t, key_perm_t);
149 extern long keyctl_instantiate_key(key_serial_    100 extern long keyctl_instantiate_key(key_serial_t, const void __user *,
150                                    size_t, key    101                                    size_t, key_serial_t);
151 extern long keyctl_negate_key(key_serial_t, un    102 extern long keyctl_negate_key(key_serial_t, unsigned, key_serial_t);
152 extern long keyctl_set_reqkey_keyring(int);    << 
153 extern long keyctl_set_timeout(key_serial_t, u << 
154 extern long keyctl_assume_authority(key_serial << 
155                                                   103 
156                                                   104 
157 /*                                                105 /*
158  * debugging key validation                       106  * debugging key validation
159  */                                               107  */
160 #ifdef KEY_DEBUGGING                              108 #ifdef KEY_DEBUGGING
161 extern void __key_check(const struct key *);      109 extern void __key_check(const struct key *);
162                                                   110 
163 static inline void key_check(const struct key     111 static inline void key_check(const struct key *key)
164 {                                                 112 {
165         if (key && (IS_ERR(key) || key->magic     113         if (key && (IS_ERR(key) || key->magic != KEY_DEBUG_MAGIC))
166                 __key_check(key);                 114                 __key_check(key);
167 }                                                 115 }
168                                                   116 
169 #else                                             117 #else
170                                                   118 
171 #define key_check(key) do {} while(0)             119 #define key_check(key) do {} while(0)
172                                                   120 
173 #endif                                            121 #endif
174                                                   122 
175 #endif /* _INTERNAL_H */                          123 #endif /* _INTERNAL_H */
176                                                   124 
  This page was automatically generated by the LXR engine.