[SCSI] bnx2fc: Add driver documentation
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / fs / ecryptfs / file.c
blobc6ac98cf9baaeca5d898cce216aa0dc08df2716c
1 /**
2 * eCryptfs: Linux filesystem encryption layer
4 * Copyright (C) 1997-2004 Erez Zadok
5 * Copyright (C) 2001-2004 Stony Brook University
6 * Copyright (C) 2004-2007 International Business Machines Corp.
7 * Author(s): Michael A. Halcrow <mhalcrow@us.ibm.com>
8 * Michael C. Thompson <mcthomps@us.ibm.com>
10 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public License as
12 * published by the Free Software Foundation; either version 2 of the
13 * License, or (at your option) any later version.
15 * This program is distributed in the hope that it will be useful, but
16 * WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
23 * 02111-1307, USA.
26 #include <linux/file.h>
27 #include <linux/poll.h>
28 #include <linux/slab.h>
29 #include <linux/mount.h>
30 #include <linux/pagemap.h>
31 #include <linux/security.h>
32 #include <linux/compat.h>
33 #include <linux/fs_stack.h>
34 #include "ecryptfs_kernel.h"
36 /**
37 * ecryptfs_read_update_atime
39 * generic_file_read updates the atime of upper layer inode. But, it
40 * doesn't give us a chance to update the atime of the lower layer
41 * inode. This function is a wrapper to generic_file_read. It
42 * updates the atime of the lower level inode if generic_file_read
43 * returns without any errors. This is to be used only for file reads.
44 * The function to be used for directory reads is ecryptfs_read.
46 static ssize_t ecryptfs_read_update_atime(struct kiocb *iocb,
47 const struct iovec *iov,
48 unsigned long nr_segs, loff_t pos)
50 ssize_t rc;
51 struct dentry *lower_dentry;
52 struct vfsmount *lower_vfsmount;
53 struct file *file = iocb->ki_filp;
55 rc = generic_file_aio_read(iocb, iov, nr_segs, pos);
57 * Even though this is a async interface, we need to wait
58 * for IO to finish to update atime
60 if (-EIOCBQUEUED == rc)
61 rc = wait_on_sync_kiocb(iocb);
62 if (rc >= 0) {
63 lower_dentry = ecryptfs_dentry_to_lower(file->f_path.dentry);
64 lower_vfsmount = ecryptfs_dentry_to_lower_mnt(file->f_path.dentry);
65 touch_atime(lower_vfsmount, lower_dentry);
67 return rc;
70 struct ecryptfs_getdents_callback {
71 void *dirent;
72 struct dentry *dentry;
73 filldir_t filldir;
74 int filldir_called;
75 int entries_written;
78 /* Inspired by generic filldir in fs/readdir.c */
79 static int
80 ecryptfs_filldir(void *dirent, const char *lower_name, int lower_namelen,
81 loff_t offset, u64 ino, unsigned int d_type)
83 struct ecryptfs_getdents_callback *buf =
84 (struct ecryptfs_getdents_callback *)dirent;
85 size_t name_size;
86 char *name;
87 int rc;
89 buf->filldir_called++;
90 rc = ecryptfs_decode_and_decrypt_filename(&name, &name_size,
91 buf->dentry, lower_name,
92 lower_namelen);
93 if (rc) {
94 printk(KERN_ERR "%s: Error attempting to decode and decrypt "
95 "filename [%s]; rc = [%d]\n", __func__, lower_name,
96 rc);
97 goto out;
99 rc = buf->filldir(buf->dirent, name, name_size, offset, ino, d_type);
100 kfree(name);
101 if (rc >= 0)
102 buf->entries_written++;
103 out:
104 return rc;
108 * ecryptfs_readdir
109 * @file: The eCryptfs directory file
110 * @dirent: Directory entry handle
111 * @filldir: The filldir callback function
113 static int ecryptfs_readdir(struct file *file, void *dirent, filldir_t filldir)
115 int rc;
116 struct file *lower_file;
117 struct inode *inode;
118 struct ecryptfs_getdents_callback buf;
120 lower_file = ecryptfs_file_to_lower(file);
121 lower_file->f_pos = file->f_pos;
122 inode = file->f_path.dentry->d_inode;
123 memset(&buf, 0, sizeof(buf));
124 buf.dirent = dirent;
125 buf.dentry = file->f_path.dentry;
126 buf.filldir = filldir;
127 buf.filldir_called = 0;
128 buf.entries_written = 0;
129 rc = vfs_readdir(lower_file, ecryptfs_filldir, (void *)&buf);
130 file->f_pos = lower_file->f_pos;
131 if (rc < 0)
132 goto out;
133 if (buf.filldir_called && !buf.entries_written)
134 goto out;
135 if (rc >= 0)
136 fsstack_copy_attr_atime(inode,
137 lower_file->f_path.dentry->d_inode);
138 out:
139 return rc;
142 struct kmem_cache *ecryptfs_file_info_cache;
145 * ecryptfs_open
146 * @inode: inode speciying file to open
147 * @file: Structure to return filled in
149 * Opens the file specified by inode.
151 * Returns zero on success; non-zero otherwise
153 static int ecryptfs_open(struct inode *inode, struct file *file)
155 int rc = 0;
156 struct ecryptfs_crypt_stat *crypt_stat = NULL;
157 struct ecryptfs_mount_crypt_stat *mount_crypt_stat;
158 struct dentry *ecryptfs_dentry = file->f_path.dentry;
159 /* Private value of ecryptfs_dentry allocated in
160 * ecryptfs_lookup() */
161 struct dentry *lower_dentry;
162 struct ecryptfs_file_info *file_info;
164 mount_crypt_stat = &ecryptfs_superblock_to_private(
165 ecryptfs_dentry->d_sb)->mount_crypt_stat;
166 if ((mount_crypt_stat->flags & ECRYPTFS_ENCRYPTED_VIEW_ENABLED)
167 && ((file->f_flags & O_WRONLY) || (file->f_flags & O_RDWR)
168 || (file->f_flags & O_CREAT) || (file->f_flags & O_TRUNC)
169 || (file->f_flags & O_APPEND))) {
170 printk(KERN_WARNING "Mount has encrypted view enabled; "
171 "files may only be read\n");
172 rc = -EPERM;
173 goto out;
175 /* Released in ecryptfs_release or end of function if failure */
176 file_info = kmem_cache_zalloc(ecryptfs_file_info_cache, GFP_KERNEL);
177 ecryptfs_set_file_private(file, file_info);
178 if (!file_info) {
179 ecryptfs_printk(KERN_ERR,
180 "Error attempting to allocate memory\n");
181 rc = -ENOMEM;
182 goto out;
184 lower_dentry = ecryptfs_dentry_to_lower(ecryptfs_dentry);
185 crypt_stat = &ecryptfs_inode_to_private(inode)->crypt_stat;
186 mutex_lock(&crypt_stat->cs_mutex);
187 if (!(crypt_stat->flags & ECRYPTFS_POLICY_APPLIED)) {
188 ecryptfs_printk(KERN_DEBUG, "Setting flags for stat...\n");
189 /* Policy code enabled in future release */
190 crypt_stat->flags |= (ECRYPTFS_POLICY_APPLIED
191 | ECRYPTFS_ENCRYPTED);
193 mutex_unlock(&crypt_stat->cs_mutex);
194 rc = ecryptfs_get_lower_file(ecryptfs_dentry, inode);
195 if (rc) {
196 printk(KERN_ERR "%s: Error attempting to initialize "
197 "the lower file for the dentry with name "
198 "[%s]; rc = [%d]\n", __func__,
199 ecryptfs_dentry->d_name.name, rc);
200 goto out_free;
202 if ((ecryptfs_inode_to_private(inode)->lower_file->f_flags & O_ACCMODE)
203 == O_RDONLY && (file->f_flags & O_ACCMODE) != O_RDONLY) {
204 rc = -EPERM;
205 printk(KERN_WARNING "%s: Lower file is RO; eCryptfs "
206 "file must hence be opened RO\n", __func__);
207 goto out_put;
209 ecryptfs_set_file_lower(
210 file, ecryptfs_inode_to_private(inode)->lower_file);
211 if (S_ISDIR(ecryptfs_dentry->d_inode->i_mode)) {
212 ecryptfs_printk(KERN_DEBUG, "This is a directory\n");
213 mutex_lock(&crypt_stat->cs_mutex);
214 crypt_stat->flags &= ~(ECRYPTFS_ENCRYPTED);
215 mutex_unlock(&crypt_stat->cs_mutex);
216 rc = 0;
217 goto out;
219 mutex_lock(&crypt_stat->cs_mutex);
220 if (!(crypt_stat->flags & ECRYPTFS_POLICY_APPLIED)
221 || !(crypt_stat->flags & ECRYPTFS_KEY_VALID)) {
222 rc = ecryptfs_read_metadata(ecryptfs_dentry);
223 if (rc) {
224 ecryptfs_printk(KERN_DEBUG,
225 "Valid headers not found\n");
226 if (!(mount_crypt_stat->flags
227 & ECRYPTFS_PLAINTEXT_PASSTHROUGH_ENABLED)) {
228 rc = -EIO;
229 printk(KERN_WARNING "Either the lower file "
230 "is not in a valid eCryptfs format, "
231 "or the key could not be retrieved. "
232 "Plaintext passthrough mode is not "
233 "enabled; returning -EIO\n");
234 mutex_unlock(&crypt_stat->cs_mutex);
235 goto out_put;
237 rc = 0;
238 crypt_stat->flags &= ~(ECRYPTFS_I_SIZE_INITIALIZED
239 | ECRYPTFS_ENCRYPTED);
240 mutex_unlock(&crypt_stat->cs_mutex);
241 goto out;
244 mutex_unlock(&crypt_stat->cs_mutex);
245 ecryptfs_printk(KERN_DEBUG, "inode w/ addr = [0x%p], i_ino = "
246 "[0x%.16lx] size: [0x%.16llx]\n", inode, inode->i_ino,
247 (unsigned long long)i_size_read(inode));
248 goto out;
249 out_put:
250 ecryptfs_put_lower_file(inode);
251 out_free:
252 kmem_cache_free(ecryptfs_file_info_cache,
253 ecryptfs_file_to_private(file));
254 out:
255 return rc;
258 static int ecryptfs_flush(struct file *file, fl_owner_t td)
260 return file->f_mode & FMODE_WRITE
261 ? filemap_write_and_wait(file->f_mapping) : 0;
264 static int ecryptfs_release(struct inode *inode, struct file *file)
266 ecryptfs_put_lower_file(inode);
267 kmem_cache_free(ecryptfs_file_info_cache,
268 ecryptfs_file_to_private(file));
269 return 0;
272 static int
273 ecryptfs_fsync(struct file *file, loff_t start, loff_t end, int datasync)
275 int rc = 0;
277 rc = generic_file_fsync(file, start, end, datasync);
278 if (rc)
279 goto out;
280 rc = vfs_fsync_range(ecryptfs_file_to_lower(file), start, end,
281 datasync);
282 out:
283 return rc;
286 static int ecryptfs_fasync(int fd, struct file *file, int flag)
288 int rc = 0;
289 struct file *lower_file = NULL;
291 lower_file = ecryptfs_file_to_lower(file);
292 if (lower_file->f_op && lower_file->f_op->fasync)
293 rc = lower_file->f_op->fasync(fd, lower_file, flag);
294 return rc;
297 static long
298 ecryptfs_unlocked_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
300 struct file *lower_file = NULL;
301 long rc = -ENOTTY;
303 if (ecryptfs_file_to_private(file))
304 lower_file = ecryptfs_file_to_lower(file);
305 if (lower_file && lower_file->f_op && lower_file->f_op->unlocked_ioctl)
306 rc = lower_file->f_op->unlocked_ioctl(lower_file, cmd, arg);
307 return rc;
310 #ifdef CONFIG_COMPAT
311 static long
312 ecryptfs_compat_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
314 struct file *lower_file = NULL;
315 long rc = -ENOIOCTLCMD;
317 if (ecryptfs_file_to_private(file))
318 lower_file = ecryptfs_file_to_lower(file);
319 if (lower_file && lower_file->f_op && lower_file->f_op->compat_ioctl)
320 rc = lower_file->f_op->compat_ioctl(lower_file, cmd, arg);
321 return rc;
323 #endif
325 const struct file_operations ecryptfs_dir_fops = {
326 .readdir = ecryptfs_readdir,
327 .read = generic_read_dir,
328 .unlocked_ioctl = ecryptfs_unlocked_ioctl,
329 #ifdef CONFIG_COMPAT
330 .compat_ioctl = ecryptfs_compat_ioctl,
331 #endif
332 .open = ecryptfs_open,
333 .flush = ecryptfs_flush,
334 .release = ecryptfs_release,
335 .fsync = ecryptfs_fsync,
336 .fasync = ecryptfs_fasync,
337 .splice_read = generic_file_splice_read,
338 .llseek = default_llseek,
341 const struct file_operations ecryptfs_main_fops = {
342 .llseek = generic_file_llseek,
343 .read = do_sync_read,
344 .aio_read = ecryptfs_read_update_atime,
345 .write = do_sync_write,
346 .aio_write = generic_file_aio_write,
347 .readdir = ecryptfs_readdir,
348 .unlocked_ioctl = ecryptfs_unlocked_ioctl,
349 #ifdef CONFIG_COMPAT
350 .compat_ioctl = ecryptfs_compat_ioctl,
351 #endif
352 .mmap = generic_file_mmap,
353 .open = ecryptfs_open,
354 .flush = ecryptfs_flush,
355 .release = ecryptfs_release,
356 .fsync = ecryptfs_fsync,
357 .fasync = ecryptfs_fasync,
358 .splice_read = generic_file_splice_read,