Merge branch 'for-linus' of git://oss.sgi.com:8090/xfs/xfs-2.6
[linux-2.6] / drivers / media / video / videocodec.c
1 /*
2  * VIDEO MOTION CODECs internal API for video devices
3  *
4  * Interface for MJPEG (and maybe later MPEG/WAVELETS) codec's
5  * bound to a master device.
6  *
7  * (c) 2002 Wolfgang Scherr <scherr@net4you.at>
8  *
9  * $Id: videocodec.c,v 1.1.2.8 2003/03/29 07:16:04 rbultje Exp $
10  *
11  * ------------------------------------------------------------------------
12  *
13  * This program is free software; you can redistribute it and/or modify
14  * it under the terms of the GNU General Public License as published by
15  * the Free Software Foundation; either version 2 of the License, or
16  * (at your option) any later version.
17  *
18  * This program is distributed in the hope that it will be useful,
19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
21  * GNU General Public License for more details.
22  *
23  * You should have received a copy of the GNU General Public License
24  * along with this program; if not, write to the Free Software
25  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26  *
27  * ------------------------------------------------------------------------
28  */
29
30 #define VIDEOCODEC_VERSION "v0.2"
31
32 #include <linux/kernel.h>
33 #include <linux/module.h>
34 #include <linux/init.h>
35 #include <linux/types.h>
36 #include <linux/slab.h>
37
38 // kernel config is here (procfs flag)
39
40 #ifdef CONFIG_PROC_FS
41 #include <linux/proc_fs.h>
42 #include <linux/seq_file.h>
43 #include <asm/uaccess.h>
44 #endif
45
46 #include "videocodec.h"
47
48 static int debug;
49 module_param(debug, int, 0);
50 MODULE_PARM_DESC(debug, "Debug level (0-4)");
51
52 #define dprintk(num, format, args...) \
53         do { \
54                 if (debug >= num) \
55                         printk(format, ##args); \
56         } while (0)
57
58 struct attached_list {
59         struct videocodec *codec;
60         struct attached_list *next;
61 };
62
63 struct codec_list {
64         const struct videocodec *codec;
65         int attached;
66         struct attached_list *list;
67         struct codec_list *next;
68 };
69
70 static struct codec_list *codeclist_top = NULL;
71
72 /* ================================================= */
73 /* function prototypes of the master/slave interface */
74 /* ================================================= */
75
76 struct videocodec *
77 videocodec_attach (struct videocodec_master *master)
78 {
79         struct codec_list *h = codeclist_top;
80         struct attached_list *a, *ptr;
81         struct videocodec *codec;
82         int res;
83
84         if (!master) {
85                 dprintk(1, KERN_ERR "videocodec_attach: no data\n");
86                 return NULL;
87         }
88
89         dprintk(2,
90                 "videocodec_attach: '%s', flags %lx, magic %lx\n",
91                 master->name, master->flags, master->magic);
92
93         if (!h) {
94                 dprintk(1,
95                         KERN_ERR
96                         "videocodec_attach: no device available\n");
97                 return NULL;
98         }
99
100         while (h) {
101                 // attach only if the slave has at least the flags
102                 // expected by the master
103                 if ((master->flags & h->codec->flags) == master->flags) {
104                         dprintk(4, "videocodec_attach: try '%s'\n",
105                                 h->codec->name);
106
107                         if (!try_module_get(h->codec->owner))
108                                 return NULL;
109
110                         codec =
111                             kmalloc(sizeof(struct videocodec), GFP_KERNEL);
112                         if (!codec) {
113                                 dprintk(1,
114                                         KERN_ERR
115                                         "videocodec_attach: no mem\n");
116                                 goto out_module_put;
117                         }
118                         memcpy(codec, h->codec, sizeof(struct videocodec));
119
120                         snprintf(codec->name, sizeof(codec->name),
121                                  "%s[%d]", codec->name, h->attached);
122                         codec->master_data = master;
123                         res = codec->setup(codec);
124                         if (res == 0) {
125                                 dprintk(3, "videocodec_attach '%s'\n",
126                                         codec->name);
127                                 ptr = kzalloc(sizeof(struct attached_list), GFP_KERNEL);
128                                 if (!ptr) {
129                                         dprintk(1,
130                                                 KERN_ERR
131                                                 "videocodec_attach: no memory\n");
132                                         goto out_kfree;
133                                 }
134                                 ptr->codec = codec;
135
136                                 a = h->list;
137                                 if (!a) {
138                                         h->list = ptr;
139                                         dprintk(4,
140                                                 "videocodec: first element\n");
141                                 } else {
142                                         while (a->next)
143                                                 a = a->next;    // find end
144                                         a->next = ptr;
145                                         dprintk(4,
146                                                 "videocodec: in after '%s'\n",
147                                                 h->codec->name);
148                                 }
149
150                                 h->attached += 1;
151                                 return codec;
152                         } else {
153                                 kfree(codec);
154                         }
155                 }
156                 h = h->next;
157         }
158
159         dprintk(1, KERN_ERR "videocodec_attach: no codec found!\n");
160         return NULL;
161
162  out_module_put:
163         module_put(h->codec->owner);
164  out_kfree:
165         kfree(codec);
166         return NULL;
167 }
168
169 int
170 videocodec_detach (struct videocodec *codec)
171 {
172         struct codec_list *h = codeclist_top;
173         struct attached_list *a, *prev;
174         int res;
175
176         if (!codec) {
177                 dprintk(1, KERN_ERR "videocodec_detach: no data\n");
178                 return -EINVAL;
179         }
180
181         dprintk(2,
182                 "videocodec_detach: '%s', type: %x, flags %lx, magic %lx\n",
183                 codec->name, codec->type, codec->flags, codec->magic);
184
185         if (!h) {
186                 dprintk(1,
187                         KERN_ERR "videocodec_detach: no device left...\n");
188                 return -ENXIO;
189         }
190
191         while (h) {
192                 a = h->list;
193                 prev = NULL;
194                 while (a) {
195                         if (codec == a->codec) {
196                                 res = a->codec->unset(a->codec);
197                                 if (res >= 0) {
198                                         dprintk(3,
199                                                 "videocodec_detach: '%s'\n",
200                                                 a->codec->name);
201                                         a->codec->master_data = NULL;
202                                 } else {
203                                         dprintk(1,
204                                                 KERN_ERR
205                                                 "videocodec_detach: '%s'\n",
206                                                 a->codec->name);
207                                         a->codec->master_data = NULL;
208                                 }
209                                 if (prev == NULL) {
210                                         h->list = a->next;
211                                         dprintk(4,
212                                                 "videocodec: delete first\n");
213                                 } else {
214                                         prev->next = a->next;
215                                         dprintk(4,
216                                                 "videocodec: delete middle\n");
217                                 }
218                                 module_put(a->codec->owner);
219                                 kfree(a->codec);
220                                 kfree(a);
221                                 h->attached -= 1;
222                                 return 0;
223                         }
224                         prev = a;
225                         a = a->next;
226                 }
227                 h = h->next;
228         }
229
230         dprintk(1, KERN_ERR "videocodec_detach: given codec not found!\n");
231         return -EINVAL;
232 }
233
234 int
235 videocodec_register (const struct videocodec *codec)
236 {
237         struct codec_list *ptr, *h = codeclist_top;
238
239         if (!codec) {
240                 dprintk(1, KERN_ERR "videocodec_register: no data!\n");
241                 return -EINVAL;
242         }
243
244         dprintk(2,
245                 "videocodec: register '%s', type: %x, flags %lx, magic %lx\n",
246                 codec->name, codec->type, codec->flags, codec->magic);
247
248         ptr = kzalloc(sizeof(struct codec_list), GFP_KERNEL);
249         if (!ptr) {
250                 dprintk(1, KERN_ERR "videocodec_register: no memory\n");
251                 return -ENOMEM;
252         }
253         ptr->codec = codec;
254
255         if (!h) {
256                 codeclist_top = ptr;
257                 dprintk(4, "videocodec: hooked in as first element\n");
258         } else {
259                 while (h->next)
260                         h = h->next;    // find the end
261                 h->next = ptr;
262                 dprintk(4, "videocodec: hooked in after '%s'\n",
263                         h->codec->name);
264         }
265
266         return 0;
267 }
268
269 int
270 videocodec_unregister (const struct videocodec *codec)
271 {
272         struct codec_list *prev = NULL, *h = codeclist_top;
273
274         if (!codec) {
275                 dprintk(1, KERN_ERR "videocodec_unregister: no data!\n");
276                 return -EINVAL;
277         }
278
279         dprintk(2,
280                 "videocodec: unregister '%s', type: %x, flags %lx, magic %lx\n",
281                 codec->name, codec->type, codec->flags, codec->magic);
282
283         if (!h) {
284                 dprintk(1,
285                         KERN_ERR
286                         "videocodec_unregister: no device left...\n");
287                 return -ENXIO;
288         }
289
290         while (h) {
291                 if (codec == h->codec) {
292                         if (h->attached) {
293                                 dprintk(1,
294                                         KERN_ERR
295                                         "videocodec: '%s' is used\n",
296                                         h->codec->name);
297                                 return -EBUSY;
298                         }
299                         dprintk(3, "videocodec: unregister '%s' is ok.\n",
300                                 h->codec->name);
301                         if (prev == NULL) {
302                                 codeclist_top = h->next;
303                                 dprintk(4,
304                                         "videocodec: delete first element\n");
305                         } else {
306                                 prev->next = h->next;
307                                 dprintk(4,
308                                         "videocodec: delete middle element\n");
309                         }
310                         kfree(h);
311                         return 0;
312                 }
313                 prev = h;
314                 h = h->next;
315         }
316
317         dprintk(1,
318                 KERN_ERR
319                 "videocodec_unregister: given codec not found!\n");
320         return -EINVAL;
321 }
322
323 #ifdef CONFIG_PROC_FS
324 static int proc_videocodecs_show(struct seq_file *m, void *v)
325 {
326         struct codec_list *h = codeclist_top;
327         struct attached_list *a;
328
329         seq_printf(m, "<S>lave or attached <M>aster name  type flags    magic    ");
330         seq_printf(m, "(connected as)\n");
331
332         h = codeclist_top;
333         while (h) {
334                 seq_printf(m, "S %32s %04x %08lx %08lx (TEMPLATE)\n",
335                               h->codec->name, h->codec->type,
336                               h->codec->flags, h->codec->magic);
337                 a = h->list;
338                 while (a) {
339                         seq_printf(m, "M %32s %04x %08lx %08lx (%s)\n",
340                                       a->codec->master_data->name,
341                                       a->codec->master_data->type,
342                                       a->codec->master_data->flags,
343                                       a->codec->master_data->magic,
344                                       a->codec->name);
345                         a = a->next;
346                 }
347                 h = h->next;
348         }
349
350         return 0;
351 }
352
353 static int proc_videocodecs_open(struct inode *inode, struct file *file)
354 {
355         return single_open(file, proc_videocodecs_show, NULL);
356 }
357
358 static const struct file_operations videocodecs_proc_fops = {
359         .owner          = THIS_MODULE,
360         .open           = proc_videocodecs_open,
361         .read           = seq_read,
362         .llseek         = seq_lseek,
363         .release        = single_release,
364 };
365 #endif
366
367 /* ===================== */
368 /* hook in driver module */
369 /* ===================== */
370 static int __init
371 videocodec_init (void)
372 {
373 #ifdef CONFIG_PROC_FS
374         static struct proc_dir_entry *videocodec_proc_entry;
375 #endif
376
377         printk(KERN_INFO "Linux video codec intermediate layer: %s\n",
378                VIDEOCODEC_VERSION);
379
380 #ifdef CONFIG_PROC_FS
381         videocodec_proc_entry = proc_create("videocodecs", 0, NULL, &videocodecs_proc_fops);
382         if (!videocodec_proc_entry) {
383                 dprintk(1, KERN_ERR "videocodec: can't init procfs.\n");
384         }
385 #endif
386         return 0;
387 }
388
389 static void __exit
390 videocodec_exit (void)
391 {
392 #ifdef CONFIG_PROC_FS
393         remove_proc_entry("videocodecs", NULL);
394 #endif
395 }
396
397 EXPORT_SYMBOL(videocodec_attach);
398 EXPORT_SYMBOL(videocodec_detach);
399 EXPORT_SYMBOL(videocodec_register);
400 EXPORT_SYMBOL(videocodec_unregister);
401
402 module_init(videocodec_init);
403 module_exit(videocodec_exit);
404
405 MODULE_AUTHOR("Wolfgang Scherr <scherr@net4you.at>");
406 MODULE_DESCRIPTION("Intermediate API module for video codecs "
407                    VIDEOCODEC_VERSION);
408 MODULE_LICENSE("GPL");