]> git.karo-electronics.de Git - karo-tx-linux.git/blob - drivers/media/v4l2-core/v4l2-dev.c
Merge tag 'wireless-drivers-for-davem-2016-06-04' of git://git.kernel.org/pub/scm...
[karo-tx-linux.git] / drivers / media / v4l2-core / v4l2-dev.c
1 /*
2  * Video capture interface for Linux version 2
3  *
4  *      A generic video device interface for the LINUX operating system
5  *      using a set of device structures/vectors for low level operations.
6  *
7  *      This program is free software; you can redistribute it and/or
8  *      modify it under the terms of the GNU General Public License
9  *      as published by the Free Software Foundation; either version
10  *      2 of the License, or (at your option) any later version.
11  *
12  * Authors:     Alan Cox, <alan@lxorguk.ukuu.org.uk> (version 1)
13  *              Mauro Carvalho Chehab <mchehab@infradead.org> (version 2)
14  *
15  * Fixes:       20000516  Claudio Matsuoka <claudio@conectiva.com>
16  *              - Added procfs support
17  */
18
19 #include <linux/module.h>
20 #include <linux/types.h>
21 #include <linux/kernel.h>
22 #include <linux/mm.h>
23 #include <linux/string.h>
24 #include <linux/errno.h>
25 #include <linux/init.h>
26 #include <linux/kmod.h>
27 #include <linux/slab.h>
28 #include <asm/uaccess.h>
29
30 #include <media/v4l2-common.h>
31 #include <media/v4l2-device.h>
32 #include <media/v4l2-ioctl.h>
33
34 #define VIDEO_NUM_DEVICES       256
35 #define VIDEO_NAME              "video4linux"
36
37 /*
38  *      sysfs stuff
39  */
40
41 static ssize_t index_show(struct device *cd,
42                           struct device_attribute *attr, char *buf)
43 {
44         struct video_device *vdev = to_video_device(cd);
45
46         return sprintf(buf, "%i\n", vdev->index);
47 }
48 static DEVICE_ATTR_RO(index);
49
50 static ssize_t dev_debug_show(struct device *cd,
51                           struct device_attribute *attr, char *buf)
52 {
53         struct video_device *vdev = to_video_device(cd);
54
55         return sprintf(buf, "%i\n", vdev->dev_debug);
56 }
57
58 static ssize_t dev_debug_store(struct device *cd, struct device_attribute *attr,
59                           const char *buf, size_t len)
60 {
61         struct video_device *vdev = to_video_device(cd);
62         int res = 0;
63         u16 value;
64
65         res = kstrtou16(buf, 0, &value);
66         if (res)
67                 return res;
68
69         vdev->dev_debug = value;
70         return len;
71 }
72 static DEVICE_ATTR_RW(dev_debug);
73
74 static ssize_t name_show(struct device *cd,
75                          struct device_attribute *attr, char *buf)
76 {
77         struct video_device *vdev = to_video_device(cd);
78
79         return sprintf(buf, "%.*s\n", (int)sizeof(vdev->name), vdev->name);
80 }
81 static DEVICE_ATTR_RO(name);
82
83 static struct attribute *video_device_attrs[] = {
84         &dev_attr_name.attr,
85         &dev_attr_dev_debug.attr,
86         &dev_attr_index.attr,
87         NULL,
88 };
89 ATTRIBUTE_GROUPS(video_device);
90
91 /*
92  *      Active devices
93  */
94 static struct video_device *video_device[VIDEO_NUM_DEVICES];
95 static DEFINE_MUTEX(videodev_lock);
96 static DECLARE_BITMAP(devnode_nums[VFL_TYPE_MAX], VIDEO_NUM_DEVICES);
97
98 /* Device node utility functions */
99
100 /* Note: these utility functions all assume that vfl_type is in the range
101    [0, VFL_TYPE_MAX-1]. */
102
103 #ifdef CONFIG_VIDEO_FIXED_MINOR_RANGES
104 /* Return the bitmap corresponding to vfl_type. */
105 static inline unsigned long *devnode_bits(int vfl_type)
106 {
107         /* Any types not assigned to fixed minor ranges must be mapped to
108            one single bitmap for the purposes of finding a free node number
109            since all those unassigned types use the same minor range. */
110         int idx = (vfl_type > VFL_TYPE_RADIO) ? VFL_TYPE_MAX - 1 : vfl_type;
111
112         return devnode_nums[idx];
113 }
114 #else
115 /* Return the bitmap corresponding to vfl_type. */
116 static inline unsigned long *devnode_bits(int vfl_type)
117 {
118         return devnode_nums[vfl_type];
119 }
120 #endif
121
122 /* Mark device node number vdev->num as used */
123 static inline void devnode_set(struct video_device *vdev)
124 {
125         set_bit(vdev->num, devnode_bits(vdev->vfl_type));
126 }
127
128 /* Mark device node number vdev->num as unused */
129 static inline void devnode_clear(struct video_device *vdev)
130 {
131         clear_bit(vdev->num, devnode_bits(vdev->vfl_type));
132 }
133
134 /* Try to find a free device node number in the range [from, to> */
135 static inline int devnode_find(struct video_device *vdev, int from, int to)
136 {
137         return find_next_zero_bit(devnode_bits(vdev->vfl_type), to, from);
138 }
139
140 struct video_device *video_device_alloc(void)
141 {
142         return kzalloc(sizeof(struct video_device), GFP_KERNEL);
143 }
144 EXPORT_SYMBOL(video_device_alloc);
145
146 void video_device_release(struct video_device *vdev)
147 {
148         kfree(vdev);
149 }
150 EXPORT_SYMBOL(video_device_release);
151
152 void video_device_release_empty(struct video_device *vdev)
153 {
154         /* Do nothing */
155         /* Only valid when the video_device struct is a static. */
156 }
157 EXPORT_SYMBOL(video_device_release_empty);
158
159 static inline void video_get(struct video_device *vdev)
160 {
161         get_device(&vdev->dev);
162 }
163
164 static inline void video_put(struct video_device *vdev)
165 {
166         put_device(&vdev->dev);
167 }
168
169 /* Called when the last user of the video device exits. */
170 static void v4l2_device_release(struct device *cd)
171 {
172         struct video_device *vdev = to_video_device(cd);
173         struct v4l2_device *v4l2_dev = vdev->v4l2_dev;
174
175         mutex_lock(&videodev_lock);
176         if (WARN_ON(video_device[vdev->minor] != vdev)) {
177                 /* should not happen */
178                 mutex_unlock(&videodev_lock);
179                 return;
180         }
181
182         /* Free up this device for reuse */
183         video_device[vdev->minor] = NULL;
184
185         /* Delete the cdev on this minor as well */
186         cdev_del(vdev->cdev);
187         /* Just in case some driver tries to access this from
188            the release() callback. */
189         vdev->cdev = NULL;
190
191         /* Mark device node number as free */
192         devnode_clear(vdev);
193
194         mutex_unlock(&videodev_lock);
195
196 #if defined(CONFIG_MEDIA_CONTROLLER)
197         if (v4l2_dev->mdev) {
198                 /* Remove interfaces and interface links */
199                 media_devnode_remove(vdev->intf_devnode);
200                 if (vdev->entity.function != MEDIA_ENT_F_UNKNOWN)
201                         media_device_unregister_entity(&vdev->entity);
202         }
203 #endif
204
205         /* Do not call v4l2_device_put if there is no release callback set.
206          * Drivers that have no v4l2_device release callback might free the
207          * v4l2_dev instance in the video_device release callback below, so we
208          * must perform this check here.
209          *
210          * TODO: In the long run all drivers that use v4l2_device should use the
211          * v4l2_device release callback. This check will then be unnecessary.
212          */
213         if (v4l2_dev->release == NULL)
214                 v4l2_dev = NULL;
215
216         /* Release video_device and perform other
217            cleanups as needed. */
218         vdev->release(vdev);
219
220         /* Decrease v4l2_device refcount */
221         if (v4l2_dev)
222                 v4l2_device_put(v4l2_dev);
223 }
224
225 static struct class video_class = {
226         .name = VIDEO_NAME,
227         .dev_groups = video_device_groups,
228 };
229
230 struct video_device *video_devdata(struct file *file)
231 {
232         return video_device[iminor(file_inode(file))];
233 }
234 EXPORT_SYMBOL(video_devdata);
235
236
237 /* Priority handling */
238
239 static inline bool prio_is_valid(enum v4l2_priority prio)
240 {
241         return prio == V4L2_PRIORITY_BACKGROUND ||
242                prio == V4L2_PRIORITY_INTERACTIVE ||
243                prio == V4L2_PRIORITY_RECORD;
244 }
245
246 void v4l2_prio_init(struct v4l2_prio_state *global)
247 {
248         memset(global, 0, sizeof(*global));
249 }
250 EXPORT_SYMBOL(v4l2_prio_init);
251
252 int v4l2_prio_change(struct v4l2_prio_state *global, enum v4l2_priority *local,
253                      enum v4l2_priority new)
254 {
255         if (!prio_is_valid(new))
256                 return -EINVAL;
257         if (*local == new)
258                 return 0;
259
260         atomic_inc(&global->prios[new]);
261         if (prio_is_valid(*local))
262                 atomic_dec(&global->prios[*local]);
263         *local = new;
264         return 0;
265 }
266 EXPORT_SYMBOL(v4l2_prio_change);
267
268 void v4l2_prio_open(struct v4l2_prio_state *global, enum v4l2_priority *local)
269 {
270         v4l2_prio_change(global, local, V4L2_PRIORITY_DEFAULT);
271 }
272 EXPORT_SYMBOL(v4l2_prio_open);
273
274 void v4l2_prio_close(struct v4l2_prio_state *global, enum v4l2_priority local)
275 {
276         if (prio_is_valid(local))
277                 atomic_dec(&global->prios[local]);
278 }
279 EXPORT_SYMBOL(v4l2_prio_close);
280
281 enum v4l2_priority v4l2_prio_max(struct v4l2_prio_state *global)
282 {
283         if (atomic_read(&global->prios[V4L2_PRIORITY_RECORD]) > 0)
284                 return V4L2_PRIORITY_RECORD;
285         if (atomic_read(&global->prios[V4L2_PRIORITY_INTERACTIVE]) > 0)
286                 return V4L2_PRIORITY_INTERACTIVE;
287         if (atomic_read(&global->prios[V4L2_PRIORITY_BACKGROUND]) > 0)
288                 return V4L2_PRIORITY_BACKGROUND;
289         return V4L2_PRIORITY_UNSET;
290 }
291 EXPORT_SYMBOL(v4l2_prio_max);
292
293 int v4l2_prio_check(struct v4l2_prio_state *global, enum v4l2_priority local)
294 {
295         return (local < v4l2_prio_max(global)) ? -EBUSY : 0;
296 }
297 EXPORT_SYMBOL(v4l2_prio_check);
298
299
300 static ssize_t v4l2_read(struct file *filp, char __user *buf,
301                 size_t sz, loff_t *off)
302 {
303         struct video_device *vdev = video_devdata(filp);
304         int ret = -ENODEV;
305
306         if (!vdev->fops->read)
307                 return -EINVAL;
308         if (video_is_registered(vdev))
309                 ret = vdev->fops->read(filp, buf, sz, off);
310         if ((vdev->dev_debug & V4L2_DEV_DEBUG_FOP) &&
311             (vdev->dev_debug & V4L2_DEV_DEBUG_STREAMING))
312                 printk(KERN_DEBUG "%s: read: %zd (%d)\n",
313                         video_device_node_name(vdev), sz, ret);
314         return ret;
315 }
316
317 static ssize_t v4l2_write(struct file *filp, const char __user *buf,
318                 size_t sz, loff_t *off)
319 {
320         struct video_device *vdev = video_devdata(filp);
321         int ret = -ENODEV;
322
323         if (!vdev->fops->write)
324                 return -EINVAL;
325         if (video_is_registered(vdev))
326                 ret = vdev->fops->write(filp, buf, sz, off);
327         if ((vdev->dev_debug & V4L2_DEV_DEBUG_FOP) &&
328             (vdev->dev_debug & V4L2_DEV_DEBUG_STREAMING))
329                 printk(KERN_DEBUG "%s: write: %zd (%d)\n",
330                         video_device_node_name(vdev), sz, ret);
331         return ret;
332 }
333
334 static unsigned int v4l2_poll(struct file *filp, struct poll_table_struct *poll)
335 {
336         struct video_device *vdev = video_devdata(filp);
337         unsigned int res = POLLERR | POLLHUP;
338
339         if (!vdev->fops->poll)
340                 return DEFAULT_POLLMASK;
341         if (video_is_registered(vdev))
342                 res = vdev->fops->poll(filp, poll);
343         if (vdev->dev_debug & V4L2_DEV_DEBUG_POLL)
344                 printk(KERN_DEBUG "%s: poll: %08x\n",
345                         video_device_node_name(vdev), res);
346         return res;
347 }
348
349 static long v4l2_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
350 {
351         struct video_device *vdev = video_devdata(filp);
352         int ret = -ENODEV;
353
354         if (vdev->fops->unlocked_ioctl) {
355                 struct mutex *lock = v4l2_ioctl_get_lock(vdev, cmd);
356
357                 if (lock && mutex_lock_interruptible(lock))
358                         return -ERESTARTSYS;
359                 if (video_is_registered(vdev))
360                         ret = vdev->fops->unlocked_ioctl(filp, cmd, arg);
361                 if (lock)
362                         mutex_unlock(lock);
363         } else
364                 ret = -ENOTTY;
365
366         return ret;
367 }
368
369 #ifdef CONFIG_MMU
370 #define v4l2_get_unmapped_area NULL
371 #else
372 static unsigned long v4l2_get_unmapped_area(struct file *filp,
373                 unsigned long addr, unsigned long len, unsigned long pgoff,
374                 unsigned long flags)
375 {
376         struct video_device *vdev = video_devdata(filp);
377         int ret;
378
379         if (!vdev->fops->get_unmapped_area)
380                 return -ENOSYS;
381         if (!video_is_registered(vdev))
382                 return -ENODEV;
383         ret = vdev->fops->get_unmapped_area(filp, addr, len, pgoff, flags);
384         if (vdev->dev_debug & V4L2_DEV_DEBUG_FOP)
385                 printk(KERN_DEBUG "%s: get_unmapped_area (%d)\n",
386                         video_device_node_name(vdev), ret);
387         return ret;
388 }
389 #endif
390
391 static int v4l2_mmap(struct file *filp, struct vm_area_struct *vm)
392 {
393         struct video_device *vdev = video_devdata(filp);
394         int ret = -ENODEV;
395
396         if (!vdev->fops->mmap)
397                 return -ENODEV;
398         if (video_is_registered(vdev))
399                 ret = vdev->fops->mmap(filp, vm);
400         if (vdev->dev_debug & V4L2_DEV_DEBUG_FOP)
401                 printk(KERN_DEBUG "%s: mmap (%d)\n",
402                         video_device_node_name(vdev), ret);
403         return ret;
404 }
405
406 /* Override for the open function */
407 static int v4l2_open(struct inode *inode, struct file *filp)
408 {
409         struct video_device *vdev;
410         int ret = 0;
411
412         /* Check if the video device is available */
413         mutex_lock(&videodev_lock);
414         vdev = video_devdata(filp);
415         /* return ENODEV if the video device has already been removed. */
416         if (vdev == NULL || !video_is_registered(vdev)) {
417                 mutex_unlock(&videodev_lock);
418                 return -ENODEV;
419         }
420         /* and increase the device refcount */
421         video_get(vdev);
422         mutex_unlock(&videodev_lock);
423         if (vdev->fops->open) {
424                 if (video_is_registered(vdev))
425                         ret = vdev->fops->open(filp);
426                 else
427                         ret = -ENODEV;
428         }
429
430         if (vdev->dev_debug & V4L2_DEV_DEBUG_FOP)
431                 printk(KERN_DEBUG "%s: open (%d)\n",
432                         video_device_node_name(vdev), ret);
433         /* decrease the refcount in case of an error */
434         if (ret)
435                 video_put(vdev);
436         return ret;
437 }
438
439 /* Override for the release function */
440 static int v4l2_release(struct inode *inode, struct file *filp)
441 {
442         struct video_device *vdev = video_devdata(filp);
443         int ret = 0;
444
445         if (vdev->fops->release)
446                 ret = vdev->fops->release(filp);
447         if (vdev->dev_debug & V4L2_DEV_DEBUG_FOP)
448                 printk(KERN_DEBUG "%s: release\n",
449                         video_device_node_name(vdev));
450
451         /* decrease the refcount unconditionally since the release()
452            return value is ignored. */
453         video_put(vdev);
454         return ret;
455 }
456
457 static const struct file_operations v4l2_fops = {
458         .owner = THIS_MODULE,
459         .read = v4l2_read,
460         .write = v4l2_write,
461         .open = v4l2_open,
462         .get_unmapped_area = v4l2_get_unmapped_area,
463         .mmap = v4l2_mmap,
464         .unlocked_ioctl = v4l2_ioctl,
465 #ifdef CONFIG_COMPAT
466         .compat_ioctl = v4l2_compat_ioctl32,
467 #endif
468         .release = v4l2_release,
469         .poll = v4l2_poll,
470         .llseek = no_llseek,
471 };
472
473 /**
474  * get_index - assign stream index number based on v4l2_dev
475  * @vdev: video_device to assign index number to, vdev->v4l2_dev should be assigned
476  *
477  * Note that when this is called the new device has not yet been registered
478  * in the video_device array, but it was able to obtain a minor number.
479  *
480  * This means that we can always obtain a free stream index number since
481  * the worst case scenario is that there are VIDEO_NUM_DEVICES - 1 slots in
482  * use of the video_device array.
483  *
484  * Returns a free index number.
485  */
486 static int get_index(struct video_device *vdev)
487 {
488         /* This can be static since this function is called with the global
489            videodev_lock held. */
490         static DECLARE_BITMAP(used, VIDEO_NUM_DEVICES);
491         int i;
492
493         bitmap_zero(used, VIDEO_NUM_DEVICES);
494
495         for (i = 0; i < VIDEO_NUM_DEVICES; i++) {
496                 if (video_device[i] != NULL &&
497                     video_device[i]->v4l2_dev == vdev->v4l2_dev) {
498                         set_bit(video_device[i]->index, used);
499                 }
500         }
501
502         return find_first_zero_bit(used, VIDEO_NUM_DEVICES);
503 }
504
505 #define SET_VALID_IOCTL(ops, cmd, op)                   \
506         if (ops->op)                                    \
507                 set_bit(_IOC_NR(cmd), valid_ioctls)
508
509 /* This determines which ioctls are actually implemented in the driver.
510    It's a one-time thing which simplifies video_ioctl2 as it can just do
511    a bit test.
512
513    Note that drivers can override this by setting bits to 1 in
514    vdev->valid_ioctls. If an ioctl is marked as 1 when this function is
515    called, then that ioctl will actually be marked as unimplemented.
516
517    It does that by first setting up the local valid_ioctls bitmap, and
518    at the end do a:
519
520    vdev->valid_ioctls = valid_ioctls & ~(vdev->valid_ioctls)
521  */
522 static void determine_valid_ioctls(struct video_device *vdev)
523 {
524         DECLARE_BITMAP(valid_ioctls, BASE_VIDIOC_PRIVATE);
525         const struct v4l2_ioctl_ops *ops = vdev->ioctl_ops;
526         bool is_vid = vdev->vfl_type == VFL_TYPE_GRABBER;
527         bool is_vbi = vdev->vfl_type == VFL_TYPE_VBI;
528         bool is_radio = vdev->vfl_type == VFL_TYPE_RADIO;
529         bool is_sdr = vdev->vfl_type == VFL_TYPE_SDR;
530         bool is_rx = vdev->vfl_dir != VFL_DIR_TX;
531         bool is_tx = vdev->vfl_dir != VFL_DIR_RX;
532
533         bitmap_zero(valid_ioctls, BASE_VIDIOC_PRIVATE);
534
535         /* vfl_type and vfl_dir independent ioctls */
536
537         SET_VALID_IOCTL(ops, VIDIOC_QUERYCAP, vidioc_querycap);
538         set_bit(_IOC_NR(VIDIOC_G_PRIORITY), valid_ioctls);
539         set_bit(_IOC_NR(VIDIOC_S_PRIORITY), valid_ioctls);
540
541         /* Note: the control handler can also be passed through the filehandle,
542            and that can't be tested here. If the bit for these control ioctls
543            is set, then the ioctl is valid. But if it is 0, then it can still
544            be valid if the filehandle passed the control handler. */
545         if (vdev->ctrl_handler || ops->vidioc_queryctrl)
546                 set_bit(_IOC_NR(VIDIOC_QUERYCTRL), valid_ioctls);
547         if (vdev->ctrl_handler || ops->vidioc_query_ext_ctrl)
548                 set_bit(_IOC_NR(VIDIOC_QUERY_EXT_CTRL), valid_ioctls);
549         if (vdev->ctrl_handler || ops->vidioc_g_ctrl || ops->vidioc_g_ext_ctrls)
550                 set_bit(_IOC_NR(VIDIOC_G_CTRL), valid_ioctls);
551         if (vdev->ctrl_handler || ops->vidioc_s_ctrl || ops->vidioc_s_ext_ctrls)
552                 set_bit(_IOC_NR(VIDIOC_S_CTRL), valid_ioctls);
553         if (vdev->ctrl_handler || ops->vidioc_g_ext_ctrls)
554                 set_bit(_IOC_NR(VIDIOC_G_EXT_CTRLS), valid_ioctls);
555         if (vdev->ctrl_handler || ops->vidioc_s_ext_ctrls)
556                 set_bit(_IOC_NR(VIDIOC_S_EXT_CTRLS), valid_ioctls);
557         if (vdev->ctrl_handler || ops->vidioc_try_ext_ctrls)
558                 set_bit(_IOC_NR(VIDIOC_TRY_EXT_CTRLS), valid_ioctls);
559         if (vdev->ctrl_handler || ops->vidioc_querymenu)
560                 set_bit(_IOC_NR(VIDIOC_QUERYMENU), valid_ioctls);
561         SET_VALID_IOCTL(ops, VIDIOC_G_FREQUENCY, vidioc_g_frequency);
562         SET_VALID_IOCTL(ops, VIDIOC_S_FREQUENCY, vidioc_s_frequency);
563         SET_VALID_IOCTL(ops, VIDIOC_LOG_STATUS, vidioc_log_status);
564 #ifdef CONFIG_VIDEO_ADV_DEBUG
565         set_bit(_IOC_NR(VIDIOC_DBG_G_CHIP_INFO), valid_ioctls);
566         set_bit(_IOC_NR(VIDIOC_DBG_G_REGISTER), valid_ioctls);
567         set_bit(_IOC_NR(VIDIOC_DBG_S_REGISTER), valid_ioctls);
568 #endif
569         /* yes, really vidioc_subscribe_event */
570         SET_VALID_IOCTL(ops, VIDIOC_DQEVENT, vidioc_subscribe_event);
571         SET_VALID_IOCTL(ops, VIDIOC_SUBSCRIBE_EVENT, vidioc_subscribe_event);
572         SET_VALID_IOCTL(ops, VIDIOC_UNSUBSCRIBE_EVENT, vidioc_unsubscribe_event);
573         if (ops->vidioc_enum_freq_bands || ops->vidioc_g_tuner || ops->vidioc_g_modulator)
574                 set_bit(_IOC_NR(VIDIOC_ENUM_FREQ_BANDS), valid_ioctls);
575
576         if (is_vid) {
577                 /* video specific ioctls */
578                 if ((is_rx && (ops->vidioc_enum_fmt_vid_cap ||
579                                ops->vidioc_enum_fmt_vid_cap_mplane ||
580                                ops->vidioc_enum_fmt_vid_overlay)) ||
581                     (is_tx && (ops->vidioc_enum_fmt_vid_out ||
582                                ops->vidioc_enum_fmt_vid_out_mplane)))
583                         set_bit(_IOC_NR(VIDIOC_ENUM_FMT), valid_ioctls);
584                 if ((is_rx && (ops->vidioc_g_fmt_vid_cap ||
585                                ops->vidioc_g_fmt_vid_cap_mplane ||
586                                ops->vidioc_g_fmt_vid_overlay)) ||
587                     (is_tx && (ops->vidioc_g_fmt_vid_out ||
588                                ops->vidioc_g_fmt_vid_out_mplane ||
589                                ops->vidioc_g_fmt_vid_out_overlay)))
590                          set_bit(_IOC_NR(VIDIOC_G_FMT), valid_ioctls);
591                 if ((is_rx && (ops->vidioc_s_fmt_vid_cap ||
592                                ops->vidioc_s_fmt_vid_cap_mplane ||
593                                ops->vidioc_s_fmt_vid_overlay)) ||
594                     (is_tx && (ops->vidioc_s_fmt_vid_out ||
595                                ops->vidioc_s_fmt_vid_out_mplane ||
596                                ops->vidioc_s_fmt_vid_out_overlay)))
597                          set_bit(_IOC_NR(VIDIOC_S_FMT), valid_ioctls);
598                 if ((is_rx && (ops->vidioc_try_fmt_vid_cap ||
599                                ops->vidioc_try_fmt_vid_cap_mplane ||
600                                ops->vidioc_try_fmt_vid_overlay)) ||
601                     (is_tx && (ops->vidioc_try_fmt_vid_out ||
602                                ops->vidioc_try_fmt_vid_out_mplane ||
603                                ops->vidioc_try_fmt_vid_out_overlay)))
604                          set_bit(_IOC_NR(VIDIOC_TRY_FMT), valid_ioctls);
605                 SET_VALID_IOCTL(ops, VIDIOC_OVERLAY, vidioc_overlay);
606                 SET_VALID_IOCTL(ops, VIDIOC_G_FBUF, vidioc_g_fbuf);
607                 SET_VALID_IOCTL(ops, VIDIOC_S_FBUF, vidioc_s_fbuf);
608                 SET_VALID_IOCTL(ops, VIDIOC_G_JPEGCOMP, vidioc_g_jpegcomp);
609                 SET_VALID_IOCTL(ops, VIDIOC_S_JPEGCOMP, vidioc_s_jpegcomp);
610                 SET_VALID_IOCTL(ops, VIDIOC_G_ENC_INDEX, vidioc_g_enc_index);
611                 SET_VALID_IOCTL(ops, VIDIOC_ENCODER_CMD, vidioc_encoder_cmd);
612                 SET_VALID_IOCTL(ops, VIDIOC_TRY_ENCODER_CMD, vidioc_try_encoder_cmd);
613                 SET_VALID_IOCTL(ops, VIDIOC_DECODER_CMD, vidioc_decoder_cmd);
614                 SET_VALID_IOCTL(ops, VIDIOC_TRY_DECODER_CMD, vidioc_try_decoder_cmd);
615                 SET_VALID_IOCTL(ops, VIDIOC_ENUM_FRAMESIZES, vidioc_enum_framesizes);
616                 SET_VALID_IOCTL(ops, VIDIOC_ENUM_FRAMEINTERVALS, vidioc_enum_frameintervals);
617                 if (ops->vidioc_g_crop || ops->vidioc_g_selection)
618                         set_bit(_IOC_NR(VIDIOC_G_CROP), valid_ioctls);
619                 if (ops->vidioc_s_crop || ops->vidioc_s_selection)
620                         set_bit(_IOC_NR(VIDIOC_S_CROP), valid_ioctls);
621                 SET_VALID_IOCTL(ops, VIDIOC_G_SELECTION, vidioc_g_selection);
622                 SET_VALID_IOCTL(ops, VIDIOC_S_SELECTION, vidioc_s_selection);
623                 if (ops->vidioc_cropcap || ops->vidioc_g_selection)
624                         set_bit(_IOC_NR(VIDIOC_CROPCAP), valid_ioctls);
625         } else if (is_vbi) {
626                 /* vbi specific ioctls */
627                 if ((is_rx && (ops->vidioc_g_fmt_vbi_cap ||
628                                ops->vidioc_g_fmt_sliced_vbi_cap)) ||
629                     (is_tx && (ops->vidioc_g_fmt_vbi_out ||
630                                ops->vidioc_g_fmt_sliced_vbi_out)))
631                         set_bit(_IOC_NR(VIDIOC_G_FMT), valid_ioctls);
632                 if ((is_rx && (ops->vidioc_s_fmt_vbi_cap ||
633                                ops->vidioc_s_fmt_sliced_vbi_cap)) ||
634                     (is_tx && (ops->vidioc_s_fmt_vbi_out ||
635                                ops->vidioc_s_fmt_sliced_vbi_out)))
636                         set_bit(_IOC_NR(VIDIOC_S_FMT), valid_ioctls);
637                 if ((is_rx && (ops->vidioc_try_fmt_vbi_cap ||
638                                ops->vidioc_try_fmt_sliced_vbi_cap)) ||
639                     (is_tx && (ops->vidioc_try_fmt_vbi_out ||
640                                ops->vidioc_try_fmt_sliced_vbi_out)))
641                         set_bit(_IOC_NR(VIDIOC_TRY_FMT), valid_ioctls);
642                 SET_VALID_IOCTL(ops, VIDIOC_G_SLICED_VBI_CAP, vidioc_g_sliced_vbi_cap);
643         } else if (is_sdr && is_rx) {
644                 /* SDR receiver specific ioctls */
645                 if (ops->vidioc_enum_fmt_sdr_cap)
646                         set_bit(_IOC_NR(VIDIOC_ENUM_FMT), valid_ioctls);
647                 if (ops->vidioc_g_fmt_sdr_cap)
648                         set_bit(_IOC_NR(VIDIOC_G_FMT), valid_ioctls);
649                 if (ops->vidioc_s_fmt_sdr_cap)
650                         set_bit(_IOC_NR(VIDIOC_S_FMT), valid_ioctls);
651                 if (ops->vidioc_try_fmt_sdr_cap)
652                         set_bit(_IOC_NR(VIDIOC_TRY_FMT), valid_ioctls);
653         } else if (is_sdr && is_tx) {
654                 /* SDR transmitter specific ioctls */
655                 if (ops->vidioc_enum_fmt_sdr_out)
656                         set_bit(_IOC_NR(VIDIOC_ENUM_FMT), valid_ioctls);
657                 if (ops->vidioc_g_fmt_sdr_out)
658                         set_bit(_IOC_NR(VIDIOC_G_FMT), valid_ioctls);
659                 if (ops->vidioc_s_fmt_sdr_out)
660                         set_bit(_IOC_NR(VIDIOC_S_FMT), valid_ioctls);
661                 if (ops->vidioc_try_fmt_sdr_out)
662                         set_bit(_IOC_NR(VIDIOC_TRY_FMT), valid_ioctls);
663         }
664
665         if (is_vid || is_vbi || is_sdr) {
666                 /* ioctls valid for video, vbi or sdr */
667                 SET_VALID_IOCTL(ops, VIDIOC_REQBUFS, vidioc_reqbufs);
668                 SET_VALID_IOCTL(ops, VIDIOC_QUERYBUF, vidioc_querybuf);
669                 SET_VALID_IOCTL(ops, VIDIOC_QBUF, vidioc_qbuf);
670                 SET_VALID_IOCTL(ops, VIDIOC_EXPBUF, vidioc_expbuf);
671                 SET_VALID_IOCTL(ops, VIDIOC_DQBUF, vidioc_dqbuf);
672                 SET_VALID_IOCTL(ops, VIDIOC_CREATE_BUFS, vidioc_create_bufs);
673                 SET_VALID_IOCTL(ops, VIDIOC_PREPARE_BUF, vidioc_prepare_buf);
674                 SET_VALID_IOCTL(ops, VIDIOC_STREAMON, vidioc_streamon);
675                 SET_VALID_IOCTL(ops, VIDIOC_STREAMOFF, vidioc_streamoff);
676         }
677
678         if (is_vid || is_vbi) {
679                 /* ioctls valid for video or vbi */
680                 if (ops->vidioc_s_std)
681                         set_bit(_IOC_NR(VIDIOC_ENUMSTD), valid_ioctls);
682                 SET_VALID_IOCTL(ops, VIDIOC_S_STD, vidioc_s_std);
683                 SET_VALID_IOCTL(ops, VIDIOC_G_STD, vidioc_g_std);
684                 if (is_rx) {
685                         SET_VALID_IOCTL(ops, VIDIOC_QUERYSTD, vidioc_querystd);
686                         SET_VALID_IOCTL(ops, VIDIOC_ENUMINPUT, vidioc_enum_input);
687                         SET_VALID_IOCTL(ops, VIDIOC_G_INPUT, vidioc_g_input);
688                         SET_VALID_IOCTL(ops, VIDIOC_S_INPUT, vidioc_s_input);
689                         SET_VALID_IOCTL(ops, VIDIOC_ENUMAUDIO, vidioc_enumaudio);
690                         SET_VALID_IOCTL(ops, VIDIOC_G_AUDIO, vidioc_g_audio);
691                         SET_VALID_IOCTL(ops, VIDIOC_S_AUDIO, vidioc_s_audio);
692                         SET_VALID_IOCTL(ops, VIDIOC_QUERY_DV_TIMINGS, vidioc_query_dv_timings);
693                         SET_VALID_IOCTL(ops, VIDIOC_S_EDID, vidioc_s_edid);
694                 }
695                 if (is_tx) {
696                         SET_VALID_IOCTL(ops, VIDIOC_ENUMOUTPUT, vidioc_enum_output);
697                         SET_VALID_IOCTL(ops, VIDIOC_G_OUTPUT, vidioc_g_output);
698                         SET_VALID_IOCTL(ops, VIDIOC_S_OUTPUT, vidioc_s_output);
699                         SET_VALID_IOCTL(ops, VIDIOC_ENUMAUDOUT, vidioc_enumaudout);
700                         SET_VALID_IOCTL(ops, VIDIOC_G_AUDOUT, vidioc_g_audout);
701                         SET_VALID_IOCTL(ops, VIDIOC_S_AUDOUT, vidioc_s_audout);
702                 }
703                 if (ops->vidioc_g_parm || (vdev->vfl_type == VFL_TYPE_GRABBER &&
704                                         ops->vidioc_g_std))
705                         set_bit(_IOC_NR(VIDIOC_G_PARM), valid_ioctls);
706                 SET_VALID_IOCTL(ops, VIDIOC_S_PARM, vidioc_s_parm);
707                 SET_VALID_IOCTL(ops, VIDIOC_S_DV_TIMINGS, vidioc_s_dv_timings);
708                 SET_VALID_IOCTL(ops, VIDIOC_G_DV_TIMINGS, vidioc_g_dv_timings);
709                 SET_VALID_IOCTL(ops, VIDIOC_ENUM_DV_TIMINGS, vidioc_enum_dv_timings);
710                 SET_VALID_IOCTL(ops, VIDIOC_DV_TIMINGS_CAP, vidioc_dv_timings_cap);
711                 SET_VALID_IOCTL(ops, VIDIOC_G_EDID, vidioc_g_edid);
712         }
713         if (is_tx && (is_radio || is_sdr)) {
714                 /* radio transmitter only ioctls */
715                 SET_VALID_IOCTL(ops, VIDIOC_G_MODULATOR, vidioc_g_modulator);
716                 SET_VALID_IOCTL(ops, VIDIOC_S_MODULATOR, vidioc_s_modulator);
717         }
718         if (is_rx) {
719                 /* receiver only ioctls */
720                 SET_VALID_IOCTL(ops, VIDIOC_G_TUNER, vidioc_g_tuner);
721                 SET_VALID_IOCTL(ops, VIDIOC_S_TUNER, vidioc_s_tuner);
722                 SET_VALID_IOCTL(ops, VIDIOC_S_HW_FREQ_SEEK, vidioc_s_hw_freq_seek);
723         }
724
725         bitmap_andnot(vdev->valid_ioctls, valid_ioctls, vdev->valid_ioctls,
726                         BASE_VIDIOC_PRIVATE);
727 }
728
729 static int video_register_media_controller(struct video_device *vdev, int type)
730 {
731 #if defined(CONFIG_MEDIA_CONTROLLER)
732         u32 intf_type;
733         int ret;
734
735         if (!vdev->v4l2_dev->mdev)
736                 return 0;
737
738         vdev->entity.obj_type = MEDIA_ENTITY_TYPE_VIDEO_DEVICE;
739         vdev->entity.function = MEDIA_ENT_F_UNKNOWN;
740
741         switch (type) {
742         case VFL_TYPE_GRABBER:
743                 intf_type = MEDIA_INTF_T_V4L_VIDEO;
744                 vdev->entity.function = MEDIA_ENT_F_IO_V4L;
745                 break;
746         case VFL_TYPE_VBI:
747                 intf_type = MEDIA_INTF_T_V4L_VBI;
748                 vdev->entity.function = MEDIA_ENT_F_IO_VBI;
749                 break;
750         case VFL_TYPE_SDR:
751                 intf_type = MEDIA_INTF_T_V4L_SWRADIO;
752                 vdev->entity.function = MEDIA_ENT_F_IO_SWRADIO;
753                 break;
754         case VFL_TYPE_RADIO:
755                 intf_type = MEDIA_INTF_T_V4L_RADIO;
756                 /*
757                  * Radio doesn't have an entity at the V4L2 side to represent
758                  * radio input or output. Instead, the audio input/output goes
759                  * via either physical wires or ALSA.
760                  */
761                 break;
762         case VFL_TYPE_SUBDEV:
763                 intf_type = MEDIA_INTF_T_V4L_SUBDEV;
764                 /* Entity will be created via v4l2_device_register_subdev() */
765                 break;
766         default:
767                 return 0;
768         }
769
770         if (vdev->entity.function != MEDIA_ENT_F_UNKNOWN) {
771                 vdev->entity.name = vdev->name;
772
773                 /* Needed just for backward compatibility with legacy MC API */
774                 vdev->entity.info.dev.major = VIDEO_MAJOR;
775                 vdev->entity.info.dev.minor = vdev->minor;
776
777                 ret = media_device_register_entity(vdev->v4l2_dev->mdev,
778                                                    &vdev->entity);
779                 if (ret < 0) {
780                         printk(KERN_WARNING
781                                 "%s: media_device_register_entity failed\n",
782                                 __func__);
783                         return ret;
784                 }
785         }
786
787         vdev->intf_devnode = media_devnode_create(vdev->v4l2_dev->mdev,
788                                                   intf_type,
789                                                   0, VIDEO_MAJOR,
790                                                   vdev->minor);
791         if (!vdev->intf_devnode) {
792                 media_device_unregister_entity(&vdev->entity);
793                 return -ENOMEM;
794         }
795
796         if (vdev->entity.function != MEDIA_ENT_F_UNKNOWN) {
797                 struct media_link *link;
798
799                 link = media_create_intf_link(&vdev->entity,
800                                               &vdev->intf_devnode->intf,
801                                               MEDIA_LNK_FL_ENABLED);
802                 if (!link) {
803                         media_devnode_remove(vdev->intf_devnode);
804                         media_device_unregister_entity(&vdev->entity);
805                         return -ENOMEM;
806                 }
807         }
808
809         /* FIXME: how to create the other interface links? */
810
811 #endif
812         return 0;
813 }
814
815 /**
816  *      __video_register_device - register video4linux devices
817  *      @vdev: video device structure we want to register
818  *      @type: type of device to register
819  *      @nr:   which device node number (0 == /dev/video0, 1 == /dev/video1, ...
820  *             -1 == first free)
821  *      @warn_if_nr_in_use: warn if the desired device node number
822  *             was already in use and another number was chosen instead.
823  *      @owner: module that owns the video device node
824  *
825  *      The registration code assigns minor numbers and device node numbers
826  *      based on the requested type and registers the new device node with
827  *      the kernel.
828  *
829  *      This function assumes that struct video_device was zeroed when it
830  *      was allocated and does not contain any stale date.
831  *
832  *      An error is returned if no free minor or device node number could be
833  *      found, or if the registration of the device node failed.
834  *
835  *      Zero is returned on success.
836  *
837  *      Valid types are
838  *
839  *      %VFL_TYPE_GRABBER - A frame grabber
840  *
841  *      %VFL_TYPE_VBI - Vertical blank data (undecoded)
842  *
843  *      %VFL_TYPE_RADIO - A radio card
844  *
845  *      %VFL_TYPE_SUBDEV - A subdevice
846  *
847  *      %VFL_TYPE_SDR - Software Defined Radio
848  */
849 int __video_register_device(struct video_device *vdev, int type, int nr,
850                 int warn_if_nr_in_use, struct module *owner)
851 {
852         int i = 0;
853         int ret;
854         int minor_offset = 0;
855         int minor_cnt = VIDEO_NUM_DEVICES;
856         const char *name_base;
857
858         /* A minor value of -1 marks this video device as never
859            having been registered */
860         vdev->minor = -1;
861
862         /* the release callback MUST be present */
863         if (WARN_ON(!vdev->release))
864                 return -EINVAL;
865         /* the v4l2_dev pointer MUST be present */
866         if (WARN_ON(!vdev->v4l2_dev))
867                 return -EINVAL;
868
869         /* v4l2_fh support */
870         spin_lock_init(&vdev->fh_lock);
871         INIT_LIST_HEAD(&vdev->fh_list);
872
873         /* Part 1: check device type */
874         switch (type) {
875         case VFL_TYPE_GRABBER:
876                 name_base = "video";
877                 break;
878         case VFL_TYPE_VBI:
879                 name_base = "vbi";
880                 break;
881         case VFL_TYPE_RADIO:
882                 name_base = "radio";
883                 break;
884         case VFL_TYPE_SUBDEV:
885                 name_base = "v4l-subdev";
886                 break;
887         case VFL_TYPE_SDR:
888                 /* Use device name 'swradio' because 'sdr' was already taken. */
889                 name_base = "swradio";
890                 break;
891         default:
892                 printk(KERN_ERR "%s called with unknown type: %d\n",
893                        __func__, type);
894                 return -EINVAL;
895         }
896
897         vdev->vfl_type = type;
898         vdev->cdev = NULL;
899         if (vdev->dev_parent == NULL)
900                 vdev->dev_parent = vdev->v4l2_dev->dev;
901         if (vdev->ctrl_handler == NULL)
902                 vdev->ctrl_handler = vdev->v4l2_dev->ctrl_handler;
903         /* If the prio state pointer is NULL, then use the v4l2_device
904            prio state. */
905         if (vdev->prio == NULL)
906                 vdev->prio = &vdev->v4l2_dev->prio;
907
908         /* Part 2: find a free minor, device node number and device index. */
909 #ifdef CONFIG_VIDEO_FIXED_MINOR_RANGES
910         /* Keep the ranges for the first four types for historical
911          * reasons.
912          * Newer devices (not yet in place) should use the range
913          * of 128-191 and just pick the first free minor there
914          * (new style). */
915         switch (type) {
916         case VFL_TYPE_GRABBER:
917                 minor_offset = 0;
918                 minor_cnt = 64;
919                 break;
920         case VFL_TYPE_RADIO:
921                 minor_offset = 64;
922                 minor_cnt = 64;
923                 break;
924         case VFL_TYPE_VBI:
925                 minor_offset = 224;
926                 minor_cnt = 32;
927                 break;
928         default:
929                 minor_offset = 128;
930                 minor_cnt = 64;
931                 break;
932         }
933 #endif
934
935         /* Pick a device node number */
936         mutex_lock(&videodev_lock);
937         nr = devnode_find(vdev, nr == -1 ? 0 : nr, minor_cnt);
938         if (nr == minor_cnt)
939                 nr = devnode_find(vdev, 0, minor_cnt);
940         if (nr == minor_cnt) {
941                 printk(KERN_ERR "could not get a free device node number\n");
942                 mutex_unlock(&videodev_lock);
943                 return -ENFILE;
944         }
945 #ifdef CONFIG_VIDEO_FIXED_MINOR_RANGES
946         /* 1-on-1 mapping of device node number to minor number */
947         i = nr;
948 #else
949         /* The device node number and minor numbers are independent, so
950            we just find the first free minor number. */
951         for (i = 0; i < VIDEO_NUM_DEVICES; i++)
952                 if (video_device[i] == NULL)
953                         break;
954         if (i == VIDEO_NUM_DEVICES) {
955                 mutex_unlock(&videodev_lock);
956                 printk(KERN_ERR "could not get a free minor\n");
957                 return -ENFILE;
958         }
959 #endif
960         vdev->minor = i + minor_offset;
961         vdev->num = nr;
962         devnode_set(vdev);
963
964         /* Should not happen since we thought this minor was free */
965         WARN_ON(video_device[vdev->minor] != NULL);
966         vdev->index = get_index(vdev);
967         video_device[vdev->minor] = vdev;
968         mutex_unlock(&videodev_lock);
969
970         if (vdev->ioctl_ops)
971                 determine_valid_ioctls(vdev);
972
973         /* Part 3: Initialize the character device */
974         vdev->cdev = cdev_alloc();
975         if (vdev->cdev == NULL) {
976                 ret = -ENOMEM;
977                 goto cleanup;
978         }
979         vdev->cdev->ops = &v4l2_fops;
980         vdev->cdev->owner = owner;
981         ret = cdev_add(vdev->cdev, MKDEV(VIDEO_MAJOR, vdev->minor), 1);
982         if (ret < 0) {
983                 printk(KERN_ERR "%s: cdev_add failed\n", __func__);
984                 kfree(vdev->cdev);
985                 vdev->cdev = NULL;
986                 goto cleanup;
987         }
988
989         /* Part 4: register the device with sysfs */
990         vdev->dev.class = &video_class;
991         vdev->dev.devt = MKDEV(VIDEO_MAJOR, vdev->minor);
992         vdev->dev.parent = vdev->dev_parent;
993         dev_set_name(&vdev->dev, "%s%d", name_base, vdev->num);
994         ret = device_register(&vdev->dev);
995         if (ret < 0) {
996                 printk(KERN_ERR "%s: device_register failed\n", __func__);
997                 goto cleanup;
998         }
999         /* Register the release callback that will be called when the last
1000            reference to the device goes away. */
1001         vdev->dev.release = v4l2_device_release;
1002
1003         if (nr != -1 && nr != vdev->num && warn_if_nr_in_use)
1004                 printk(KERN_WARNING "%s: requested %s%d, got %s\n", __func__,
1005                         name_base, nr, video_device_node_name(vdev));
1006
1007         /* Increase v4l2_device refcount */
1008         v4l2_device_get(vdev->v4l2_dev);
1009
1010         /* Part 5: Register the entity. */
1011         ret = video_register_media_controller(vdev, type);
1012
1013         /* Part 6: Activate this minor. The char device can now be used. */
1014         set_bit(V4L2_FL_REGISTERED, &vdev->flags);
1015
1016         return 0;
1017
1018 cleanup:
1019         mutex_lock(&videodev_lock);
1020         if (vdev->cdev)
1021                 cdev_del(vdev->cdev);
1022         video_device[vdev->minor] = NULL;
1023         devnode_clear(vdev);
1024         mutex_unlock(&videodev_lock);
1025         /* Mark this video device as never having been registered. */
1026         vdev->minor = -1;
1027         return ret;
1028 }
1029 EXPORT_SYMBOL(__video_register_device);
1030
1031 /**
1032  *      video_unregister_device - unregister a video4linux device
1033  *      @vdev: the device to unregister
1034  *
1035  *      This unregisters the passed device. Future open calls will
1036  *      be met with errors.
1037  */
1038 void video_unregister_device(struct video_device *vdev)
1039 {
1040         /* Check if vdev was ever registered at all */
1041         if (!vdev || !video_is_registered(vdev))
1042                 return;
1043
1044         mutex_lock(&videodev_lock);
1045         /* This must be in a critical section to prevent a race with v4l2_open.
1046          * Once this bit has been cleared video_get may never be called again.
1047          */
1048         clear_bit(V4L2_FL_REGISTERED, &vdev->flags);
1049         mutex_unlock(&videodev_lock);
1050         device_unregister(&vdev->dev);
1051 }
1052 EXPORT_SYMBOL(video_unregister_device);
1053
1054 /*
1055  *      Initialise video for linux
1056  */
1057 static int __init videodev_init(void)
1058 {
1059         dev_t dev = MKDEV(VIDEO_MAJOR, 0);
1060         int ret;
1061
1062         printk(KERN_INFO "Linux video capture interface: v2.00\n");
1063         ret = register_chrdev_region(dev, VIDEO_NUM_DEVICES, VIDEO_NAME);
1064         if (ret < 0) {
1065                 printk(KERN_WARNING "videodev: unable to get major %d\n",
1066                                 VIDEO_MAJOR);
1067                 return ret;
1068         }
1069
1070         ret = class_register(&video_class);
1071         if (ret < 0) {
1072                 unregister_chrdev_region(dev, VIDEO_NUM_DEVICES);
1073                 printk(KERN_WARNING "video_dev: class_register failed\n");
1074                 return -EIO;
1075         }
1076
1077         return 0;
1078 }
1079
1080 static void __exit videodev_exit(void)
1081 {
1082         dev_t dev = MKDEV(VIDEO_MAJOR, 0);
1083
1084         class_unregister(&video_class);
1085         unregister_chrdev_region(dev, VIDEO_NUM_DEVICES);
1086 }
1087
1088 subsys_initcall(videodev_init);
1089 module_exit(videodev_exit)
1090
1091 MODULE_AUTHOR("Alan Cox, Mauro Carvalho Chehab <mchehab@infradead.org>");
1092 MODULE_DESCRIPTION("Device registrar for Video4Linux drivers v2");
1093 MODULE_LICENSE("GPL");
1094 MODULE_ALIAS_CHARDEV_MAJOR(VIDEO_MAJOR);