2 * eCryptfs: Linux filesystem encryption layer
4 * Copyright (C) 2004-2006 International Business Machines Corp.
5 * Author(s): Michael A. Halcrow <mhalcrow@us.ibm.com>
6 * Tyler Hicks <tyhicks@ou.edu>
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License version
10 * 2 as published by the Free Software Foundation.
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
23 #include "ecryptfs_kernel.h"
25 static LIST_HEAD(ecryptfs_msg_ctx_free_list);
26 static LIST_HEAD(ecryptfs_msg_ctx_alloc_list);
27 static struct mutex ecryptfs_msg_ctx_lists_mux;
29 static struct hlist_head *ecryptfs_daemon_id_hash;
30 static struct mutex ecryptfs_daemon_id_hash_mux;
31 static int ecryptfs_hash_buckets;
32 #define ecryptfs_uid_hash(uid) \
33 hash_long((unsigned long)uid, ecryptfs_hash_buckets)
35 static unsigned int ecryptfs_msg_counter;
36 static struct ecryptfs_msg_ctx *ecryptfs_msg_ctx_arr;
39 * ecryptfs_acquire_free_msg_ctx
40 * @msg_ctx: The context that was acquired from the free list
42 * Acquires a context element from the free list and locks the mutex
43 * on the context. Returns zero on success; non-zero on error or upon
44 * failure to acquire a free context element. Be sure to lock the
45 * list mutex before calling.
47 static int ecryptfs_acquire_free_msg_ctx(struct ecryptfs_msg_ctx **msg_ctx)
52 if (list_empty(&ecryptfs_msg_ctx_free_list)) {
53 ecryptfs_printk(KERN_WARNING, "The eCryptfs free "
54 "context list is empty. It may be helpful to "
55 "specify the ecryptfs_message_buf_len "
56 "parameter to be greater than the current "
57 "value of [%d]\n", ecryptfs_message_buf_len);
61 list_for_each(p, &ecryptfs_msg_ctx_free_list) {
62 *msg_ctx = list_entry(p, struct ecryptfs_msg_ctx, node);
63 if (mutex_trylock(&(*msg_ctx)->mux)) {
64 (*msg_ctx)->task = current;
75 * ecryptfs_msg_ctx_free_to_alloc
76 * @msg_ctx: The context to move from the free list to the alloc list
78 * Be sure to lock the list mutex and the context mutex before
81 static void ecryptfs_msg_ctx_free_to_alloc(struct ecryptfs_msg_ctx *msg_ctx)
83 list_move(&msg_ctx->node, &ecryptfs_msg_ctx_alloc_list);
84 msg_ctx->state = ECRYPTFS_MSG_CTX_STATE_PENDING;
85 msg_ctx->counter = ++ecryptfs_msg_counter;
89 * ecryptfs_msg_ctx_alloc_to_free
90 * @msg_ctx: The context to move from the alloc list to the free list
92 * Be sure to lock the list mutex and the context mutex before
95 static void ecryptfs_msg_ctx_alloc_to_free(struct ecryptfs_msg_ctx *msg_ctx)
97 list_move(&(msg_ctx->node), &ecryptfs_msg_ctx_free_list);
100 msg_ctx->state = ECRYPTFS_MSG_CTX_STATE_FREE;
104 * ecryptfs_find_daemon_id
105 * @uid: The user id which maps to the desired daemon id
106 * @id: If return value is zero, points to the desired daemon id
109 * Search the hash list for the given user id. Returns zero if the
110 * user id exists in the list; non-zero otherwise. The daemon id hash
111 * mutex should be held before calling this function.
113 static int ecryptfs_find_daemon_id(uid_t uid, struct ecryptfs_daemon_id **id)
115 struct hlist_node *elem;
118 hlist_for_each_entry(*id, elem,
119 &ecryptfs_daemon_id_hash[ecryptfs_uid_hash(uid)],
121 if ((*id)->uid == uid) {
131 static int ecryptfs_send_raw_message(unsigned int transport, u16 msg_type,
137 case ECRYPTFS_TRANSPORT_NETLINK:
138 rc = ecryptfs_send_netlink(NULL, 0, NULL, msg_type, 0, pid);
140 case ECRYPTFS_TRANSPORT_CONNECTOR:
141 case ECRYPTFS_TRANSPORT_RELAYFS:
149 * ecryptfs_process_helo
150 * @transport: The underlying transport (netlink, etc.)
151 * @uid: The user ID owner of the message
152 * @pid: The process ID for the userspace program that sent the
155 * Adds the uid and pid values to the daemon id hash. If a uid
156 * already has a daemon pid registered, the daemon will be
157 * unregistered before the new daemon id is put into the hash list.
158 * Returns zero after adding a new daemon id to the hash list;
159 * non-zero otherwise.
161 int ecryptfs_process_helo(unsigned int transport, uid_t uid, pid_t pid)
163 struct ecryptfs_daemon_id *new_id;
164 struct ecryptfs_daemon_id *old_id;
167 mutex_lock(&ecryptfs_daemon_id_hash_mux);
168 new_id = kmalloc(sizeof(*new_id), GFP_KERNEL);
171 ecryptfs_printk(KERN_ERR, "Failed to allocate memory; unable "
172 "to register daemon [%d] for user [%d]\n",
176 if (!ecryptfs_find_daemon_id(uid, &old_id)) {
177 printk(KERN_WARNING "Received request from user [%d] "
178 "to register daemon [%d]; unregistering daemon "
179 "[%d]\n", uid, pid, old_id->pid);
180 hlist_del(&old_id->id_chain);
181 rc = ecryptfs_send_raw_message(transport, ECRYPTFS_NLMSG_QUIT,
184 printk(KERN_WARNING "Failed to send QUIT "
185 "message to daemon [%d]; rc = [%d]\n",
191 hlist_add_head(&new_id->id_chain,
192 &ecryptfs_daemon_id_hash[ecryptfs_uid_hash(uid)]);
195 mutex_unlock(&ecryptfs_daemon_id_hash_mux);
200 * ecryptfs_process_quit
201 * @uid: The user ID owner of the message
202 * @pid: The process ID for the userspace program that sent the
205 * Deletes the corresponding daemon id for the given uid and pid, if
206 * it is the registered that is requesting the deletion. Returns zero
207 * after deleting the desired daemon id; non-zero otherwise.
209 int ecryptfs_process_quit(uid_t uid, pid_t pid)
211 struct ecryptfs_daemon_id *id;
214 mutex_lock(&ecryptfs_daemon_id_hash_mux);
215 if (ecryptfs_find_daemon_id(uid, &id)) {
217 ecryptfs_printk(KERN_ERR, "Received request from user [%d] to "
218 "unregister unrecognized daemon [%d]\n", uid,
222 if (id->pid != pid) {
224 ecryptfs_printk(KERN_WARNING, "Received request from user [%d] "
225 "with pid [%d] to unregister daemon [%d]\n",
229 hlist_del(&id->id_chain);
233 mutex_unlock(&ecryptfs_daemon_id_hash_mux);
238 * ecryptfs_process_reponse
239 * @msg: The ecryptfs message received; the caller should sanity check
241 * @pid: The process ID of the userspace application that sent the
243 * @seq: The sequence number of the message
245 * Processes a response message after sending a operation request to
246 * userspace. Returns zero upon delivery to desired context element;
247 * non-zero upon delivery failure or error.
249 int ecryptfs_process_response(struct ecryptfs_message *msg, uid_t uid,
252 struct ecryptfs_daemon_id *id;
253 struct ecryptfs_msg_ctx *msg_ctx;
257 if (msg->index >= ecryptfs_message_buf_len) {
259 ecryptfs_printk(KERN_ERR, "Attempt to reference "
260 "context buffer at index [%d]; maximum "
261 "allowable is [%d]\n", msg->index,
262 (ecryptfs_message_buf_len - 1));
265 msg_ctx = &ecryptfs_msg_ctx_arr[msg->index];
266 mutex_lock(&msg_ctx->mux);
267 if (ecryptfs_find_daemon_id(msg_ctx->task->euid, &id)) {
269 ecryptfs_printk(KERN_WARNING, "User [%d] received a "
270 "message response from process [%d] but does "
271 "not have a registered daemon\n",
272 msg_ctx->task->euid, pid);
275 if (msg_ctx->task->euid != uid) {
277 ecryptfs_printk(KERN_WARNING, "Received message from user "
278 "[%d]; expected message from user [%d]\n",
279 uid, msg_ctx->task->euid);
282 if (id->pid != pid) {
284 ecryptfs_printk(KERN_ERR, "User [%d] received a "
285 "message response from an unrecognized "
286 "process [%d]\n", msg_ctx->task->euid, pid);
289 if (msg_ctx->state != ECRYPTFS_MSG_CTX_STATE_PENDING) {
291 ecryptfs_printk(KERN_WARNING, "Desired context element is not "
292 "pending a response\n");
294 } else if (msg_ctx->counter != seq) {
296 ecryptfs_printk(KERN_WARNING, "Invalid message sequence; "
297 "expected [%d]; received [%d]\n",
298 msg_ctx->counter, seq);
301 msg_size = sizeof(*msg) + msg->data_len;
302 msg_ctx->msg = kmalloc(msg_size, GFP_KERNEL);
305 ecryptfs_printk(KERN_ERR, "Failed to allocate memory\n");
308 memcpy(msg_ctx->msg, msg, msg_size);
309 msg_ctx->state = ECRYPTFS_MSG_CTX_STATE_DONE;
312 wake_up_process(msg_ctx->task);
314 mutex_unlock(&msg_ctx->mux);
320 * ecryptfs_send_message
321 * @transport: The transport over which to send the message (i.e.,
323 * @data: The data to send
324 * @data_len: The length of data
325 * @msg_ctx: The message context allocated for the send
327 int ecryptfs_send_message(unsigned int transport, char *data, int data_len,
328 struct ecryptfs_msg_ctx **msg_ctx)
330 struct ecryptfs_daemon_id *id;
333 mutex_lock(&ecryptfs_daemon_id_hash_mux);
334 if (ecryptfs_find_daemon_id(current->euid, &id)) {
335 mutex_unlock(&ecryptfs_daemon_id_hash_mux);
337 ecryptfs_printk(KERN_ERR, "User [%d] does not have a daemon "
338 "registered\n", current->euid);
341 mutex_unlock(&ecryptfs_daemon_id_hash_mux);
342 mutex_lock(&ecryptfs_msg_ctx_lists_mux);
343 rc = ecryptfs_acquire_free_msg_ctx(msg_ctx);
345 mutex_unlock(&ecryptfs_msg_ctx_lists_mux);
346 ecryptfs_printk(KERN_WARNING, "Could not claim a free "
347 "context element\n");
350 ecryptfs_msg_ctx_free_to_alloc(*msg_ctx);
351 mutex_unlock(&(*msg_ctx)->mux);
352 mutex_unlock(&ecryptfs_msg_ctx_lists_mux);
354 case ECRYPTFS_TRANSPORT_NETLINK:
355 rc = ecryptfs_send_netlink(data, data_len, *msg_ctx,
356 ECRYPTFS_NLMSG_REQUEST, 0, id->pid);
358 case ECRYPTFS_TRANSPORT_CONNECTOR:
359 case ECRYPTFS_TRANSPORT_RELAYFS:
364 printk(KERN_ERR "Error attempting to send message to userspace "
365 "daemon; rc = [%d]\n", rc);
372 * ecryptfs_wait_for_response
373 * @msg_ctx: The context that was assigned when sending a message
374 * @msg: The incoming message from userspace; not set if rc != 0
376 * Sleeps until awaken by ecryptfs_receive_message or until the amount
377 * of time exceeds ecryptfs_message_wait_timeout. If zero is
378 * returned, msg will point to a valid message from userspace; a
379 * non-zero value is returned upon failure to receive a message or an
382 int ecryptfs_wait_for_response(struct ecryptfs_msg_ctx *msg_ctx,
383 struct ecryptfs_message **msg)
385 signed long timeout = ecryptfs_message_wait_timeout * HZ;
389 timeout = schedule_timeout_interruptible(timeout);
390 mutex_lock(&ecryptfs_msg_ctx_lists_mux);
391 mutex_lock(&msg_ctx->mux);
392 if (msg_ctx->state != ECRYPTFS_MSG_CTX_STATE_DONE) {
394 mutex_unlock(&msg_ctx->mux);
395 mutex_unlock(&ecryptfs_msg_ctx_lists_mux);
403 ecryptfs_msg_ctx_alloc_to_free(msg_ctx);
404 mutex_unlock(&msg_ctx->mux);
405 mutex_unlock(&ecryptfs_msg_ctx_lists_mux);
409 int ecryptfs_init_messaging(unsigned int transport)
414 if (ecryptfs_number_of_users > ECRYPTFS_MAX_NUM_USERS) {
415 ecryptfs_number_of_users = ECRYPTFS_MAX_NUM_USERS;
416 ecryptfs_printk(KERN_WARNING, "Specified number of users is "
417 "too large, defaulting to [%d] users\n",
418 ecryptfs_number_of_users);
420 mutex_init(&ecryptfs_daemon_id_hash_mux);
421 mutex_lock(&ecryptfs_daemon_id_hash_mux);
422 ecryptfs_hash_buckets = 0;
423 while (ecryptfs_number_of_users >> ++ecryptfs_hash_buckets);
424 ecryptfs_daemon_id_hash = kmalloc(sizeof(struct hlist_head)
425 * ecryptfs_hash_buckets, GFP_KERNEL);
426 if (!ecryptfs_daemon_id_hash) {
428 ecryptfs_printk(KERN_ERR, "Failed to allocate memory\n");
431 for (i = 0; i < ecryptfs_hash_buckets; i++)
432 INIT_HLIST_HEAD(&ecryptfs_daemon_id_hash[i]);
433 mutex_unlock(&ecryptfs_daemon_id_hash_mux);
435 ecryptfs_msg_ctx_arr = kmalloc((sizeof(struct ecryptfs_msg_ctx)
436 * ecryptfs_message_buf_len), GFP_KERNEL);
437 if (!ecryptfs_msg_ctx_arr) {
439 ecryptfs_printk(KERN_ERR, "Failed to allocate memory\n");
442 mutex_init(&ecryptfs_msg_ctx_lists_mux);
443 mutex_lock(&ecryptfs_msg_ctx_lists_mux);
444 ecryptfs_msg_counter = 0;
445 for (i = 0; i < ecryptfs_message_buf_len; i++) {
446 INIT_LIST_HEAD(&ecryptfs_msg_ctx_arr[i].node);
447 mutex_init(&ecryptfs_msg_ctx_arr[i].mux);
448 mutex_lock(&ecryptfs_msg_ctx_arr[i].mux);
449 ecryptfs_msg_ctx_arr[i].index = i;
450 ecryptfs_msg_ctx_arr[i].state = ECRYPTFS_MSG_CTX_STATE_FREE;
451 ecryptfs_msg_ctx_arr[i].counter = 0;
452 ecryptfs_msg_ctx_arr[i].task = NULL;
453 ecryptfs_msg_ctx_arr[i].msg = NULL;
454 list_add_tail(&ecryptfs_msg_ctx_arr[i].node,
455 &ecryptfs_msg_ctx_free_list);
456 mutex_unlock(&ecryptfs_msg_ctx_arr[i].mux);
458 mutex_unlock(&ecryptfs_msg_ctx_lists_mux);
460 case ECRYPTFS_TRANSPORT_NETLINK:
461 rc = ecryptfs_init_netlink();
463 ecryptfs_release_messaging(transport);
465 case ECRYPTFS_TRANSPORT_CONNECTOR:
466 case ECRYPTFS_TRANSPORT_RELAYFS:
474 void ecryptfs_release_messaging(unsigned int transport)
476 if (ecryptfs_msg_ctx_arr) {
479 mutex_lock(&ecryptfs_msg_ctx_lists_mux);
480 for (i = 0; i < ecryptfs_message_buf_len; i++) {
481 mutex_lock(&ecryptfs_msg_ctx_arr[i].mux);
482 if (ecryptfs_msg_ctx_arr[i].msg)
483 kfree(ecryptfs_msg_ctx_arr[i].msg);
484 mutex_unlock(&ecryptfs_msg_ctx_arr[i].mux);
486 kfree(ecryptfs_msg_ctx_arr);
487 mutex_unlock(&ecryptfs_msg_ctx_lists_mux);
489 if (ecryptfs_daemon_id_hash) {
490 struct hlist_node *elem;
491 struct ecryptfs_daemon_id *id;
494 mutex_lock(&ecryptfs_daemon_id_hash_mux);
495 for (i = 0; i < ecryptfs_hash_buckets; i++) {
496 hlist_for_each_entry(id, elem,
497 &ecryptfs_daemon_id_hash[i],
503 kfree(ecryptfs_daemon_id_hash);
504 mutex_unlock(&ecryptfs_daemon_id_hash_mux);
507 case ECRYPTFS_TRANSPORT_NETLINK:
508 ecryptfs_release_netlink();
510 case ECRYPTFS_TRANSPORT_CONNECTOR:
511 case ECRYPTFS_TRANSPORT_RELAYFS: