LXR linux/drivers/media/dvb/dvb-core/dvbdev.h

   1/*
   2 * dvbdev.h
   3 *
   4 * Copyright (C) 2000 Ralph Metzler & Marcus Metzler
   5 *                    for convergence integrated media GmbH
   6 *
   7 * This program is free software; you can redistribute it and/or
   8 * modify it under the terms of the GNU General Lesser Public License
   9 * as published by the Free Software Foundation; either version 2.1
  10 * of the License, or (at your option) any later version.
  11 *
  12 * This program is distributed in the hope that it will be useful,
  13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 * GNU General Public License for more details.
  16 *
  17 * You should have received a copy of the GNU Lesser 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  02111-1307, USA.
  20 *
  21 */
  22
  23#ifndef _DVBDEV_H_
  24#define _DVBDEV_H_
  25
  26#include <linux/types.h>
  27#include <linux/poll.h>
  28#include <linux/fs.h>
  29#include <linux/list.h>
  30
  31#define DVB_MAJOR 212
  32
  33#if defined(CONFIG_DVB_MAX_ADAPTERS) && CONFIG_DVB_MAX_ADAPTERS > 0
  34  #define DVB_MAX_ADAPTERS CONFIG_DVB_MAX_ADAPTERS
  35#else
  36  #define DVB_MAX_ADAPTERS 8
  37#endif
  38
  39#define DVB_UNSET (-1)
  40
  41#define DVB_DEVICE_VIDEO      0
  42#define DVB_DEVICE_AUDIO      1
  43#define DVB_DEVICE_SEC        2
  44#define DVB_DEVICE_FRONTEND   3
  45#define DVB_DEVICE_DEMUX      4
  46#define DVB_DEVICE_DVR        5
  47#define DVB_DEVICE_CA         6
  48#define DVB_DEVICE_NET        7
  49#define DVB_DEVICE_OSD        8
  50
  51#define DVB_DEFINE_MOD_OPT_ADAPTER_NR(adapter_nr) \
  52        static short adapter_nr[] = \
  53                {[0 ... (DVB_MAX_ADAPTERS - 1)] = DVB_UNSET }; \
  54        module_param_array(adapter_nr, short, NULL, 0444); \
  55        MODULE_PARM_DESC(adapter_nr, "DVB adapter numbers")
  56
  57struct dvb_frontend;
  58
  59struct dvb_adapter {
  60        int num;
  61        struct list_head list_head;
  62        struct list_head device_list;
  63        const char *name;
  64        u8 proposed_mac [6];
  65        void* priv;
  66
  67        struct device *device;
  68
  69        struct module *module;
  70
  71        int mfe_shared;                 /* indicates mutually exclusive frontends */
  72        struct dvb_device *mfe_dvbdev;  /* frontend device in use */
  73        struct mutex mfe_lock;          /* access lock for thread creation */
  74
  75        /* Allow the adapter/bridge driver to perform an action before and/or
  76         * after the core handles an ioctl:
  77         *
  78         * DVB_FE_IOCTL_PRE indicates that the ioctl has not yet been handled.
  79         * DVB_FE_IOCTL_POST indicates that the ioctl has been handled.
  80         *
  81         * When DVB_FE_IOCTL_PRE is passed to the callback as the stage arg:
  82         *
  83         * return 0 to allow dvb-core to handle the ioctl.
  84         * return a positive int to prevent dvb-core from handling the ioctl,
  85         *      and exit without error.
  86         * return a negative int to prevent dvb-core from handling the ioctl,
  87         *      and return that value as an error.
  88         *
  89         * When DVB_FE_IOCTL_POST is passed to the callback as the stage arg:
  90         *
  91         * return 0 to allow the dvb_frontend ioctl handler to exit normally.
  92         * return a negative int to cause the dvb_frontend ioctl handler to
  93         *      return that value as an error.
  94         */
  95#define DVB_FE_IOCTL_PRE 0
  96#define DVB_FE_IOCTL_POST 1
  97        int (*fe_ioctl_override)(struct dvb_frontend *fe,
  98                                 unsigned int cmd, void *parg,
  99                                 unsigned int stage);
 100};
 101
 102
 103struct dvb_device {
 104        struct list_head list_head;
 105        const struct file_operations *fops;
 106        struct dvb_adapter *adapter;
 107        int type;
 108        int minor;
 109        u32 id;
 110
 111        /* in theory, 'users' can vanish now,
 112           but I don't want to change too much now... */
 113        int readers;
 114        int writers;
 115        int users;
 116
 117        wait_queue_head_t         wait_queue;
 118        /* don't really need those !? -- FIXME: use video_usercopy  */
 119        int (*kernel_ioctl)(struct file *file, unsigned int cmd, void *arg);
 120
 121        void *priv;
 122};
 123
 124
 125extern int dvb_register_adapter(struct dvb_adapter *adap, const char *name,
 126                                struct module *module, struct device *device,
 127                                short *adapter_nums);
 128extern int dvb_unregister_adapter (struct dvb_adapter *adap);
 129
 130extern int dvb_register_device (struct dvb_adapter *adap,
 131                                struct dvb_device **pdvbdev,
 132                                const struct dvb_device *template,
 133                                void *priv,
 134                                int type);
 135
 136extern void dvb_unregister_device (struct dvb_device *dvbdev);
 137
 138extern int dvb_generic_open (struct inode *inode, struct file *file);
 139extern int dvb_generic_release (struct inode *inode, struct file *file);
 140extern long dvb_generic_ioctl (struct file *file,
 141                              unsigned int cmd, unsigned long arg);
 142
 143/* we don't mess with video_usercopy() any more,
 144we simply define out own dvb_usercopy(), which will hopefully become
 145generic_usercopy()  someday... */
 146
 147extern int dvb_usercopy(struct file *file, unsigned int cmd, unsigned long arg,
 148                            int (*func)(struct file *file, unsigned int cmd, void *arg));
 149
 150/** generic DVB attach function. */
 151#ifdef CONFIG_MEDIA_ATTACH
 152#define dvb_attach(FUNCTION, ARGS...) ({ \
 153        void *__r = NULL; \
 154        typeof(&FUNCTION) __a = symbol_request(FUNCTION); \
 155        if (__a) { \
 156                __r = (void *) __a(ARGS); \
 157                if (__r == NULL) \
 158                        symbol_put(FUNCTION); \
 159        } else { \
 160                printk(KERN_ERR "DVB: Unable to find symbol "#FUNCTION"()\n"); \
 161        } \
 162        __r; \
 163})
 164
 165#else
 166#define dvb_attach(FUNCTION, ARGS...) ({ \
 167        FUNCTION(ARGS); \
 168})
 169
 170#endif
 171
 172#endif /* #ifndef _DVBDEV_H_ */
 173