/* * LIRC base driver * * by Artur Lipowski * This code is licensed under GNU GPL * */ #ifndef _LINUX_LIRC_DEV_H #define _LINUX_LIRC_DEV_H #define MAX_IRCTL_DEVICES 8 #define BUFLEN 16 #define mod(n, div) ((n) % (div)) #include #include #include #include #include #include struct lirc_buffer { wait_queue_head_t wait_poll; spinlock_t fifo_lock; unsigned int chunk_size; unsigned int size; /* in chunks */ /* Using chunks instead of bytes pretends to simplify boundary checking * And should allow for some performance fine tunning later */ struct kfifo fifo; }; static inline void lirc_buffer_clear(struct lirc_buffer *buf) { unsigned long flags; if (kfifo_initialized(&buf->fifo)) { spin_lock_irqsave(&buf->fifo_lock, flags); kfifo_reset(&buf->fifo); spin_unlock_irqrestore(&buf->fifo_lock, flags); } else WARN(1, "calling %s on an uninitialized lirc_buffer\n", __func__); } static inline int lirc_buffer_init(struct lirc_buffer *buf, unsigned int chunk_size, unsigned int size) { int ret; init_waitqueue_head(&buf->wait_poll); spin_lock_init(&buf->fifo_lock); buf->chunk_size = chunk_size; buf->size = size; ret = kfifo_alloc(&buf->fifo, size * chunk_size, GFP_KERNEL); return ret; } static inline void lirc_buffer_free(struct lirc_buffer *buf) { if (kfifo_initialized(&buf->fifo)) { kfifo_free(&buf->fifo); } else WARN(1, "calling %s on an uninitialized lirc_buffer\n", __func__); } static inline int lirc_buffer_len(struct lirc_buffer *buf) { int len; unsigned long flags; spin_lock_irqsave(&buf->fifo_lock, flags); len = kfifo_len(&buf->fifo); spin_unlock_irqrestore(&buf->fifo_lock, flags); return len; } static inline int lirc_buffer_full(struct lirc_buffer *buf) { return lirc_buffer_len(buf) == buf->size * buf->chunk_size; } static inline int lirc_buffer_empty(struct lirc_buffer *buf) { return !lirc_buffer_len(buf); } static inline int lirc_buffer_available(struct lirc_buffer *buf) { return buf->size - (lirc_buffer_len(buf) / buf->chunk_size); } static inline unsigned int lirc_buffer_read(struct lirc_buffer *buf, unsigned char *dest) { unsigned int ret = 0; if (lirc_buffer_len(buf) >= buf->chunk_size) ret = kfifo_out_locked(&buf->fifo, dest, buf->chunk_size, &buf->fifo_lock); return ret; } static inline unsigned int lirc_buffer_write(struct lirc_buffer *buf, unsigned char *orig) { unsigned int ret; ret = kfifo_in_locked(&buf->fifo, orig, buf->chunk_size, &buf->fifo_lock); return ret; } /** * struct lirc_driver - Defines the parameters on a LIRC driver * * @name: this string will be used for logs * * @minor: indicates minor device (/dev/lirc) number for * registered driver if caller fills it with negative * value, then the first free minor number will be used * (if available). * * @code_length: length of the remote control key code expressed in bits. * * @buffer_size: Number of FIFO buffers with @chunk_size size. If zero, * creates a buffer with BUFLEN size (16 bytes). * * @sample_rate: if zero, the device will wait for an event with a new * code to be parsed. Otherwise, specifies the sample * rate for polling. Value should be between 0 * and HZ. If equal to HZ, it would mean one polling per * second. * * @features: lirc compatible hardware features, like LIRC_MODE_RAW, * LIRC_CAN\_\*, as defined at include/media/lirc.h. * * @chunk_size: Size of each FIFO buffer. * * @data: it may point to any driver data and this pointer will * be passed to all callback functions. * * @min_timeout: Minimum timeout for record. Valid only if * LIRC_CAN_SET_REC_TIMEOUT is defined. * * @max_timeout: Maximum timeout for record. Valid only if * LIRC_CAN_SET_REC_TIMEOUT is defined. * * @add_to_buf: add_to_buf will be called after specified period of the * time or triggered by the external event, this behavior * depends on value of the sample_rate this function will * be called in user context. This routine should return * 0 if data was added to the buffer and -ENODATA if none * was available. This should add some number of bits * evenly divisible by code_length to the buffer. * * @rbuf: if not NULL, it will be used as a read buffer, you will * have to write to the buffer by other means, like irq's * (see also lirc_serial.c). * * @set_use_inc: set_use_inc will be called after device is opened * * @set_use_dec: set_use_dec will be called after device is closed * * @rdev: Pointed to struct rc_dev associated with the LIRC * device. * * @fops: file_operations for drivers which don't fit the current * driver model. * Some ioctl's can be directly handled by lirc_dev if the * driver's ioctl function is NULL or if it returns * -ENOIOCTLCMD (see also lirc_serial.c). * * @dev: pointer to the struct device associated with the LIRC * device. * * @owner: the module owning this struct */ struct lirc_driver { char name[40]; int minor; __u32 code_length; unsigned int buffer_size; /* in chunks holding one code each */ int sample_rate; __u32 features; unsigned int chunk_size; void *data; int min_timeout; int max_timeout; int (*add_to_buf)(void *data, struct lirc_buffer *buf); struct lirc_buffer *rbuf; int (*set_use_inc)(void *data); void (*set_use_dec)(void *data); struct rc_dev *rdev; const struct file_operations *fops; struct device *dev; struct module *owner; }; /* following functions can be called ONLY from user context * * returns negative value on error or minor number * of the registered device if success * contents of the structure pointed by p is copied */ extern int lirc_register_driver(struct lirc_driver *d); /* returns negative value on error or 0 if success */ extern int lirc_unregister_driver(int minor); /* Returns the private data stored in the lirc_driver * associated with the given device file pointer. */ void *lirc_get_pdata(struct file *file); /* default file operations * used by drivers if they override only some operations */ int lirc_dev_fop_open(struct inode *inode, struct file *file); int lirc_dev_fop_close(struct inode *inode, struct file *file); unsigned int lirc_dev_fop_poll(struct file *file, poll_table *wait); long lirc_dev_fop_ioctl(struct file *file, unsigned int cmd, unsigned long arg); ssize_t lirc_dev_fop_read(struct file *file, char __user *buffer, size_t length, loff_t *ppos); ssize_t lirc_dev_fop_write(struct file *file, const char __user *buffer, size_t length, loff_t *ppos); #endif ree_chan_resources'. This avoids the double-lock by acquiring a different lock than `dma_pl330_rqcb'. NOTE that, as a result, `pl330_free_chan_resources' executes `list_splice_tail_init' on `pch->work_list' under lock `pl330->lock', whereas in the rest of the code `pch->work_list' is protected by `pch->lock'. I don't know if this may cause race conditions. Similarly `pch->cyclic' is written by `pl330_alloc_chan_resources' under `pl330->lock' but read by `pl330_tx_submit' under `pch->lock'. Second, I have removed locking from `pl330_request_channel' and `pl330_release_channel' functions. Function `pl330_request_channel' is only called from `pl330_alloc_chan_resources', so the lock is already held. Function `pl330_release_channel' is called from `pl330_free_chan_resources', which already holds the lock, and from `pl330_del'. Function `pl330_del' is called in an error path of `pl330_probe' and at the end of `pl330_remove', but I assume that there cannot be concurrent accesses to the protected data at those points. Signed-off-by: Iago Abal <mail@iagoabal.eu> Reviewed-by: Marek Szyprowski <m.szyprowski@samsung.com> Signed-off-by: Vinod Koul <vinod.koul@intel.com>
Diffstat (limited to 'include/crypto')