Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* |
2 | * dvbdev.c | |
3 | * | |
4 | * Copyright (C) 2000 Ralph Metzler <ralph@convergence.de> | |
5 | * & Marcus Metzler <marcus@convergence.de> | |
6 | * for convergence integrated media GmbH | |
7 | * | |
8 | * This program is free software; you can redistribute it and/or | |
9 | * modify it under the terms of the GNU Lesser General Public License | |
10 | * as published by the Free Software Foundation; either version 2.1 | |
11 | * of the License, or (at your option) any later version. | |
12 | * | |
13 | * This program is distributed in the hope that it will be useful, | |
14 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 | * GNU General Public License for more details. | |
17 | * | |
1da177e4 LT |
18 | */ |
19 | ||
b3ad24d2 MCC |
20 | #define pr_fmt(fmt) "dvbdev: " fmt |
21 | ||
1da177e4 LT |
22 | #include <linux/types.h> |
23 | #include <linux/errno.h> | |
24 | #include <linux/string.h> | |
25 | #include <linux/module.h> | |
1da177e4 | 26 | #include <linux/kernel.h> |
1da177e4 LT |
27 | #include <linux/init.h> |
28 | #include <linux/slab.h> | |
29 | #include <linux/device.h> | |
30 | #include <linux/fs.h> | |
31 | #include <linux/cdev.h> | |
1e4baed3 | 32 | #include <linux/mutex.h> |
1da177e4 LT |
33 | #include "dvbdev.h" |
34 | ||
188d2d55 MCC |
35 | /* Due to enum tuner_pad_index */ |
36 | #include <media/tuner.h> | |
37 | ||
72024f1e | 38 | static DEFINE_MUTEX(dvbdev_mutex); |
1da177e4 LT |
39 | static int dvbdev_debug; |
40 | ||
41 | module_param(dvbdev_debug, int, 0644); | |
42 | MODULE_PARM_DESC(dvbdev_debug, "Turn on/off device debugging (default:off)."); | |
43 | ||
b3ad24d2 MCC |
44 | #define dprintk(fmt, arg...) do { \ |
45 | if (dvbdev_debug) \ | |
46 | printk(KERN_DEBUG pr_fmt("%s: " fmt), \ | |
47 | __func__, ##arg); \ | |
48 | } while (0) | |
1da177e4 LT |
49 | |
50 | static LIST_HEAD(dvb_adapter_list); | |
1e4baed3 | 51 | static DEFINE_MUTEX(dvbdev_register_lock); |
1da177e4 LT |
52 | |
53 | static const char * const dnames[] = { | |
6bbf7a85 MCC |
54 | [DVB_DEVICE_VIDEO] = "video", |
55 | [DVB_DEVICE_AUDIO] = "audio", | |
56 | [DVB_DEVICE_SEC] = "sec", | |
57 | [DVB_DEVICE_FRONTEND] = "frontend", | |
58 | [DVB_DEVICE_DEMUX] = "demux", | |
59 | [DVB_DEVICE_DVR] = "dvr", | |
60 | [DVB_DEVICE_CA] = "ca", | |
61 | [DVB_DEVICE_NET] = "net", | |
62 | [DVB_DEVICE_OSD] = "osd" | |
1da177e4 LT |
63 | }; |
64 | ||
5dd3f307 AO |
65 | #ifdef CONFIG_DVB_DYNAMIC_MINORS |
66 | #define MAX_DVB_MINORS 256 | |
67 | #define DVB_MAX_IDS MAX_DVB_MINORS | |
68 | #else | |
1da177e4 | 69 | #define DVB_MAX_IDS 4 |
6bbf7a85 MCC |
70 | |
71 | static int nums2minor(int num, enum dvb_device_type type, int id) | |
72 | { | |
73 | int n = (num << 6) | (id << 4); | |
74 | ||
75 | switch (type) { | |
76 | case DVB_DEVICE_VIDEO: return n; | |
77 | case DVB_DEVICE_AUDIO: return n | 1; | |
78 | case DVB_DEVICE_SEC: return n | 2; | |
79 | case DVB_DEVICE_FRONTEND: return n | 3; | |
80 | case DVB_DEVICE_DEMUX: return n | 4; | |
81 | case DVB_DEVICE_DVR: return n | 5; | |
82 | case DVB_DEVICE_CA: return n | 6; | |
83 | case DVB_DEVICE_NET: return n | 7; | |
84 | case DVB_DEVICE_OSD: return n | 8; | |
85 | } | |
86 | } | |
87 | ||
1da177e4 | 88 | #define MAX_DVB_MINORS (DVB_MAX_ADAPTERS*64) |
5dd3f307 | 89 | #endif |
1da177e4 | 90 | |
56b22935 | 91 | static struct class *dvb_class; |
1da177e4 | 92 | |
5dd3f307 AO |
93 | static struct dvb_device *dvb_minors[MAX_DVB_MINORS]; |
94 | static DECLARE_RWSEM(minor_rwsem); | |
1da177e4 LT |
95 | |
96 | static int dvb_device_open(struct inode *inode, struct file *file) | |
97 | { | |
98 | struct dvb_device *dvbdev; | |
99 | ||
72024f1e | 100 | mutex_lock(&dvbdev_mutex); |
5dd3f307 AO |
101 | down_read(&minor_rwsem); |
102 | dvbdev = dvb_minors[iminor(inode)]; | |
1da177e4 LT |
103 | |
104 | if (dvbdev && dvbdev->fops) { | |
105 | int err = 0; | |
e84f9e57 | 106 | const struct file_operations *new_fops; |
1da177e4 | 107 | |
e84f9e57 AV |
108 | new_fops = fops_get(dvbdev->fops); |
109 | if (!new_fops) | |
f41ced8f | 110 | goto fail; |
e84f9e57 AV |
111 | file->private_data = dvbdev; |
112 | replace_fops(file, new_fops); | |
113 | if (file->f_op->open) | |
0ede1876 | 114 | err = file->f_op->open(inode, file); |
5dd3f307 | 115 | up_read(&minor_rwsem); |
72024f1e | 116 | mutex_unlock(&dvbdev_mutex); |
afd1a0c9 | 117 | return err; |
1da177e4 | 118 | } |
f41ced8f | 119 | fail: |
5dd3f307 | 120 | up_read(&minor_rwsem); |
72024f1e | 121 | mutex_unlock(&dvbdev_mutex); |
1da177e4 LT |
122 | return -ENODEV; |
123 | } | |
124 | ||
125 | ||
27a643b1 | 126 | static const struct file_operations dvb_device_fops = |
1da177e4 LT |
127 | { |
128 | .owner = THIS_MODULE, | |
129 | .open = dvb_device_open, | |
6038f373 | 130 | .llseek = noop_llseek, |
1da177e4 LT |
131 | }; |
132 | ||
7e7654a9 | 133 | static struct cdev dvb_device_cdev; |
1da177e4 LT |
134 | |
135 | int dvb_generic_open(struct inode *inode, struct file *file) | |
136 | { | |
afd1a0c9 | 137 | struct dvb_device *dvbdev = file->private_data; |
1da177e4 | 138 | |
afd1a0c9 MCC |
139 | if (!dvbdev) |
140 | return -ENODEV; | |
1da177e4 LT |
141 | |
142 | if (!dvbdev->users) | |
afd1a0c9 | 143 | return -EBUSY; |
1da177e4 LT |
144 | |
145 | if ((file->f_flags & O_ACCMODE) == O_RDONLY) { | |
afd1a0c9 MCC |
146 | if (!dvbdev->readers) |
147 | return -EBUSY; | |
1da177e4 LT |
148 | dvbdev->readers--; |
149 | } else { | |
afd1a0c9 MCC |
150 | if (!dvbdev->writers) |
151 | return -EBUSY; | |
1da177e4 LT |
152 | dvbdev->writers--; |
153 | } | |
154 | ||
155 | dvbdev->users--; | |
156 | return 0; | |
157 | } | |
158 | EXPORT_SYMBOL(dvb_generic_open); | |
159 | ||
160 | ||
161 | int dvb_generic_release(struct inode *inode, struct file *file) | |
162 | { | |
afd1a0c9 | 163 | struct dvb_device *dvbdev = file->private_data; |
1da177e4 LT |
164 | |
165 | if (!dvbdev) | |
afd1a0c9 | 166 | return -ENODEV; |
1da177e4 LT |
167 | |
168 | if ((file->f_flags & O_ACCMODE) == O_RDONLY) { | |
169 | dvbdev->readers++; | |
170 | } else { | |
171 | dvbdev->writers++; | |
172 | } | |
173 | ||
174 | dvbdev->users++; | |
175 | return 0; | |
176 | } | |
177 | EXPORT_SYMBOL(dvb_generic_release); | |
178 | ||
179 | ||
16ef8def AB |
180 | long dvb_generic_ioctl(struct file *file, |
181 | unsigned int cmd, unsigned long arg) | |
1da177e4 | 182 | { |
afd1a0c9 | 183 | struct dvb_device *dvbdev = file->private_data; |
1da177e4 | 184 | |
afd1a0c9 MCC |
185 | if (!dvbdev) |
186 | return -ENODEV; | |
1da177e4 LT |
187 | |
188 | if (!dvbdev->kernel_ioctl) | |
189 | return -EINVAL; | |
190 | ||
72024f1e | 191 | return dvb_usercopy(file, cmd, arg, dvbdev->kernel_ioctl); |
1da177e4 LT |
192 | } |
193 | EXPORT_SYMBOL(dvb_generic_ioctl); | |
194 | ||
195 | ||
196 | static int dvbdev_get_free_id (struct dvb_adapter *adap, int type) | |
197 | { | |
198 | u32 id = 0; | |
199 | ||
200 | while (id < DVB_MAX_IDS) { | |
79482619 TP |
201 | struct dvb_device *dev; |
202 | list_for_each_entry(dev, &adap->device_list, list_head) | |
1da177e4 LT |
203 | if (dev->type == type && dev->id == id) |
204 | goto skip; | |
1da177e4 LT |
205 | return id; |
206 | skip: | |
207 | id++; | |
208 | } | |
209 | return -ENFILE; | |
210 | } | |
211 | ||
f50d5166 MCC |
212 | static void dvb_media_device_free(struct dvb_device *dvbdev) |
213 | { | |
214 | #if defined(CONFIG_MEDIA_CONTROLLER_DVB) | |
215 | if (dvbdev->entity) { | |
216 | media_device_unregister_entity(dvbdev->entity); | |
217 | kfree(dvbdev->entity); | |
218 | kfree(dvbdev->pads); | |
219 | dvbdev->entity = NULL; | |
220 | dvbdev->pads = NULL; | |
221 | } | |
222 | ||
223 | if (dvbdev->tsout_entity) { | |
224 | int i; | |
225 | ||
226 | for (i = 0; i < dvbdev->tsout_num_entities; i++) { | |
227 | media_device_unregister_entity(&dvbdev->tsout_entity[i]); | |
228 | kfree(dvbdev->tsout_entity[i].name); | |
229 | } | |
230 | kfree(dvbdev->tsout_entity); | |
231 | kfree(dvbdev->tsout_pads); | |
232 | dvbdev->tsout_entity = NULL; | |
233 | dvbdev->tsout_pads = NULL; | |
234 | ||
235 | dvbdev->tsout_num_entities = 0; | |
236 | } | |
237 | ||
238 | if (dvbdev->intf_devnode) { | |
239 | media_devnode_remove(dvbdev->intf_devnode); | |
240 | dvbdev->intf_devnode = NULL; | |
241 | } | |
0230d60e MCC |
242 | |
243 | if (dvbdev->adapter->conn) { | |
244 | media_device_unregister_entity(dvbdev->adapter->conn); | |
245 | dvbdev->adapter->conn = NULL; | |
246 | kfree(dvbdev->adapter->conn_pads); | |
247 | dvbdev->adapter->conn_pads = NULL; | |
248 | } | |
f50d5166 MCC |
249 | #endif |
250 | } | |
251 | ||
0820eb5c | 252 | #if defined(CONFIG_MEDIA_CONTROLLER_DVB) |
f50d5166 | 253 | static int dvb_create_tsout_entity(struct dvb_device *dvbdev, |
df2f94e5 MCC |
254 | const char *name, int npads) |
255 | { | |
df2f94e5 MCC |
256 | int i, ret = 0; |
257 | ||
258 | dvbdev->tsout_pads = kcalloc(npads, sizeof(*dvbdev->tsout_pads), | |
259 | GFP_KERNEL); | |
260 | if (!dvbdev->tsout_pads) | |
f50d5166 MCC |
261 | return -ENOMEM; |
262 | ||
df2f94e5 MCC |
263 | dvbdev->tsout_entity = kcalloc(npads, sizeof(*dvbdev->tsout_entity), |
264 | GFP_KERNEL); | |
f50d5166 MCC |
265 | if (!dvbdev->tsout_entity) |
266 | return -ENOMEM; | |
267 | ||
268 | dvbdev->tsout_num_entities = npads; | |
269 | ||
df2f94e5 MCC |
270 | for (i = 0; i < npads; i++) { |
271 | struct media_pad *pads = &dvbdev->tsout_pads[i]; | |
272 | struct media_entity *entity = &dvbdev->tsout_entity[i]; | |
273 | ||
274 | entity->name = kasprintf(GFP_KERNEL, "%s #%d", name, i); | |
f50d5166 MCC |
275 | if (!entity->name) |
276 | return -ENOMEM; | |
df2f94e5 | 277 | |
4ca72efa | 278 | entity->function = MEDIA_ENT_F_IO_DTV; |
df2f94e5 MCC |
279 | pads->flags = MEDIA_PAD_FL_SINK; |
280 | ||
ab22e77c | 281 | ret = media_entity_pads_init(entity, 1, pads); |
df2f94e5 | 282 | if (ret < 0) |
f50d5166 | 283 | return ret; |
df2f94e5 MCC |
284 | |
285 | ret = media_device_register_entity(dvbdev->adapter->mdev, | |
286 | entity); | |
287 | if (ret < 0) | |
f50d5166 | 288 | return ret; |
df2f94e5 | 289 | } |
f50d5166 | 290 | return 0; |
df2f94e5 MCC |
291 | } |
292 | ||
293 | #define DEMUX_TSOUT "demux-tsout" | |
294 | #define DVR_TSOUT "dvr-tsout" | |
295 | ||
f50d5166 MCC |
296 | static int dvb_create_media_entity(struct dvb_device *dvbdev, |
297 | int type, int demux_sink_pads) | |
a0246e02 | 298 | { |
f50d5166 | 299 | int i, ret, npads; |
a0246e02 | 300 | |
8211b187 MCC |
301 | switch (type) { |
302 | case DVB_DEVICE_FRONTEND: | |
303 | npads = 2; | |
304 | break; | |
df2f94e5 | 305 | case DVB_DEVICE_DVR: |
f50d5166 MCC |
306 | ret = dvb_create_tsout_entity(dvbdev, DVR_TSOUT, |
307 | demux_sink_pads); | |
308 | return ret; | |
8211b187 | 309 | case DVB_DEVICE_DEMUX: |
df2f94e5 | 310 | npads = 1 + demux_sink_pads; |
f50d5166 MCC |
311 | ret = dvb_create_tsout_entity(dvbdev, DEMUX_TSOUT, |
312 | demux_sink_pads); | |
313 | if (ret < 0) | |
314 | return ret; | |
8211b187 MCC |
315 | break; |
316 | case DVB_DEVICE_CA: | |
317 | npads = 2; | |
318 | break; | |
319 | case DVB_DEVICE_NET: | |
320 | /* | |
321 | * We should be creating entities for the MPE/ULE | |
322 | * decapsulation hardware (or software implementation). | |
323 | * | |
324 | * However, the number of for the MPE/ULE decaps may not be | |
325 | * fixed. As we don't have yet dynamic support for PADs at | |
326 | * the Media Controller, let's not create the decap | |
327 | * entities yet. | |
328 | */ | |
f50d5166 | 329 | return 0; |
8211b187 | 330 | default: |
f50d5166 | 331 | return 0; |
8211b187 | 332 | } |
a0246e02 MCC |
333 | |
334 | dvbdev->entity = kzalloc(sizeof(*dvbdev->entity), GFP_KERNEL); | |
335 | if (!dvbdev->entity) | |
f50d5166 | 336 | return -ENOMEM; |
a0246e02 | 337 | |
a0246e02 | 338 | dvbdev->entity->name = dvbdev->name; |
172e9d3c | 339 | |
172e9d3c MCC |
340 | if (npads) { |
341 | dvbdev->pads = kcalloc(npads, sizeof(*dvbdev->pads), | |
342 | GFP_KERNEL); | |
f50d5166 MCC |
343 | if (!dvbdev->pads) |
344 | return -ENOMEM; | |
172e9d3c MCC |
345 | } |
346 | ||
a0246e02 MCC |
347 | switch (type) { |
348 | case DVB_DEVICE_FRONTEND: | |
4ca72efa | 349 | dvbdev->entity->function = MEDIA_ENT_F_DTV_DEMOD; |
3bde1b78 MCC |
350 | dvbdev->pads[0].flags = MEDIA_PAD_FL_SINK; |
351 | dvbdev->pads[1].flags = MEDIA_PAD_FL_SOURCE; | |
a0246e02 MCC |
352 | break; |
353 | case DVB_DEVICE_DEMUX: | |
4ca72efa | 354 | dvbdev->entity->function = MEDIA_ENT_F_TS_DEMUX; |
3bde1b78 | 355 | dvbdev->pads[0].flags = MEDIA_PAD_FL_SINK; |
df2f94e5 MCC |
356 | for (i = 1; i < npads; i++) |
357 | dvbdev->pads[i].flags = MEDIA_PAD_FL_SOURCE; | |
a0246e02 | 358 | break; |
a0246e02 | 359 | case DVB_DEVICE_CA: |
4ca72efa | 360 | dvbdev->entity->function = MEDIA_ENT_F_DTV_CA; |
3bde1b78 MCC |
361 | dvbdev->pads[0].flags = MEDIA_PAD_FL_SINK; |
362 | dvbdev->pads[1].flags = MEDIA_PAD_FL_SOURCE; | |
a0246e02 | 363 | break; |
a0246e02 | 364 | default: |
f50d5166 | 365 | /* Should never happen, as the first switch prevents it */ |
a0246e02 | 366 | kfree(dvbdev->entity); |
f50d5166 | 367 | kfree(dvbdev->pads); |
a0246e02 | 368 | dvbdev->entity = NULL; |
f50d5166 MCC |
369 | dvbdev->pads = NULL; |
370 | return 0; | |
a0246e02 MCC |
371 | } |
372 | ||
f50d5166 | 373 | if (npads) { |
ab22e77c | 374 | ret = media_entity_pads_init(dvbdev->entity, npads, dvbdev->pads); |
f50d5166 MCC |
375 | if (ret) |
376 | return ret; | |
a0246e02 | 377 | } |
f50d5166 MCC |
378 | ret = media_device_register_entity(dvbdev->adapter->mdev, |
379 | dvbdev->entity); | |
380 | if (ret) | |
eac287ad | 381 | return ret; |
a0246e02 | 382 | |
b3ad24d2 | 383 | pr_info("%s: media entity '%s' registered.\n", |
a0246e02 | 384 | __func__, dvbdev->entity->name); |
f50d5166 | 385 | |
f50d5166 | 386 | return 0; |
a0246e02 | 387 | } |
0820eb5c | 388 | #endif |
1da177e4 | 389 | |
f50d5166 MCC |
390 | static int dvb_register_media_device(struct dvb_device *dvbdev, |
391 | int type, int minor, | |
392 | unsigned demux_sink_pads) | |
8211b187 MCC |
393 | { |
394 | #if defined(CONFIG_MEDIA_CONTROLLER_DVB) | |
f50d5166 | 395 | struct media_link *link; |
8211b187 | 396 | u32 intf_type; |
f50d5166 | 397 | int ret; |
8211b187 MCC |
398 | |
399 | if (!dvbdev->adapter->mdev) | |
f50d5166 | 400 | return 0; |
8211b187 | 401 | |
f50d5166 MCC |
402 | ret = dvb_create_media_entity(dvbdev, type, demux_sink_pads); |
403 | if (ret) | |
404 | return ret; | |
8211b187 MCC |
405 | |
406 | switch (type) { | |
407 | case DVB_DEVICE_FRONTEND: | |
408 | intf_type = MEDIA_INTF_T_DVB_FE; | |
409 | break; | |
410 | case DVB_DEVICE_DEMUX: | |
411 | intf_type = MEDIA_INTF_T_DVB_DEMUX; | |
412 | break; | |
413 | case DVB_DEVICE_DVR: | |
414 | intf_type = MEDIA_INTF_T_DVB_DVR; | |
415 | break; | |
416 | case DVB_DEVICE_CA: | |
417 | intf_type = MEDIA_INTF_T_DVB_CA; | |
418 | break; | |
419 | case DVB_DEVICE_NET: | |
420 | intf_type = MEDIA_INTF_T_DVB_NET; | |
421 | break; | |
422 | default: | |
f50d5166 | 423 | return 0; |
8211b187 MCC |
424 | } |
425 | ||
426 | dvbdev->intf_devnode = media_devnode_create(dvbdev->adapter->mdev, | |
f50d5166 | 427 | intf_type, 0, |
0b3b72df | 428 | DVB_MAJOR, minor); |
f50d5166 MCC |
429 | |
430 | if (!dvbdev->intf_devnode) | |
431 | return -ENOMEM; | |
8211b187 MCC |
432 | |
433 | /* | |
434 | * Create the "obvious" link, e. g. the ones that represent | |
435 | * a direct association between an interface and an entity. | |
436 | * Other links should be created elsewhere, like: | |
437 | * DVB FE intf -> tuner | |
438 | * DVB demux intf -> dvr | |
439 | */ | |
440 | ||
f50d5166 MCC |
441 | if (!dvbdev->entity) |
442 | return 0; | |
8211b187 | 443 | |
f50d5166 MCC |
444 | link = media_create_intf_link(dvbdev->entity, &dvbdev->intf_devnode->intf, |
445 | MEDIA_LNK_FL_ENABLED); | |
446 | if (!link) | |
447 | return -ENOMEM; | |
8211b187 | 448 | #endif |
f50d5166 | 449 | return 0; |
8211b187 MCC |
450 | } |
451 | ||
1da177e4 | 452 | int dvb_register_device(struct dvb_adapter *adap, struct dvb_device **pdvbdev, |
6bbf7a85 MCC |
453 | const struct dvb_device *template, void *priv, |
454 | enum dvb_device_type type, int demux_sink_pads) | |
1da177e4 LT |
455 | { |
456 | struct dvb_device *dvbdev; | |
b6190102 | 457 | struct file_operations *dvbdevfops; |
5f553388 | 458 | struct device *clsdev; |
5dd3f307 | 459 | int minor; |
f50d5166 | 460 | int id, ret; |
1da177e4 | 461 | |
c2788502 | 462 | mutex_lock(&dvbdev_register_lock); |
1da177e4 | 463 | |
b6190102 | 464 | if ((id = dvbdev_get_free_id (adap, type)) < 0){ |
1e4baed3 | 465 | mutex_unlock(&dvbdev_register_lock); |
1da177e4 | 466 | *pdvbdev = NULL; |
b3ad24d2 | 467 | pr_err("%s: couldn't find free device id\n", __func__); |
1da177e4 LT |
468 | return -ENFILE; |
469 | } | |
470 | ||
f50d5166 | 471 | *pdvbdev = dvbdev = kzalloc(sizeof(*dvbdev), GFP_KERNEL); |
1da177e4 | 472 | |
b6190102 MS |
473 | if (!dvbdev){ |
474 | mutex_unlock(&dvbdev_register_lock); | |
475 | return -ENOMEM; | |
476 | } | |
477 | ||
478 | dvbdevfops = kzalloc(sizeof(struct file_operations), GFP_KERNEL); | |
479 | ||
480 | if (!dvbdevfops){ | |
481 | kfree (dvbdev); | |
1e4baed3 | 482 | mutex_unlock(&dvbdev_register_lock); |
1da177e4 LT |
483 | return -ENOMEM; |
484 | } | |
485 | ||
1da177e4 LT |
486 | memcpy(dvbdev, template, sizeof(struct dvb_device)); |
487 | dvbdev->type = type; | |
488 | dvbdev->id = id; | |
489 | dvbdev->adapter = adap; | |
490 | dvbdev->priv = priv; | |
b6190102 | 491 | dvbdev->fops = dvbdevfops; |
ca5be9cd | 492 | init_waitqueue_head (&dvbdev->wait_queue); |
1da177e4 | 493 | |
784e29d2 JE |
494 | memcpy(dvbdevfops, template->fops, sizeof(struct file_operations)); |
495 | dvbdevfops->owner = adap->module; | |
1da177e4 LT |
496 | |
497 | list_add_tail (&dvbdev->list_head, &adap->device_list); | |
498 | ||
5dd3f307 AO |
499 | down_write(&minor_rwsem); |
500 | #ifdef CONFIG_DVB_DYNAMIC_MINORS | |
501 | for (minor = 0; minor < MAX_DVB_MINORS; minor++) | |
502 | if (dvb_minors[minor] == NULL) | |
503 | break; | |
504 | ||
505 | if (minor == MAX_DVB_MINORS) { | |
506 | kfree(dvbdevfops); | |
507 | kfree(dvbdev); | |
82163edc | 508 | up_write(&minor_rwsem); |
5dd3f307 AO |
509 | mutex_unlock(&dvbdev_register_lock); |
510 | return -EINVAL; | |
511 | } | |
512 | #else | |
513 | minor = nums2minor(adap->num, type, id); | |
514 | #endif | |
515 | ||
516 | dvbdev->minor = minor; | |
517 | dvb_minors[minor] = dvbdev; | |
518 | up_write(&minor_rwsem); | |
519 | ||
f50d5166 MCC |
520 | ret = dvb_register_media_device(dvbdev, type, minor, demux_sink_pads); |
521 | if (ret) { | |
b3ad24d2 | 522 | pr_err("%s: dvb_register_media_device failed to create the mediagraph\n", |
f50d5166 MCC |
523 | __func__); |
524 | ||
525 | dvb_media_device_free(dvbdev); | |
526 | kfree(dvbdevfops); | |
527 | kfree(dvbdev); | |
528 | up_write(&minor_rwsem); | |
529 | mutex_unlock(&dvbdev_register_lock); | |
530 | return ret; | |
531 | } | |
532 | ||
f47f4763 AQ |
533 | mutex_unlock(&dvbdev_register_lock); |
534 | ||
a9b12619 | 535 | clsdev = device_create(dvb_class, adap->device, |
b7496780 | 536 | MKDEV(DVB_MAJOR, minor), |
a5f4c0ce | 537 | dvbdev, "dvb%d.%s%d", adap->num, dnames[type], id); |
4abdcf93 | 538 | if (IS_ERR(clsdev)) { |
b3ad24d2 | 539 | pr_err("%s: failed to create device dvb%d.%s%d (%ld)\n", |
46b4f7c1 | 540 | __func__, adap->num, dnames[type], id, PTR_ERR(clsdev)); |
4abdcf93 SA |
541 | return PTR_ERR(clsdev); |
542 | } | |
b3ad24d2 | 543 | dprintk("DVB: register adapter%d/%s%d @ minor: %i (0x%02x)\n", |
5dd3f307 | 544 | adap->num, dnames[type], id, minor, minor); |
1da177e4 LT |
545 | |
546 | return 0; | |
547 | } | |
548 | EXPORT_SYMBOL(dvb_register_device); | |
549 | ||
550 | ||
1f4ed6cd | 551 | void dvb_remove_device(struct dvb_device *dvbdev) |
1da177e4 LT |
552 | { |
553 | if (!dvbdev) | |
554 | return; | |
555 | ||
5dd3f307 AO |
556 | down_write(&minor_rwsem); |
557 | dvb_minors[dvbdev->minor] = NULL; | |
558 | up_write(&minor_rwsem); | |
559 | ||
f50d5166 | 560 | dvb_media_device_free(dvbdev); |
df2f94e5 | 561 | |
f50d5166 | 562 | device_destroy(dvb_class, MKDEV(DVB_MAJOR, dvbdev->minor)); |
a0246e02 | 563 | |
1da177e4 | 564 | list_del (&dvbdev->list_head); |
1f4ed6cd MK |
565 | } |
566 | EXPORT_SYMBOL(dvb_remove_device); | |
567 | ||
568 | ||
569 | void dvb_free_device(struct dvb_device *dvbdev) | |
570 | { | |
571 | if (!dvbdev) | |
572 | return; | |
573 | ||
b6190102 | 574 | kfree (dvbdev->fops); |
1da177e4 LT |
575 | kfree (dvbdev); |
576 | } | |
1f4ed6cd MK |
577 | EXPORT_SYMBOL(dvb_free_device); |
578 | ||
579 | ||
580 | void dvb_unregister_device(struct dvb_device *dvbdev) | |
581 | { | |
582 | dvb_remove_device(dvbdev); | |
583 | dvb_free_device(dvbdev); | |
584 | } | |
1da177e4 LT |
585 | EXPORT_SYMBOL(dvb_unregister_device); |
586 | ||
4155109a | 587 | |
4155109a | 588 | #ifdef CONFIG_MEDIA_CONTROLLER_DVB |
17813e2a MCC |
589 | |
590 | static int dvb_create_io_intf_links(struct dvb_adapter *adap, | |
591 | struct media_interface *intf, | |
592 | char *name) | |
593 | { | |
594 | struct media_device *mdev = adap->mdev; | |
595 | struct media_entity *entity; | |
596 | struct media_link *link; | |
597 | ||
598 | media_device_for_each_entity(entity, mdev) { | |
599 | if (entity->function == MEDIA_ENT_F_IO_DTV) { | |
600 | if (strncmp(entity->name, name, strlen(name))) | |
601 | continue; | |
602 | link = media_create_intf_link(entity, intf, | |
603 | MEDIA_LNK_FL_ENABLED); | |
604 | if (!link) | |
605 | return -ENOMEM; | |
606 | } | |
607 | } | |
608 | return 0; | |
609 | } | |
610 | ||
0230d60e MCC |
611 | int dvb_create_media_graph(struct dvb_adapter *adap, |
612 | bool create_rf_connector) | |
480884b6 MCC |
613 | { |
614 | struct media_device *mdev = adap->mdev; | |
0230d60e | 615 | struct media_entity *entity, *tuner = NULL, *demod = NULL, *conn; |
df2f94e5 | 616 | struct media_entity *demux = NULL, *ca = NULL; |
f50d5166 | 617 | struct media_link *link; |
8ddb90d2 | 618 | struct media_interface *intf; |
df2f94e5 MCC |
619 | unsigned demux_pad = 0; |
620 | unsigned dvr_pad = 0; | |
a0cce2a0 | 621 | unsigned ntuner = 0, ndemod = 0; |
f50d5166 | 622 | int ret; |
0230d60e | 623 | static const char *connector_name = "Television"; |
4155109a MCC |
624 | |
625 | if (!mdev) | |
f50d5166 | 626 | return 0; |
4155109a MCC |
627 | |
628 | media_device_for_each_entity(entity, mdev) { | |
0e576b76 | 629 | switch (entity->function) { |
4ca72efa | 630 | case MEDIA_ENT_F_TUNER: |
4155109a | 631 | tuner = entity; |
a0cce2a0 | 632 | ntuner++; |
4155109a | 633 | break; |
4ca72efa | 634 | case MEDIA_ENT_F_DTV_DEMOD: |
32fdc0e1 | 635 | demod = entity; |
a0cce2a0 | 636 | ndemod++; |
4155109a | 637 | break; |
4ca72efa | 638 | case MEDIA_ENT_F_TS_DEMUX: |
4155109a MCC |
639 | demux = entity; |
640 | break; | |
4ca72efa | 641 | case MEDIA_ENT_F_DTV_CA: |
4155109a MCC |
642 | ca = entity; |
643 | break; | |
644 | } | |
645 | } | |
646 | ||
a0cce2a0 MCC |
647 | /* |
648 | * Prepare to signalize to media_create_pad_links() that multiple | |
649 | * entities of the same type exists and a 1:n or n:1 links need to be | |
650 | * created. | |
651 | * NOTE: if both tuner and demod have multiple instances, it is up | |
652 | * to the caller driver to create such links. | |
653 | */ | |
654 | if (ntuner > 1) | |
655 | tuner = NULL; | |
656 | if (ndemod > 1) | |
657 | demod = NULL; | |
658 | ||
0230d60e MCC |
659 | if (create_rf_connector) { |
660 | conn = kzalloc(sizeof(*conn), GFP_KERNEL); | |
661 | if (!conn) | |
662 | return -ENOMEM; | |
663 | adap->conn = conn; | |
664 | ||
5c3fbc5e | 665 | adap->conn_pads = kzalloc(sizeof(*adap->conn_pads), GFP_KERNEL); |
0230d60e MCC |
666 | if (!adap->conn_pads) |
667 | return -ENOMEM; | |
668 | ||
669 | conn->flags = MEDIA_ENT_FL_CONNECTOR; | |
670 | conn->function = MEDIA_ENT_F_CONN_RF; | |
671 | conn->name = connector_name; | |
672 | adap->conn_pads->flags = MEDIA_PAD_FL_SOURCE; | |
673 | ||
674 | ret = media_entity_pads_init(conn, 1, adap->conn_pads); | |
675 | if (ret) | |
676 | return ret; | |
677 | ||
678 | ret = media_device_register_entity(mdev, conn); | |
679 | if (ret) | |
680 | return ret; | |
681 | ||
a0cce2a0 MCC |
682 | if (!ntuner) |
683 | ret = media_create_pad_links(mdev, | |
684 | MEDIA_ENT_F_CONN_RF, | |
685 | conn, 0, | |
686 | MEDIA_ENT_F_DTV_DEMOD, | |
687 | demod, 0, | |
688 | MEDIA_LNK_FL_ENABLED, | |
689 | false); | |
0230d60e | 690 | else |
a0cce2a0 MCC |
691 | ret = media_create_pad_links(mdev, |
692 | MEDIA_ENT_F_CONN_RF, | |
693 | conn, 0, | |
694 | MEDIA_ENT_F_TUNER, | |
695 | tuner, TUNER_PAD_RF_INPUT, | |
696 | MEDIA_LNK_FL_ENABLED, | |
697 | false); | |
0230d60e MCC |
698 | if (ret) |
699 | return ret; | |
700 | } | |
701 | ||
a0cce2a0 MCC |
702 | if (ntuner && ndemod) { |
703 | ret = media_create_pad_links(mdev, | |
704 | MEDIA_ENT_F_TUNER, | |
163c9bca | 705 | tuner, TUNER_PAD_OUTPUT, |
a0cce2a0 MCC |
706 | MEDIA_ENT_F_DTV_DEMOD, |
707 | demod, 0, MEDIA_LNK_FL_ENABLED, | |
708 | false); | |
f50d5166 MCC |
709 | if (ret) |
710 | return ret; | |
711 | } | |
4155109a | 712 | |
a0cce2a0 MCC |
713 | if (ndemod && demux) { |
714 | ret = media_create_pad_links(mdev, | |
715 | MEDIA_ENT_F_DTV_DEMOD, | |
716 | demod, 1, | |
717 | MEDIA_ENT_F_TS_DEMUX, | |
718 | demux, 0, MEDIA_LNK_FL_ENABLED, | |
719 | false); | |
f50d5166 | 720 | if (ret) |
acc37e8f | 721 | return ret; |
f50d5166 MCC |
722 | } |
723 | if (demux && ca) { | |
724 | ret = media_create_pad_link(demux, 1, ca, | |
725 | 0, MEDIA_LNK_FL_ENABLED); | |
711f3fba | 726 | if (ret) |
acc37e8f | 727 | return ret; |
f50d5166 | 728 | } |
8ddb90d2 | 729 | |
df2f94e5 MCC |
730 | /* Create demux links for each ringbuffer/pad */ |
731 | if (demux) { | |
732 | media_device_for_each_entity(entity, mdev) { | |
4ca72efa | 733 | if (entity->function == MEDIA_ENT_F_IO_DTV) { |
df2f94e5 | 734 | if (!strncmp(entity->name, DVR_TSOUT, |
f50d5166 MCC |
735 | strlen(DVR_TSOUT))) { |
736 | ret = media_create_pad_link(demux, | |
737 | ++dvr_pad, | |
738 | entity, 0, 0); | |
739 | if (ret) | |
740 | return ret; | |
741 | } | |
df2f94e5 | 742 | if (!strncmp(entity->name, DEMUX_TSOUT, |
f50d5166 MCC |
743 | strlen(DEMUX_TSOUT))) { |
744 | ret = media_create_pad_link(demux, | |
df2f94e5 | 745 | ++demux_pad, |
f50d5166 MCC |
746 | entity, 0, 0); |
747 | if (ret) | |
748 | return ret; | |
749 | } | |
df2f94e5 MCC |
750 | } |
751 | } | |
752 | } | |
753 | ||
8ed07142 | 754 | /* Create interface links for FE->tuner, DVR->demux and CA->ca */ |
cf975a4b | 755 | media_device_for_each_intf(intf, mdev) { |
f50d5166 MCC |
756 | if (intf->type == MEDIA_INTF_T_DVB_CA && ca) { |
757 | link = media_create_intf_link(ca, intf, | |
758 | MEDIA_LNK_FL_ENABLED); | |
759 | if (!link) | |
760 | return -ENOMEM; | |
761 | } | |
cf975a4b | 762 | |
f50d5166 MCC |
763 | if (intf->type == MEDIA_INTF_T_DVB_FE && tuner) { |
764 | link = media_create_intf_link(tuner, intf, | |
765 | MEDIA_LNK_FL_ENABLED); | |
766 | if (!link) | |
767 | return -ENOMEM; | |
768 | } | |
8ed07142 MCC |
769 | #if 0 |
770 | /* | |
771 | * Indirect link - let's not create yet, as we don't know how | |
772 | * to handle indirect links, nor if this will | |
773 | * actually be needed. | |
774 | */ | |
f50d5166 MCC |
775 | if (intf->type == MEDIA_INTF_T_DVB_DVR && demux) { |
776 | link = media_create_intf_link(demux, intf, | |
777 | MEDIA_LNK_FL_ENABLED); | |
778 | if (!link) | |
779 | return -ENOMEM; | |
780 | } | |
8ed07142 | 781 | #endif |
17813e2a MCC |
782 | if (intf->type == MEDIA_INTF_T_DVB_DVR) { |
783 | ret = dvb_create_io_intf_links(adap, intf, DVR_TSOUT); | |
784 | if (ret) | |
785 | return ret; | |
786 | } | |
787 | if (intf->type == MEDIA_INTF_T_DVB_DEMUX) { | |
788 | ret = dvb_create_io_intf_links(adap, intf, DEMUX_TSOUT); | |
789 | if (ret) | |
790 | return ret; | |
df2f94e5 | 791 | } |
8ddb90d2 | 792 | } |
f50d5166 | 793 | return 0; |
4155109a MCC |
794 | } |
795 | EXPORT_SYMBOL_GPL(dvb_create_media_graph); | |
480884b6 | 796 | #endif |
4155109a | 797 | |
78e92006 JG |
798 | static int dvbdev_check_free_adapter_num(int num) |
799 | { | |
800 | struct list_head *entry; | |
801 | list_for_each(entry, &dvb_adapter_list) { | |
802 | struct dvb_adapter *adap; | |
803 | adap = list_entry(entry, struct dvb_adapter, list_head); | |
804 | if (adap->num == num) | |
805 | return 0; | |
806 | } | |
807 | return 1; | |
808 | } | |
1da177e4 LT |
809 | |
810 | static int dvbdev_get_free_adapter_num (void) | |
811 | { | |
812 | int num = 0; | |
813 | ||
814 | while (num < DVB_MAX_ADAPTERS) { | |
78e92006 JG |
815 | if (dvbdev_check_free_adapter_num(num)) |
816 | return num; | |
1da177e4 LT |
817 | num++; |
818 | } | |
819 | ||
820 | return -ENFILE; | |
821 | } | |
822 | ||
823 | ||
78e92006 JG |
824 | int dvb_register_adapter(struct dvb_adapter *adap, const char *name, |
825 | struct module *module, struct device *device, | |
826 | short *adapter_nums) | |
1da177e4 | 827 | { |
78e92006 | 828 | int i, num; |
1da177e4 | 829 | |
c2788502 | 830 | mutex_lock(&dvbdev_register_lock); |
1da177e4 | 831 | |
78e92006 JG |
832 | for (i = 0; i < DVB_MAX_ADAPTERS; ++i) { |
833 | num = adapter_nums[i]; | |
834 | if (num >= 0 && num < DVB_MAX_ADAPTERS) { | |
835 | /* use the one the driver asked for */ | |
836 | if (dvbdev_check_free_adapter_num(num)) | |
837 | break; | |
838 | } else { | |
839 | num = dvbdev_get_free_adapter_num(); | |
840 | break; | |
841 | } | |
842 | num = -1; | |
843 | } | |
844 | ||
845 | if (num < 0) { | |
1e4baed3 | 846 | mutex_unlock(&dvbdev_register_lock); |
1da177e4 LT |
847 | return -ENFILE; |
848 | } | |
849 | ||
1da177e4 LT |
850 | memset (adap, 0, sizeof(struct dvb_adapter)); |
851 | INIT_LIST_HEAD (&adap->device_list); | |
852 | ||
b3ad24d2 | 853 | pr_info("DVB: registering new adapter (%s)\n", name); |
1da177e4 | 854 | |
1da177e4 LT |
855 | adap->num = num; |
856 | adap->name = name; | |
857 | adap->module = module; | |
d09dbf92 | 858 | adap->device = device; |
59b1842d DB |
859 | adap->mfe_shared = 0; |
860 | adap->mfe_dvbdev = NULL; | |
861 | mutex_init (&adap->mfe_lock); | |
1da177e4 LT |
862 | |
863 | list_add_tail (&adap->list_head, &dvb_adapter_list); | |
864 | ||
1e4baed3 | 865 | mutex_unlock(&dvbdev_register_lock); |
1da177e4 LT |
866 | |
867 | return num; | |
868 | } | |
869 | EXPORT_SYMBOL(dvb_register_adapter); | |
870 | ||
871 | ||
872 | int dvb_unregister_adapter(struct dvb_adapter *adap) | |
873 | { | |
c2788502 | 874 | mutex_lock(&dvbdev_register_lock); |
1da177e4 | 875 | list_del (&adap->list_head); |
1e4baed3 | 876 | mutex_unlock(&dvbdev_register_lock); |
1da177e4 LT |
877 | return 0; |
878 | } | |
879 | EXPORT_SYMBOL(dvb_unregister_adapter); | |
880 | ||
881 | /* if the miracle happens and "generic_usercopy()" is included into | |
882 | the kernel, then this can vanish. please don't make the mistake and | |
883 | define this as video_usercopy(). this will introduce a dependecy | |
884 | to the v4l "videodev.o" module, which is unnecessary for some | |
885 | cards (ie. the budget dvb-cards don't need the v4l module...) */ | |
16ef8def | 886 | int dvb_usercopy(struct file *file, |
afd1a0c9 | 887 | unsigned int cmd, unsigned long arg, |
16ef8def | 888 | int (*func)(struct file *file, |
1da177e4 LT |
889 | unsigned int cmd, void *arg)) |
890 | { | |
afd1a0c9 MCC |
891 | char sbuf[128]; |
892 | void *mbuf = NULL; | |
893 | void *parg = NULL; | |
894 | int err = -EINVAL; | |
895 | ||
896 | /* Copy arguments into temp kernel buffer */ | |
897 | switch (_IOC_DIR(cmd)) { | |
898 | case _IOC_NONE: | |
1da177e4 LT |
899 | /* |
900 | * For this command, the pointer is actually an integer | |
901 | * argument. | |
902 | */ | |
903 | parg = (void *) arg; | |
904 | break; | |
afd1a0c9 MCC |
905 | case _IOC_READ: /* some v4l ioctls are marked wrong ... */ |
906 | case _IOC_WRITE: | |
907 | case (_IOC_WRITE | _IOC_READ): | |
908 | if (_IOC_SIZE(cmd) <= sizeof(sbuf)) { | |
50c25fff | 909 | parg = sbuf; |
afd1a0c9 | 910 | } else { |
50c25fff | 911 | /* too big to allocate from stack */ |
0ede1876 | 912 | mbuf = kmalloc(_IOC_SIZE(cmd), GFP_KERNEL); |
50c25fff MK |
913 | if (NULL == mbuf) |
914 | return -ENOMEM; | |
915 | parg = mbuf; | |
afd1a0c9 MCC |
916 | } |
917 | ||
918 | err = -EFAULT; | |
919 | if (copy_from_user(parg, (void __user *)arg, _IOC_SIZE(cmd))) | |
50c25fff | 920 | goto out; |
afd1a0c9 MCC |
921 | break; |
922 | } | |
923 | ||
924 | /* call driver */ | |
16ef8def | 925 | if ((err = func(file, cmd, parg)) == -ENOIOCTLCMD) |
d9751fd0 | 926 | err = -ENOTTY; |
afd1a0c9 MCC |
927 | |
928 | if (err < 0) | |
929 | goto out; | |
930 | ||
931 | /* Copy results into user buffer */ | |
932 | switch (_IOC_DIR(cmd)) | |
933 | { | |
934 | case _IOC_READ: | |
935 | case (_IOC_WRITE | _IOC_READ): | |
936 | if (copy_to_user((void __user *)arg, parg, _IOC_SIZE(cmd))) | |
50c25fff | 937 | err = -EFAULT; |
afd1a0c9 MCC |
938 | break; |
939 | } | |
1da177e4 LT |
940 | |
941 | out: | |
afd1a0c9 MCC |
942 | kfree(mbuf); |
943 | return err; | |
1da177e4 LT |
944 | } |
945 | ||
a5f4c0ce KS |
946 | static int dvb_uevent(struct device *dev, struct kobj_uevent_env *env) |
947 | { | |
948 | struct dvb_device *dvbdev = dev_get_drvdata(dev); | |
949 | ||
a5f4c0ce | 950 | add_uevent_var(env, "DVB_ADAPTER_NUM=%d", dvbdev->adapter->num); |
763d19bb KS |
951 | add_uevent_var(env, "DVB_DEVICE_TYPE=%s", dnames[dvbdev->type]); |
952 | add_uevent_var(env, "DVB_DEVICE_NUM=%d", dvbdev->id); | |
a5f4c0ce KS |
953 | return 0; |
954 | } | |
955 | ||
2c9ede55 | 956 | static char *dvb_devnode(struct device *dev, umode_t *mode) |
8a8bdcc7 KS |
957 | { |
958 | struct dvb_device *dvbdev = dev_get_drvdata(dev); | |
959 | ||
960 | return kasprintf(GFP_KERNEL, "dvb/adapter%d/%s%d", | |
961 | dvbdev->adapter->num, dnames[dvbdev->type], dvbdev->id); | |
962 | } | |
963 | ||
964 | ||
1da177e4 LT |
965 | static int __init init_dvbdev(void) |
966 | { | |
967 | int retval; | |
968 | dev_t dev = MKDEV(DVB_MAJOR, 0); | |
969 | ||
970 | if ((retval = register_chrdev_region(dev, MAX_DVB_MINORS, "DVB")) != 0) { | |
b3ad24d2 | 971 | pr_err("dvb-core: unable to get major %d\n", DVB_MAJOR); |
1da177e4 LT |
972 | return retval; |
973 | } | |
974 | ||
975 | cdev_init(&dvb_device_cdev, &dvb_device_fops); | |
976 | if ((retval = cdev_add(&dvb_device_cdev, dev, MAX_DVB_MINORS)) != 0) { | |
b3ad24d2 | 977 | pr_err("dvb-core: unable register character device\n"); |
1da177e4 LT |
978 | goto error; |
979 | } | |
980 | ||
56b22935 | 981 | dvb_class = class_create(THIS_MODULE, "dvb"); |
1da177e4 LT |
982 | if (IS_ERR(dvb_class)) { |
983 | retval = PTR_ERR(dvb_class); | |
984 | goto error; | |
985 | } | |
a5f4c0ce | 986 | dvb_class->dev_uevent = dvb_uevent; |
e454cea2 | 987 | dvb_class->devnode = dvb_devnode; |
1da177e4 LT |
988 | return 0; |
989 | ||
990 | error: | |
991 | cdev_del(&dvb_device_cdev); | |
992 | unregister_chrdev_region(dev, MAX_DVB_MINORS); | |
993 | return retval; | |
994 | } | |
995 | ||
996 | ||
997 | static void __exit exit_dvbdev(void) | |
998 | { | |
56b22935 | 999 | class_destroy(dvb_class); |
1da177e4 | 1000 | cdev_del(&dvb_device_cdev); |
afd1a0c9 | 1001 | unregister_chrdev_region(MKDEV(DVB_MAJOR, 0), MAX_DVB_MINORS); |
1da177e4 LT |
1002 | } |
1003 | ||
4abdcf93 | 1004 | subsys_initcall(init_dvbdev); |
1da177e4 LT |
1005 | module_exit(exit_dvbdev); |
1006 | ||
1007 | MODULE_DESCRIPTION("DVB Core Driver"); | |
1008 | MODULE_AUTHOR("Marcus Metzler, Ralph Metzler, Holger Waechtler"); | |
1009 | MODULE_LICENSE("GPL"); |