Linux Audio

Check our new training course

Loading...
  1/* -*- mode: c; c-basic-offset: 8; -*-
  2 * vim: noexpandtab sw=8 ts=8 sts=0:
  3 *
  4 * file.c - operations for regular (text) files.
  5 *
  6 * This program is free software; you can redistribute it and/or
  7 * modify it under the terms of the GNU General Public
  8 * License as published by the Free Software Foundation; either
  9 * version 2 of the License, or (at your option) any later version.
 10 *
 11 * This program is distributed in the hope that it will be useful,
 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 14 * General Public License for more details.
 15 *
 16 * You should have received a copy of the GNU General Public
 17 * License along with this program; if not, write to the
 18 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 19 * Boston, MA 021110-1307, USA.
 20 *
 21 * Based on sysfs:
 22 * 	sysfs is Copyright (C) 2001, 2002, 2003 Patrick Mochel
 23 *
 24 * configfs Copyright (C) 2005 Oracle.  All rights reserved.
 25 */
 26
 27#include <linux/fs.h>
 28#include <linux/module.h>
 29#include <linux/slab.h>
 30#include <linux/mutex.h>
 31#include <linux/vmalloc.h>
 32#include <asm/uaccess.h>
 33
 34#include <linux/configfs.h>
 35#include "configfs_internal.h"
 36
 37/*
 38 * A simple attribute can only be 4096 characters.  Why 4k?  Because the
 39 * original code limited it to PAGE_SIZE.  That's a bad idea, though,
 40 * because an attribute of 16k on ia64 won't work on x86.  So we limit to
 41 * 4k, our minimum common page size.
 42 */
 43#define SIMPLE_ATTR_SIZE 4096
 44
 45struct configfs_buffer {
 46	size_t			count;
 47	loff_t			pos;
 48	char			* page;
 49	struct configfs_item_operations	* ops;
 50	struct mutex		mutex;
 51	int			needs_read_fill;
 52	bool			read_in_progress;
 53	bool			write_in_progress;
 54	char			*bin_buffer;
 55	int			bin_buffer_size;
 56};
 57
 58
 59/**
 60 *	fill_read_buffer - allocate and fill buffer from item.
 61 *	@dentry:	dentry pointer.
 62 *	@buffer:	data buffer for file.
 63 *
 64 *	Allocate @buffer->page, if it hasn't been already, then call the
 65 *	config_item's show() method to fill the buffer with this attribute's
 66 *	data.
 67 *	This is called only once, on the file's first read.
 68 */
 69static int fill_read_buffer(struct dentry * dentry, struct configfs_buffer * buffer)
 70{
 71	struct configfs_attribute * attr = to_attr(dentry);
 72	struct config_item * item = to_item(dentry->d_parent);
 73	int ret = 0;
 74	ssize_t count;
 75
 76	if (!buffer->page)
 77		buffer->page = (char *) get_zeroed_page(GFP_KERNEL);
 78	if (!buffer->page)
 79		return -ENOMEM;
 80
 81	count = attr->show(item, buffer->page);
 82
 83	buffer->needs_read_fill = 0;
 84	BUG_ON(count > (ssize_t)SIMPLE_ATTR_SIZE);
 85	if (count >= 0)
 86		buffer->count = count;
 87	else
 88		ret = count;
 89	return ret;
 90}
 91
 92/**
 93 *	configfs_read_file - read an attribute.
 94 *	@file:	file pointer.
 95 *	@buf:	buffer to fill.
 96 *	@count:	number of bytes to read.
 97 *	@ppos:	starting offset in file.
 98 *
 99 *	Userspace wants to read an attribute file. The attribute descriptor
100 *	is in the file's ->d_fsdata. The target item is in the directory's
101 *	->d_fsdata.
102 *
103 *	We call fill_read_buffer() to allocate and fill the buffer from the
104 *	item's show() method exactly once (if the read is happening from
105 *	the beginning of the file). That should fill the entire buffer with
106 *	all the data the item has to offer for that attribute.
107 *	We then call flush_read_buffer() to copy the buffer to userspace
108 *	in the increments specified.
109 */
110
111static ssize_t
112configfs_read_file(struct file *file, char __user *buf, size_t count, loff_t *ppos)
113{
114	struct configfs_buffer * buffer = file->private_data;
115	ssize_t retval = 0;
116
117	mutex_lock(&buffer->mutex);
118	if (buffer->needs_read_fill) {
119		if ((retval = fill_read_buffer(file->f_path.dentry,buffer)))
120			goto out;
121	}
122	pr_debug("%s: count = %zd, ppos = %lld, buf = %s\n",
123		 __func__, count, *ppos, buffer->page);
124	retval = simple_read_from_buffer(buf, count, ppos, buffer->page,
125					 buffer->count);
126out:
127	mutex_unlock(&buffer->mutex);
128	return retval;
129}
130
131/**
132 *	configfs_read_bin_file - read a binary attribute.
133 *	@file:	file pointer.
134 *	@buf:	buffer to fill.
135 *	@count:	number of bytes to read.
136 *	@ppos:	starting offset in file.
137 *
138 *	Userspace wants to read a binary attribute file. The attribute
139 *	descriptor is in the file's ->d_fsdata. The target item is in the
140 *	directory's ->d_fsdata.
141 *
142 *	We check whether we need to refill the buffer. If so we will
143 *	call the attributes' attr->read() twice. The first time we
144 *	will pass a NULL as a buffer pointer, which the attributes' method
145 *	will use to return the size of the buffer required. If no error
146 *	occurs we will allocate the buffer using vmalloc and call
147 *	attr->read() again passing that buffer as an argument.
148 *	Then we just copy to user-space using simple_read_from_buffer.
149 */
150
151static ssize_t
152configfs_read_bin_file(struct file *file, char __user *buf,
153		       size_t count, loff_t *ppos)
154{
155	struct configfs_buffer *buffer = file->private_data;
156	struct dentry *dentry = file->f_path.dentry;
157	struct config_item *item = to_item(dentry->d_parent);
158	struct configfs_bin_attribute *bin_attr = to_bin_attr(dentry);
159	ssize_t retval = 0;
160	ssize_t len = min_t(size_t, count, PAGE_SIZE);
161
162	mutex_lock(&buffer->mutex);
163
164	/* we don't support switching read/write modes */
165	if (buffer->write_in_progress) {
166		retval = -ETXTBSY;
167		goto out;
168	}
169	buffer->read_in_progress = 1;
170
171	if (buffer->needs_read_fill) {
172		/* perform first read with buf == NULL to get extent */
173		len = bin_attr->read(item, NULL, 0);
174		if (len <= 0) {
175			retval = len;
176			goto out;
177		}
178
179		/* do not exceed the maximum value */
180		if (bin_attr->cb_max_size && len > bin_attr->cb_max_size) {
181			retval = -EFBIG;
182			goto out;
183		}
184
185		buffer->bin_buffer = vmalloc(len);
186		if (buffer->bin_buffer == NULL) {
187			retval = -ENOMEM;
188			goto out;
189		}
190		buffer->bin_buffer_size = len;
191
192		/* perform second read to fill buffer */
193		len = bin_attr->read(item, buffer->bin_buffer, len);
194		if (len < 0) {
195			retval = len;
196			vfree(buffer->bin_buffer);
197			buffer->bin_buffer_size = 0;
198			buffer->bin_buffer = NULL;
199			goto out;
200		}
201
202		buffer->needs_read_fill = 0;
203	}
204
205	retval = simple_read_from_buffer(buf, count, ppos, buffer->bin_buffer,
206					buffer->bin_buffer_size);
207out:
208	mutex_unlock(&buffer->mutex);
209	return retval;
210}
211
212
213/**
214 *	fill_write_buffer - copy buffer from userspace.
215 *	@buffer:	data buffer for file.
216 *	@buf:		data from user.
217 *	@count:		number of bytes in @userbuf.
218 *
219 *	Allocate @buffer->page if it hasn't been already, then
220 *	copy the user-supplied buffer into it.
221 */
222
223static int
224fill_write_buffer(struct configfs_buffer * buffer, const char __user * buf, size_t count)
225{
226	int error;
227
228	if (!buffer->page)
229		buffer->page = (char *)__get_free_pages(GFP_KERNEL, 0);
230	if (!buffer->page)
231		return -ENOMEM;
232
233	if (count >= SIMPLE_ATTR_SIZE)
234		count = SIMPLE_ATTR_SIZE - 1;
235	error = copy_from_user(buffer->page,buf,count);
236	buffer->needs_read_fill = 1;
237	/* if buf is assumed to contain a string, terminate it by \0,
238	 * so e.g. sscanf() can scan the string easily */
239	buffer->page[count] = 0;
240	return error ? -EFAULT : count;
241}
242
243
244/**
245 *	flush_write_buffer - push buffer to config_item.
246 *	@dentry:	dentry to the attribute
247 *	@buffer:	data buffer for file.
248 *	@count:		number of bytes
249 *
250 *	Get the correct pointers for the config_item and the attribute we're
251 *	dealing with, then call the store() method for the attribute,
252 *	passing the buffer that we acquired in fill_write_buffer().
253 */
254
255static int
256flush_write_buffer(struct dentry * dentry, struct configfs_buffer * buffer, size_t count)
257{
258	struct configfs_attribute * attr = to_attr(dentry);
259	struct config_item * item = to_item(dentry->d_parent);
260
261	return attr->store(item, buffer->page, count);
262}
263
264
265/**
266 *	configfs_write_file - write an attribute.
267 *	@file:	file pointer
268 *	@buf:	data to write
269 *	@count:	number of bytes
270 *	@ppos:	starting offset
271 *
272 *	Similar to configfs_read_file(), though working in the opposite direction.
273 *	We allocate and fill the data from the user in fill_write_buffer(),
274 *	then push it to the config_item in flush_write_buffer().
275 *	There is no easy way for us to know if userspace is only doing a partial
276 *	write, so we don't support them. We expect the entire buffer to come
277 *	on the first write.
278 *	Hint: if you're writing a value, first read the file, modify only the
279 *	the value you're changing, then write entire buffer back.
280 */
281
282static ssize_t
283configfs_write_file(struct file *file, const char __user *buf, size_t count, loff_t *ppos)
284{
285	struct configfs_buffer * buffer = file->private_data;
286	ssize_t len;
287
288	mutex_lock(&buffer->mutex);
289	len = fill_write_buffer(buffer, buf, count);
290	if (len > 0)
291		len = flush_write_buffer(file->f_path.dentry, buffer, len);
292	if (len > 0)
293		*ppos += len;
294	mutex_unlock(&buffer->mutex);
295	return len;
296}
297
298/**
299 *	configfs_write_bin_file - write a binary attribute.
300 *	@file:	file pointer
301 *	@buf:	data to write
302 *	@count:	number of bytes
303 *	@ppos:	starting offset
304 *
305 *	Writing to a binary attribute file is similar to a normal read.
306 *	We buffer the consecutive writes (binary attribute files do not
307 *	support lseek) in a continuously growing buffer, but we don't
308 *	commit until the close of the file.
309 */
310
311static ssize_t
312configfs_write_bin_file(struct file *file, const char __user *buf,
313			size_t count, loff_t *ppos)
314{
315	struct configfs_buffer *buffer = file->private_data;
316	struct dentry *dentry = file->f_path.dentry;
317	struct configfs_bin_attribute *bin_attr = to_bin_attr(dentry);
318	void *tbuf = NULL;
319	ssize_t len;
320
321	mutex_lock(&buffer->mutex);
322
323	/* we don't support switching read/write modes */
324	if (buffer->read_in_progress) {
325		len = -ETXTBSY;
326		goto out;
327	}
328	buffer->write_in_progress = 1;
329
330	/* buffer grows? */
331	if (*ppos + count > buffer->bin_buffer_size) {
332
333		if (bin_attr->cb_max_size &&
334			*ppos + count > bin_attr->cb_max_size) {
335			len = -EFBIG;
336		}
337
338		tbuf = vmalloc(*ppos + count);
339		if (tbuf == NULL) {
340			len = -ENOMEM;
341			goto out;
342		}
343
344		/* copy old contents */
345		if (buffer->bin_buffer) {
346			memcpy(tbuf, buffer->bin_buffer,
347				buffer->bin_buffer_size);
348			vfree(buffer->bin_buffer);
349		}
350
351		/* clear the new area */
352		memset(tbuf + buffer->bin_buffer_size, 0,
353			*ppos + count - buffer->bin_buffer_size);
354		buffer->bin_buffer = tbuf;
355		buffer->bin_buffer_size = *ppos + count;
356	}
357
358	len = simple_write_to_buffer(buffer->bin_buffer,
359			buffer->bin_buffer_size, ppos, buf, count);
360	if (len > 0)
361		*ppos += len;
362out:
363	mutex_unlock(&buffer->mutex);
364	return len;
365}
366
367static int check_perm(struct inode * inode, struct file * file, int type)
368{
369	struct config_item *item = configfs_get_config_item(file->f_path.dentry->d_parent);
370	struct configfs_attribute * attr = to_attr(file->f_path.dentry);
371	struct configfs_bin_attribute *bin_attr = NULL;
372	struct configfs_buffer * buffer;
373	struct configfs_item_operations * ops = NULL;
374	int error = 0;
375
376	if (!item || !attr)
377		goto Einval;
378
379	if (type & CONFIGFS_ITEM_BIN_ATTR)
380		bin_attr = to_bin_attr(file->f_path.dentry);
381
382	/* Grab the module reference for this attribute if we have one */
383	if (!try_module_get(attr->ca_owner)) {
384		error = -ENODEV;
385		goto Done;
386	}
387
388	if (item->ci_type)
389		ops = item->ci_type->ct_item_ops;
390	else
391		goto Eaccess;
392
393	/* File needs write support.
394	 * The inode's perms must say it's ok,
395	 * and we must have a store method.
396	 */
397	if (file->f_mode & FMODE_WRITE) {
398		if (!(inode->i_mode & S_IWUGO))
399			goto Eaccess;
400
401		if ((type & CONFIGFS_ITEM_ATTR) && !attr->store)
402			goto Eaccess;
403
404		if ((type & CONFIGFS_ITEM_BIN_ATTR) && !bin_attr->write)
405			goto Eaccess;
406	}
407
408	/* File needs read support.
409	 * The inode's perms must say it's ok, and we there
410	 * must be a show method for it.
411	 */
412	if (file->f_mode & FMODE_READ) {
413		if (!(inode->i_mode & S_IRUGO))
414			goto Eaccess;
415
416		if ((type & CONFIGFS_ITEM_ATTR) && !attr->show)
417			goto Eaccess;
418
419		if ((type & CONFIGFS_ITEM_BIN_ATTR) && !bin_attr->read)
420			goto Eaccess;
421	}
422
423	/* No error? Great, allocate a buffer for the file, and store it
424	 * it in file->private_data for easy access.
425	 */
426	buffer = kzalloc(sizeof(struct configfs_buffer),GFP_KERNEL);
427	if (!buffer) {
428		error = -ENOMEM;
429		goto Enomem;
430	}
431	mutex_init(&buffer->mutex);
432	buffer->needs_read_fill = 1;
433	buffer->read_in_progress = 0;
434	buffer->write_in_progress = 0;
435	buffer->ops = ops;
436	file->private_data = buffer;
437	goto Done;
438
439 Einval:
440	error = -EINVAL;
441	goto Done;
442 Eaccess:
443	error = -EACCES;
444 Enomem:
445	module_put(attr->ca_owner);
446 Done:
447	if (error && item)
448		config_item_put(item);
449	return error;
450}
451
452static int configfs_release(struct inode *inode, struct file *filp)
453{
454	struct config_item * item = to_item(filp->f_path.dentry->d_parent);
455	struct configfs_attribute * attr = to_attr(filp->f_path.dentry);
456	struct module * owner = attr->ca_owner;
457	struct configfs_buffer * buffer = filp->private_data;
458
459	if (item)
460		config_item_put(item);
461	/* After this point, attr should not be accessed. */
462	module_put(owner);
463
464	if (buffer) {
465		if (buffer->page)
466			free_page((unsigned long)buffer->page);
467		mutex_destroy(&buffer->mutex);
468		kfree(buffer);
469	}
470	return 0;
471}
472
473static int configfs_open_file(struct inode *inode, struct file *filp)
474{
475	return check_perm(inode, filp, CONFIGFS_ITEM_ATTR);
476}
477
478static int configfs_open_bin_file(struct inode *inode, struct file *filp)
479{
480	return check_perm(inode, filp, CONFIGFS_ITEM_BIN_ATTR);
481}
482
483static int configfs_release_bin_file(struct inode *inode, struct file *filp)
484{
485	struct configfs_buffer *buffer = filp->private_data;
486	struct dentry *dentry = filp->f_path.dentry;
487	struct config_item *item = to_item(dentry->d_parent);
488	struct configfs_bin_attribute *bin_attr = to_bin_attr(dentry);
489	ssize_t len = 0;
490	int ret;
491
492	buffer->read_in_progress = 0;
493
494	if (buffer->write_in_progress) {
495		buffer->write_in_progress = 0;
496
497		len = bin_attr->write(item, buffer->bin_buffer,
498				buffer->bin_buffer_size);
499
500		/* vfree on NULL is safe */
501		vfree(buffer->bin_buffer);
502		buffer->bin_buffer = NULL;
503		buffer->bin_buffer_size = 0;
504		buffer->needs_read_fill = 1;
505	}
506
507	ret = configfs_release(inode, filp);
508	if (len < 0)
509		return len;
510	return ret;
511}
512
513
514const struct file_operations configfs_file_operations = {
515	.read		= configfs_read_file,
516	.write		= configfs_write_file,
517	.llseek		= generic_file_llseek,
518	.open		= configfs_open_file,
519	.release	= configfs_release,
520};
521
522const struct file_operations configfs_bin_file_operations = {
523	.read		= configfs_read_bin_file,
524	.write		= configfs_write_bin_file,
525	.llseek		= NULL,		/* bin file is not seekable */
526	.open		= configfs_open_bin_file,
527	.release	= configfs_release_bin_file,
528};
529
530/**
531 *	configfs_create_file - create an attribute file for an item.
532 *	@item:	item we're creating for.
533 *	@attr:	atrribute descriptor.
534 */
535
536int configfs_create_file(struct config_item * item, const struct configfs_attribute * attr)
537{
538	struct dentry *dir = item->ci_dentry;
539	struct configfs_dirent *parent_sd = dir->d_fsdata;
540	umode_t mode = (attr->ca_mode & S_IALLUGO) | S_IFREG;
541	int error = 0;
542
543	inode_lock_nested(d_inode(dir), I_MUTEX_NORMAL);
544	error = configfs_make_dirent(parent_sd, NULL, (void *) attr, mode,
545				     CONFIGFS_ITEM_ATTR);
546	inode_unlock(d_inode(dir));
547
548	return error;
549}
550
551/**
552 *	configfs_create_bin_file - create a binary attribute file for an item.
553 *	@item:	item we're creating for.
554 *	@attr:	atrribute descriptor.
555 */
556
557int configfs_create_bin_file(struct config_item *item,
558		const struct configfs_bin_attribute *bin_attr)
559{
560	struct dentry *dir = item->ci_dentry;
561	struct configfs_dirent *parent_sd = dir->d_fsdata;
562	umode_t mode = (bin_attr->cb_attr.ca_mode & S_IALLUGO) | S_IFREG;
563	int error = 0;
564
565	inode_lock_nested(dir->d_inode, I_MUTEX_NORMAL);
566	error = configfs_make_dirent(parent_sd, NULL, (void *) bin_attr, mode,
567				     CONFIGFS_ITEM_BIN_ATTR);
568	inode_unlock(dir->d_inode);
569
570	return error;
571}
  1// SPDX-License-Identifier: GPL-2.0-or-later
  2/* -*- mode: c; c-basic-offset: 8; -*-
  3 * vim: noexpandtab sw=8 ts=8 sts=0:
  4 *
  5 * file.c - operations for regular (text) files.
  6 *
  7 * Based on sysfs:
  8 * 	sysfs is Copyright (C) 2001, 2002, 2003 Patrick Mochel
  9 *
 10 * configfs Copyright (C) 2005 Oracle.  All rights reserved.
 11 */
 12
 13#include <linux/fs.h>
 14#include <linux/module.h>
 15#include <linux/slab.h>
 16#include <linux/mutex.h>
 17#include <linux/vmalloc.h>
 18#include <linux/uaccess.h>
 19
 20#include <linux/configfs.h>
 21#include "configfs_internal.h"
 22
 23/*
 24 * A simple attribute can only be 4096 characters.  Why 4k?  Because the
 25 * original code limited it to PAGE_SIZE.  That's a bad idea, though,
 26 * because an attribute of 16k on ia64 won't work on x86.  So we limit to
 27 * 4k, our minimum common page size.
 28 */
 29#define SIMPLE_ATTR_SIZE 4096
 30
 31struct configfs_buffer {
 32	size_t			count;
 33	loff_t			pos;
 34	char			* page;
 35	struct configfs_item_operations	* ops;
 36	struct mutex		mutex;
 37	int			needs_read_fill;
 38	bool			read_in_progress;
 39	bool			write_in_progress;
 40	char			*bin_buffer;
 41	int			bin_buffer_size;
 42	int			cb_max_size;
 43	struct config_item	*item;
 44	struct module		*owner;
 45	union {
 46		struct configfs_attribute	*attr;
 47		struct configfs_bin_attribute	*bin_attr;
 48	};
 49};
 50
 51static inline struct configfs_fragment *to_frag(struct file *file)
 52{
 53	struct configfs_dirent *sd = file->f_path.dentry->d_fsdata;
 54
 55	return sd->s_frag;
 56}
 57
 58static int fill_read_buffer(struct file *file, struct configfs_buffer *buffer)
 59{
 60	struct configfs_fragment *frag = to_frag(file);
 61	ssize_t count = -ENOENT;
 62
 63	if (!buffer->page)
 64		buffer->page = (char *) get_zeroed_page(GFP_KERNEL);
 65	if (!buffer->page)
 66		return -ENOMEM;
 67
 68	down_read(&frag->frag_sem);
 69	if (!frag->frag_dead)
 70		count = buffer->attr->show(buffer->item, buffer->page);
 71	up_read(&frag->frag_sem);
 72
 73	if (count < 0)
 74		return count;
 75	if (WARN_ON_ONCE(count > (ssize_t)SIMPLE_ATTR_SIZE))
 76		return -EIO;
 77	buffer->needs_read_fill = 0;
 78	buffer->count = count;
 79	return 0;
 80}
 81
 82/**
 83 *	configfs_read_file - read an attribute.
 84 *	@file:	file pointer.
 85 *	@buf:	buffer to fill.
 86 *	@count:	number of bytes to read.
 87 *	@ppos:	starting offset in file.
 88 *
 89 *	Userspace wants to read an attribute file. The attribute descriptor
 90 *	is in the file's ->d_fsdata. The target item is in the directory's
 91 *	->d_fsdata.
 92 *
 93 *	We call fill_read_buffer() to allocate and fill the buffer from the
 94 *	item's show() method exactly once (if the read is happening from
 95 *	the beginning of the file). That should fill the entire buffer with
 96 *	all the data the item has to offer for that attribute.
 97 *	We then call flush_read_buffer() to copy the buffer to userspace
 98 *	in the increments specified.
 99 */
100
101static ssize_t
102configfs_read_file(struct file *file, char __user *buf, size_t count, loff_t *ppos)
103{
104	struct configfs_buffer *buffer = file->private_data;
105	ssize_t retval = 0;
106
107	mutex_lock(&buffer->mutex);
108	if (buffer->needs_read_fill) {
109		retval = fill_read_buffer(file, buffer);
110		if (retval)
111			goto out;
112	}
113	pr_debug("%s: count = %zd, ppos = %lld, buf = %s\n",
114		 __func__, count, *ppos, buffer->page);
115	retval = simple_read_from_buffer(buf, count, ppos, buffer->page,
116					 buffer->count);
117out:
118	mutex_unlock(&buffer->mutex);
119	return retval;
120}
121
122/**
123 *	configfs_read_bin_file - read a binary attribute.
124 *	@file:	file pointer.
125 *	@buf:	buffer to fill.
126 *	@count:	number of bytes to read.
127 *	@ppos:	starting offset in file.
128 *
129 *	Userspace wants to read a binary attribute file. The attribute
130 *	descriptor is in the file's ->d_fsdata. The target item is in the
131 *	directory's ->d_fsdata.
132 *
133 *	We check whether we need to refill the buffer. If so we will
134 *	call the attributes' attr->read() twice. The first time we
135 *	will pass a NULL as a buffer pointer, which the attributes' method
136 *	will use to return the size of the buffer required. If no error
137 *	occurs we will allocate the buffer using vmalloc and call
138 *	attr->read() again passing that buffer as an argument.
139 *	Then we just copy to user-space using simple_read_from_buffer.
140 */
141
142static ssize_t
143configfs_read_bin_file(struct file *file, char __user *buf,
144		       size_t count, loff_t *ppos)
145{
146	struct configfs_fragment *frag = to_frag(file);
147	struct configfs_buffer *buffer = file->private_data;
148	ssize_t retval = 0;
149	ssize_t len = min_t(size_t, count, PAGE_SIZE);
150
151	mutex_lock(&buffer->mutex);
152
153	/* we don't support switching read/write modes */
154	if (buffer->write_in_progress) {
155		retval = -ETXTBSY;
156		goto out;
157	}
158	buffer->read_in_progress = true;
159
160	if (buffer->needs_read_fill) {
161		/* perform first read with buf == NULL to get extent */
162		down_read(&frag->frag_sem);
163		if (!frag->frag_dead)
164			len = buffer->bin_attr->read(buffer->item, NULL, 0);
165		else
166			len = -ENOENT;
167		up_read(&frag->frag_sem);
168		if (len <= 0) {
169			retval = len;
170			goto out;
171		}
172
173		/* do not exceed the maximum value */
174		if (buffer->cb_max_size && len > buffer->cb_max_size) {
175			retval = -EFBIG;
176			goto out;
177		}
178
179		buffer->bin_buffer = vmalloc(len);
180		if (buffer->bin_buffer == NULL) {
181			retval = -ENOMEM;
182			goto out;
183		}
184		buffer->bin_buffer_size = len;
185
186		/* perform second read to fill buffer */
187		down_read(&frag->frag_sem);
188		if (!frag->frag_dead)
189			len = buffer->bin_attr->read(buffer->item,
190						     buffer->bin_buffer, len);
191		else
192			len = -ENOENT;
193		up_read(&frag->frag_sem);
194		if (len < 0) {
195			retval = len;
196			vfree(buffer->bin_buffer);
197			buffer->bin_buffer_size = 0;
198			buffer->bin_buffer = NULL;
199			goto out;
200		}
201
202		buffer->needs_read_fill = 0;
203	}
204
205	retval = simple_read_from_buffer(buf, count, ppos, buffer->bin_buffer,
206					buffer->bin_buffer_size);
207out:
208	mutex_unlock(&buffer->mutex);
209	return retval;
210}
211
212
213/**
214 *	fill_write_buffer - copy buffer from userspace.
215 *	@buffer:	data buffer for file.
216 *	@buf:		data from user.
217 *	@count:		number of bytes in @userbuf.
218 *
219 *	Allocate @buffer->page if it hasn't been already, then
220 *	copy the user-supplied buffer into it.
221 */
222
223static int
224fill_write_buffer(struct configfs_buffer * buffer, const char __user * buf, size_t count)
225{
226	int error;
227
228	if (!buffer->page)
229		buffer->page = (char *)__get_free_pages(GFP_KERNEL, 0);
230	if (!buffer->page)
231		return -ENOMEM;
232
233	if (count >= SIMPLE_ATTR_SIZE)
234		count = SIMPLE_ATTR_SIZE - 1;
235	error = copy_from_user(buffer->page,buf,count);
236	buffer->needs_read_fill = 1;
237	/* if buf is assumed to contain a string, terminate it by \0,
238	 * so e.g. sscanf() can scan the string easily */
239	buffer->page[count] = 0;
240	return error ? -EFAULT : count;
241}
242
243static int
244flush_write_buffer(struct file *file, struct configfs_buffer *buffer, size_t count)
245{
246	struct configfs_fragment *frag = to_frag(file);
247	int res = -ENOENT;
248
249	down_read(&frag->frag_sem);
250	if (!frag->frag_dead)
251		res = buffer->attr->store(buffer->item, buffer->page, count);
252	up_read(&frag->frag_sem);
253	return res;
254}
255
256
257/**
258 *	configfs_write_file - write an attribute.
259 *	@file:	file pointer
260 *	@buf:	data to write
261 *	@count:	number of bytes
262 *	@ppos:	starting offset
263 *
264 *	Similar to configfs_read_file(), though working in the opposite direction.
265 *	We allocate and fill the data from the user in fill_write_buffer(),
266 *	then push it to the config_item in flush_write_buffer().
267 *	There is no easy way for us to know if userspace is only doing a partial
268 *	write, so we don't support them. We expect the entire buffer to come
269 *	on the first write.
270 *	Hint: if you're writing a value, first read the file, modify only the
271 *	the value you're changing, then write entire buffer back.
272 */
273
274static ssize_t
275configfs_write_file(struct file *file, const char __user *buf, size_t count, loff_t *ppos)
276{
277	struct configfs_buffer *buffer = file->private_data;
278	ssize_t len;
279
280	mutex_lock(&buffer->mutex);
281	len = fill_write_buffer(buffer, buf, count);
282	if (len > 0)
283		len = flush_write_buffer(file, buffer, len);
284	if (len > 0)
285		*ppos += len;
286	mutex_unlock(&buffer->mutex);
287	return len;
288}
289
290/**
291 *	configfs_write_bin_file - write a binary attribute.
292 *	@file:	file pointer
293 *	@buf:	data to write
294 *	@count:	number of bytes
295 *	@ppos:	starting offset
296 *
297 *	Writing to a binary attribute file is similar to a normal read.
298 *	We buffer the consecutive writes (binary attribute files do not
299 *	support lseek) in a continuously growing buffer, but we don't
300 *	commit until the close of the file.
301 */
302
303static ssize_t
304configfs_write_bin_file(struct file *file, const char __user *buf,
305			size_t count, loff_t *ppos)
306{
307	struct configfs_buffer *buffer = file->private_data;
308	void *tbuf = NULL;
309	ssize_t len;
310
311	mutex_lock(&buffer->mutex);
312
313	/* we don't support switching read/write modes */
314	if (buffer->read_in_progress) {
315		len = -ETXTBSY;
316		goto out;
317	}
318	buffer->write_in_progress = true;
319
320	/* buffer grows? */
321	if (*ppos + count > buffer->bin_buffer_size) {
322
323		if (buffer->cb_max_size &&
324			*ppos + count > buffer->cb_max_size) {
325			len = -EFBIG;
326			goto out;
327		}
328
329		tbuf = vmalloc(*ppos + count);
330		if (tbuf == NULL) {
331			len = -ENOMEM;
332			goto out;
333		}
334
335		/* copy old contents */
336		if (buffer->bin_buffer) {
337			memcpy(tbuf, buffer->bin_buffer,
338				buffer->bin_buffer_size);
339			vfree(buffer->bin_buffer);
340		}
341
342		/* clear the new area */
343		memset(tbuf + buffer->bin_buffer_size, 0,
344			*ppos + count - buffer->bin_buffer_size);
345		buffer->bin_buffer = tbuf;
346		buffer->bin_buffer_size = *ppos + count;
347	}
348
349	len = simple_write_to_buffer(buffer->bin_buffer,
350			buffer->bin_buffer_size, ppos, buf, count);
351out:
352	mutex_unlock(&buffer->mutex);
353	return len;
354}
355
356static int __configfs_open_file(struct inode *inode, struct file *file, int type)
357{
358	struct dentry *dentry = file->f_path.dentry;
359	struct configfs_fragment *frag = to_frag(file);
360	struct configfs_attribute *attr;
361	struct configfs_buffer *buffer;
362	int error;
363
364	error = -ENOMEM;
365	buffer = kzalloc(sizeof(struct configfs_buffer), GFP_KERNEL);
366	if (!buffer)
367		goto out;
368
369	error = -ENOENT;
370	down_read(&frag->frag_sem);
371	if (unlikely(frag->frag_dead))
372		goto out_free_buffer;
373
374	error = -EINVAL;
375	buffer->item = to_item(dentry->d_parent);
376	if (!buffer->item)
377		goto out_free_buffer;
378
379	attr = to_attr(dentry);
380	if (!attr)
381		goto out_put_item;
382
383	if (type & CONFIGFS_ITEM_BIN_ATTR) {
384		buffer->bin_attr = to_bin_attr(dentry);
385		buffer->cb_max_size = buffer->bin_attr->cb_max_size;
386	} else {
387		buffer->attr = attr;
388	}
389
390	buffer->owner = attr->ca_owner;
391	/* Grab the module reference for this attribute if we have one */
392	error = -ENODEV;
393	if (!try_module_get(buffer->owner))
394		goto out_put_item;
395
396	error = -EACCES;
397	if (!buffer->item->ci_type)
398		goto out_put_module;
399
400	buffer->ops = buffer->item->ci_type->ct_item_ops;
401
402	/* File needs write support.
403	 * The inode's perms must say it's ok,
404	 * and we must have a store method.
405	 */
406	if (file->f_mode & FMODE_WRITE) {
407		if (!(inode->i_mode & S_IWUGO))
408			goto out_put_module;
409		if ((type & CONFIGFS_ITEM_ATTR) && !attr->store)
410			goto out_put_module;
411		if ((type & CONFIGFS_ITEM_BIN_ATTR) && !buffer->bin_attr->write)
412			goto out_put_module;
413	}
414
415	/* File needs read support.
416	 * The inode's perms must say it's ok, and we there
417	 * must be a show method for it.
418	 */
419	if (file->f_mode & FMODE_READ) {
420		if (!(inode->i_mode & S_IRUGO))
421			goto out_put_module;
422		if ((type & CONFIGFS_ITEM_ATTR) && !attr->show)
423			goto out_put_module;
424		if ((type & CONFIGFS_ITEM_BIN_ATTR) && !buffer->bin_attr->read)
425			goto out_put_module;
426	}
427
428	mutex_init(&buffer->mutex);
429	buffer->needs_read_fill = 1;
430	buffer->read_in_progress = false;
431	buffer->write_in_progress = false;
432	file->private_data = buffer;
433	up_read(&frag->frag_sem);
434	return 0;
435
436out_put_module:
437	module_put(buffer->owner);
438out_put_item:
439	config_item_put(buffer->item);
440out_free_buffer:
441	up_read(&frag->frag_sem);
442	kfree(buffer);
443out:
444	return error;
445}
446
447static int configfs_release(struct inode *inode, struct file *filp)
448{
449	struct configfs_buffer *buffer = filp->private_data;
450
451	module_put(buffer->owner);
452	if (buffer->page)
453		free_page((unsigned long)buffer->page);
454	mutex_destroy(&buffer->mutex);
455	kfree(buffer);
456	return 0;
457}
458
459static int configfs_open_file(struct inode *inode, struct file *filp)
460{
461	return __configfs_open_file(inode, filp, CONFIGFS_ITEM_ATTR);
462}
463
464static int configfs_open_bin_file(struct inode *inode, struct file *filp)
465{
466	return __configfs_open_file(inode, filp, CONFIGFS_ITEM_BIN_ATTR);
467}
468
469static int configfs_release_bin_file(struct inode *inode, struct file *file)
470{
471	struct configfs_buffer *buffer = file->private_data;
472
473	buffer->read_in_progress = false;
474
475	if (buffer->write_in_progress) {
476		struct configfs_fragment *frag = to_frag(file);
477		buffer->write_in_progress = false;
478
479		down_read(&frag->frag_sem);
480		if (!frag->frag_dead) {
481			/* result of ->release() is ignored */
482			buffer->bin_attr->write(buffer->item,
483					buffer->bin_buffer,
484					buffer->bin_buffer_size);
485		}
486		up_read(&frag->frag_sem);
487		/* vfree on NULL is safe */
488		vfree(buffer->bin_buffer);
489		buffer->bin_buffer = NULL;
490		buffer->bin_buffer_size = 0;
491		buffer->needs_read_fill = 1;
492	}
493
494	configfs_release(inode, file);
495	return 0;
496}
497
498
499const struct file_operations configfs_file_operations = {
500	.read		= configfs_read_file,
501	.write		= configfs_write_file,
502	.llseek		= generic_file_llseek,
503	.open		= configfs_open_file,
504	.release	= configfs_release,
505};
506
507const struct file_operations configfs_bin_file_operations = {
508	.read		= configfs_read_bin_file,
509	.write		= configfs_write_bin_file,
510	.llseek		= NULL,		/* bin file is not seekable */
511	.open		= configfs_open_bin_file,
512	.release	= configfs_release_bin_file,
513};
514
515/**
516 *	configfs_create_file - create an attribute file for an item.
517 *	@item:	item we're creating for.
518 *	@attr:	atrribute descriptor.
519 */
520
521int configfs_create_file(struct config_item * item, const struct configfs_attribute * attr)
522{
523	struct dentry *dir = item->ci_dentry;
524	struct configfs_dirent *parent_sd = dir->d_fsdata;
525	umode_t mode = (attr->ca_mode & S_IALLUGO) | S_IFREG;
526	int error = 0;
527
528	inode_lock_nested(d_inode(dir), I_MUTEX_NORMAL);
529	error = configfs_make_dirent(parent_sd, NULL, (void *) attr, mode,
530				     CONFIGFS_ITEM_ATTR, parent_sd->s_frag);
531	inode_unlock(d_inode(dir));
532
533	return error;
534}
535
536/**
537 *	configfs_create_bin_file - create a binary attribute file for an item.
538 *	@item:	item we're creating for.
539 *	@attr:	atrribute descriptor.
540 */
541
542int configfs_create_bin_file(struct config_item *item,
543		const struct configfs_bin_attribute *bin_attr)
544{
545	struct dentry *dir = item->ci_dentry;
546	struct configfs_dirent *parent_sd = dir->d_fsdata;
547	umode_t mode = (bin_attr->cb_attr.ca_mode & S_IALLUGO) | S_IFREG;
548	int error = 0;
549
550	inode_lock_nested(dir->d_inode, I_MUTEX_NORMAL);
551	error = configfs_make_dirent(parent_sd, NULL, (void *) bin_attr, mode,
552				     CONFIGFS_ITEM_BIN_ATTR, parent_sd->s_frag);
553	inode_unlock(dir->d_inode);
554
555	return error;
556}