![Sakari Ailus](/assets/img/avatar_default.png)
Drop the FSF's postal address from the source code files that typically contain mostly the license text. Of the 628 removed instances, 578 are outdated. The patch has been created with the following command without manual edits: git grep -l "675 Mass Ave\|59 Temple Place\|51 Franklin St" -- \ drivers/media/ include/media|while read i; do i=$i perl -e ' open(F,"< $ENV{i}"); $a=join("", <F>); $a =~ s/[ \t]*\*\n.*You should.*\n.*along with.*\n.*(\n.*USA.*$)?\n//m && $a =~ s/(^.*)Or, (point your browser to) /$1To obtain the license, $2\n$1/m; close(F); open(F, "> $ENV{i}"); print F $a; close(F);'; done Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
319 lines
9.8 KiB
C
319 lines
9.8 KiB
C
/*
|
|
* dvbdev.h
|
|
*
|
|
* Copyright (C) 2000 Ralph Metzler & Marcus Metzler
|
|
* for convergence integrated media GmbH
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Lesser Public License
|
|
* as published by the Free Software Foundation; either version 2.1
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
*/
|
|
|
|
#ifndef _DVBDEV_H_
|
|
#define _DVBDEV_H_
|
|
|
|
#include <linux/types.h>
|
|
#include <linux/poll.h>
|
|
#include <linux/fs.h>
|
|
#include <linux/list.h>
|
|
#include <media/media-device.h>
|
|
|
|
#define DVB_MAJOR 212
|
|
|
|
#if defined(CONFIG_DVB_MAX_ADAPTERS) && CONFIG_DVB_MAX_ADAPTERS > 0
|
|
#define DVB_MAX_ADAPTERS CONFIG_DVB_MAX_ADAPTERS
|
|
#else
|
|
#define DVB_MAX_ADAPTERS 16
|
|
#endif
|
|
|
|
#define DVB_UNSET (-1)
|
|
|
|
#define DVB_DEVICE_VIDEO 0
|
|
#define DVB_DEVICE_AUDIO 1
|
|
#define DVB_DEVICE_SEC 2
|
|
#define DVB_DEVICE_FRONTEND 3
|
|
#define DVB_DEVICE_DEMUX 4
|
|
#define DVB_DEVICE_DVR 5
|
|
#define DVB_DEVICE_CA 6
|
|
#define DVB_DEVICE_NET 7
|
|
#define DVB_DEVICE_OSD 8
|
|
|
|
#define DVB_DEFINE_MOD_OPT_ADAPTER_NR(adapter_nr) \
|
|
static short adapter_nr[] = \
|
|
{[0 ... (DVB_MAX_ADAPTERS - 1)] = DVB_UNSET }; \
|
|
module_param_array(adapter_nr, short, NULL, 0444); \
|
|
MODULE_PARM_DESC(adapter_nr, "DVB adapter numbers")
|
|
|
|
struct dvb_frontend;
|
|
|
|
/**
|
|
* struct dvb_adapter - represents a Digital TV adapter using Linux DVB API
|
|
*
|
|
* @num: Number of the adapter
|
|
* @list_head: List with the DVB adapters
|
|
* @device_list: List with the DVB devices
|
|
* @name: Name of the adapter
|
|
* @proposed_mac: proposed MAC address for the adapter
|
|
* @priv: private data
|
|
* @device: pointer to struct device
|
|
* @module: pointer to struct module
|
|
* @mfe_shared: mfe shared: indicates mutually exclusive frontends
|
|
* Thie usage of this flag is currently deprecated
|
|
* @mfe_dvbdev: Frontend device in use, in the case of MFE
|
|
* @mfe_lock: Lock to prevent using the other frontends when MFE is
|
|
* used.
|
|
* @mdev: pointer to struct media_device, used when the media
|
|
* controller is used.
|
|
* @conn: RF connector. Used only if the device has no separate
|
|
* tuner.
|
|
* @conn_pads: pointer to struct media_pad associated with @conn;
|
|
*/
|
|
struct dvb_adapter {
|
|
int num;
|
|
struct list_head list_head;
|
|
struct list_head device_list;
|
|
const char *name;
|
|
u8 proposed_mac [6];
|
|
void* priv;
|
|
|
|
struct device *device;
|
|
|
|
struct module *module;
|
|
|
|
int mfe_shared; /* indicates mutually exclusive frontends */
|
|
struct dvb_device *mfe_dvbdev; /* frontend device in use */
|
|
struct mutex mfe_lock; /* access lock for thread creation */
|
|
|
|
#if defined(CONFIG_MEDIA_CONTROLLER_DVB)
|
|
struct media_device *mdev;
|
|
struct media_entity *conn;
|
|
struct media_pad *conn_pads;
|
|
#endif
|
|
};
|
|
|
|
/**
|
|
* struct dvb_device - represents a DVB device node
|
|
*
|
|
* @list_head: List head with all DVB devices
|
|
* @fops: pointer to struct file_operations
|
|
* @adapter: pointer to the adapter that holds this device node
|
|
* @type: type of the device: DVB_DEVICE_SEC, DVB_DEVICE_FRONTEND,
|
|
* DVB_DEVICE_DEMUX, DVB_DEVICE_DVR, DVB_DEVICE_CA, DVB_DEVICE_NET
|
|
* @minor: devnode minor number. Major number is always DVB_MAJOR.
|
|
* @id: device ID number, inside the adapter
|
|
* @readers: Initialized by the caller. Each call to open() in Read Only mode
|
|
* decreases this counter by one.
|
|
* @writers: Initialized by the caller. Each call to open() in Read/Write
|
|
* mode decreases this counter by one.
|
|
* @users: Initialized by the caller. Each call to open() in any mode
|
|
* decreases this counter by one.
|
|
* @wait_queue: wait queue, used to wait for certain events inside one of
|
|
* the DVB API callers
|
|
* @kernel_ioctl: callback function used to handle ioctl calls from userspace.
|
|
* @name: Name to be used for the device at the Media Controller
|
|
* @entity: pointer to struct media_entity associated with the device node
|
|
* @pads: pointer to struct media_pad associated with @entity;
|
|
* @priv: private data
|
|
* @intf_devnode: Pointer to media_intf_devnode. Used by the dvbdev core to
|
|
* store the MC device node interface
|
|
* @tsout_num_entities: Number of Transport Stream output entities
|
|
* @tsout_entity: array with MC entities associated to each TS output node
|
|
* @tsout_pads: array with the source pads for each @tsout_entity
|
|
*
|
|
* This structure is used by the DVB core (frontend, CA, net, demux) in
|
|
* order to create the device nodes. Usually, driver should not initialize
|
|
* this struct diretly.
|
|
*/
|
|
struct dvb_device {
|
|
struct list_head list_head;
|
|
const struct file_operations *fops;
|
|
struct dvb_adapter *adapter;
|
|
int type;
|
|
int minor;
|
|
u32 id;
|
|
|
|
/* in theory, 'users' can vanish now,
|
|
but I don't want to change too much now... */
|
|
int readers;
|
|
int writers;
|
|
int users;
|
|
|
|
wait_queue_head_t wait_queue;
|
|
/* don't really need those !? -- FIXME: use video_usercopy */
|
|
int (*kernel_ioctl)(struct file *file, unsigned int cmd, void *arg);
|
|
|
|
/* Needed for media controller register/unregister */
|
|
#if defined(CONFIG_MEDIA_CONTROLLER_DVB)
|
|
const char *name;
|
|
|
|
/* Allocated and filled inside dvbdev.c */
|
|
struct media_intf_devnode *intf_devnode;
|
|
|
|
unsigned tsout_num_entities;
|
|
struct media_entity *entity, *tsout_entity;
|
|
struct media_pad *pads, *tsout_pads;
|
|
#endif
|
|
|
|
void *priv;
|
|
};
|
|
|
|
/**
|
|
* dvb_register_adapter - Registers a new DVB adapter
|
|
*
|
|
* @adap: pointer to struct dvb_adapter
|
|
* @name: Adapter's name
|
|
* @module: initialized with THIS_MODULE at the caller
|
|
* @device: pointer to struct device that corresponds to the device driver
|
|
* @adapter_nums: Array with a list of the numbers for @dvb_register_adapter;
|
|
* to select among them. Typically, initialized with:
|
|
* DVB_DEFINE_MOD_OPT_ADAPTER_NR(adapter_nums)
|
|
*/
|
|
int dvb_register_adapter(struct dvb_adapter *adap, const char *name,
|
|
struct module *module, struct device *device,
|
|
short *adapter_nums);
|
|
|
|
/**
|
|
* dvb_unregister_adapter - Unregisters a DVB adapter
|
|
*
|
|
* @adap: pointer to struct dvb_adapter
|
|
*/
|
|
int dvb_unregister_adapter(struct dvb_adapter *adap);
|
|
|
|
/**
|
|
* dvb_register_device - Registers a new DVB device
|
|
*
|
|
* @adap: pointer to struct dvb_adapter
|
|
* @pdvbdev: pointer to the place where the new struct dvb_device will be
|
|
* stored
|
|
* @template: Template used to create &pdvbdev;
|
|
* @priv: private data
|
|
* @type: type of the device: %DVB_DEVICE_SEC, %DVB_DEVICE_FRONTEND,
|
|
* %DVB_DEVICE_DEMUX, %DVB_DEVICE_DVR, %DVB_DEVICE_CA,
|
|
* %DVB_DEVICE_NET
|
|
* @demux_sink_pads: Number of demux outputs, to be used to create the TS
|
|
* outputs via the Media Controller.
|
|
*/
|
|
int dvb_register_device(struct dvb_adapter *adap,
|
|
struct dvb_device **pdvbdev,
|
|
const struct dvb_device *template,
|
|
void *priv,
|
|
int type,
|
|
int demux_sink_pads);
|
|
|
|
/**
|
|
* dvb_remove_device - Remove a registered DVB device
|
|
*
|
|
* This does not free memory. To do that, call dvb_free_device().
|
|
*
|
|
* @dvbdev: pointer to struct dvb_device
|
|
*/
|
|
void dvb_remove_device(struct dvb_device *dvbdev);
|
|
|
|
/**
|
|
* dvb_free_device - Free memory occupied by a DVB device.
|
|
*
|
|
* Call dvb_unregister_device() before calling this function.
|
|
*
|
|
* @dvbdev: pointer to struct dvb_device
|
|
*/
|
|
void dvb_free_device(struct dvb_device *dvbdev);
|
|
|
|
/**
|
|
* dvb_unregister_device - Unregisters a DVB device
|
|
*
|
|
* This is a combination of dvb_remove_device() and dvb_free_device().
|
|
* Using this function is usually a mistake, and is often an indicator
|
|
* for a use-after-free bug (when a userspace process keeps a file
|
|
* handle to a detached device).
|
|
*
|
|
* @dvbdev: pointer to struct dvb_device
|
|
*/
|
|
void dvb_unregister_device(struct dvb_device *dvbdev);
|
|
|
|
#ifdef CONFIG_MEDIA_CONTROLLER_DVB
|
|
/**
|
|
* dvb_create_media_graph - Creates media graph for the Digital TV part of the
|
|
* device.
|
|
*
|
|
* @adap: pointer to struct dvb_adapter
|
|
* @create_rf_connector: if true, it creates the RF connector too
|
|
*
|
|
* This function checks all DVB-related functions at the media controller
|
|
* entities and creates the needed links for the media graph. It is
|
|
* capable of working with multiple tuners or multiple frontends, but it
|
|
* won't create links if the device has multiple tuners and multiple frontends
|
|
* or if the device has multiple muxes. In such case, the caller driver should
|
|
* manually create the remaining links.
|
|
*/
|
|
__must_check int dvb_create_media_graph(struct dvb_adapter *adap,
|
|
bool create_rf_connector);
|
|
|
|
static inline void dvb_register_media_controller(struct dvb_adapter *adap,
|
|
struct media_device *mdev)
|
|
{
|
|
adap->mdev = mdev;
|
|
}
|
|
|
|
static inline struct media_device
|
|
*dvb_get_media_controller(struct dvb_adapter *adap)
|
|
{
|
|
return adap->mdev;
|
|
}
|
|
#else
|
|
static inline
|
|
int dvb_create_media_graph(struct dvb_adapter *adap,
|
|
bool create_rf_connector)
|
|
{
|
|
return 0;
|
|
};
|
|
#define dvb_register_media_controller(a, b) {}
|
|
#define dvb_get_media_controller(a) NULL
|
|
#endif
|
|
|
|
int dvb_generic_open (struct inode *inode, struct file *file);
|
|
int dvb_generic_release (struct inode *inode, struct file *file);
|
|
long dvb_generic_ioctl (struct file *file,
|
|
unsigned int cmd, unsigned long arg);
|
|
|
|
/* we don't mess with video_usercopy() any more,
|
|
we simply define out own dvb_usercopy(), which will hopefully become
|
|
generic_usercopy() someday... */
|
|
|
|
int dvb_usercopy(struct file *file, unsigned int cmd, unsigned long arg,
|
|
int (*func)(struct file *file, unsigned int cmd, void *arg));
|
|
|
|
/** generic DVB attach function. */
|
|
#ifdef CONFIG_MEDIA_ATTACH
|
|
#define dvb_attach(FUNCTION, ARGS...) ({ \
|
|
void *__r = NULL; \
|
|
typeof(&FUNCTION) __a = symbol_request(FUNCTION); \
|
|
if (__a) { \
|
|
__r = (void *) __a(ARGS); \
|
|
if (__r == NULL) \
|
|
symbol_put(FUNCTION); \
|
|
} else { \
|
|
printk(KERN_ERR "DVB: Unable to find symbol "#FUNCTION"()\n"); \
|
|
} \
|
|
__r; \
|
|
})
|
|
|
|
#define dvb_detach(FUNC) symbol_put_addr(FUNC)
|
|
|
|
#else
|
|
#define dvb_attach(FUNCTION, ARGS...) ({ \
|
|
FUNCTION(ARGS); \
|
|
})
|
|
|
|
#define dvb_detach(FUNC) {}
|
|
|
|
#endif
|
|
|
|
#endif /* #ifndef _DVBDEV_H_ */
|