svn commit: r202364 - head/sys/compat/linux

[Alexander Leidinger]

Quoting Alexander Leidinger <netchild at FreeBSD.org> (from Fri, 15 Jan  
2010 14:58:20 +0000 (UTC)):

> Author: netchild
> Date: Fri Jan 15 14:58:19 2010
> New Revision: 202364
> URL: http://svn.freebsd.org/changeset/base/202364
>
> Log:
>   This is v4l support for the linuxulator. This allows to access FreeBSD

Ugh, this is the wrong commit log... here is the right one:
---snip---
Add video clipping support but with the caveats below.

Background info:

Video clipping allows the user to provide either a series of clip rectangles
or a clip bitmap to the driver and have the driver mask the video according
to the clipping specs provided.

Adding support for clipping to the FreeBSD Linux emulator is problematic
because it seems that this feature is not supported by many drivers and
therefore it is ignored by many applications. Unfortunately, when not
using it, rather than passing in a null clipping list, some apps leave the
clipping fields uninitialized, casuing random values to be passed in. In
the case where the driver does not use the clipping info, this is not a
problem (although it is bad form). But the Linux emulator does not know
which drivers will use this and which won't, so the Linux emulator must
try to handle this clip list, and deal gracefully with cases where the
values seem to be uninitialized.

Video clipping info is passed in using the VIDIOCSWIN ioctl in two fields
in the video_window structure: the integer clipcount and the pointer clips.

How the linuxulator handles this from this commit on:

     * if (clipcount == VIDEO_CLIP_BITMAP)
       The clips variable is a void * pointer to a 128*625 byte
       (1024*625 bit) memory area containing a bitmap of the clipping area.
       The pointer in the video_window structure is copied, but no
       video_clip structures are copied.
     * if (clipcount > 0 && clipcount <= 16384)
       The clips variable is pointer to a list of video_clip structures. Up
       to clipcount structures are copied and passed to the driver.
       The upper limit of 16384 was imposed here so that user code that does
       not properly initialize clipcount falls through below and no attempt
       is made to copy an uninitialized list. This value was found by
       examining Linux drivers that support the clip list.
     * else
       The clipcount is either negative (but not VIDEO_CLIP_BITMAP), zero or
       positive (> 16384).
       All these cases are treated as invalid data. Both the clipcount field
       and clips pointer are forced to zero/NULL and passed to the driver.

It should be noted that, at the time of developing this V4L emulator code,
the pwc(4) V4L driver does not support clipping.

Submitted by:   J.R. Oldroyd <fbsd at opal.com>
---snip---

And I think I will MFC this after 1 month...

Bye,
Alexander.

-- 
Bowie's Theorem:
	If an experiment works, you must be using the wrong equipment.

http://www.Leidinger.net    Alexander @ Leidinger.net: PGP ID = B0063FE7
http://www.FreeBSD.org       netchild @ FreeBSD.org  : PGP ID = 72077137