libexplain/iocontrol/vidiocmcapture.c

Go to the documentation of this file.

/*
 * libexplain - a library of system-call-specific strerror replacements
 * Copyright (C) 2011, 2013 Peter Miller
 * Written by Peter Miller <pmiller@opensource.org.au>
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation; either version 3 of the License, or (at your
 * option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
 * License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 */

#include <libexplain/ac/errno.h>
#include <libexplain/ac/linux/videodev.h>
#include <libexplain/ac/sys/ioctl.h>

#include <libexplain/buffer/einval.h>
#include <libexplain/buffer/is_the_null_pointer.h>
#include <libexplain/buffer/video_mmap.h>
#include <libexplain/iocontrol/generic.h>
#include <libexplain/iocontrol/vidiocmcapture.h>
#include <libexplain/is_efault.h>

#ifdef VIDIOCMCAPTURE


static void
print_data(const explain_iocontrol_t *p, explain_string_buffer_t *sb,
    int errnum, int fildes, int request, const void *data)
{
    (void)p;
    (void)errnum;
    (void)fildes;
    (void)request;
    explain_buffer_video_mmap(sb, data);
}


static void
print_explanation(const explain_iocontrol_t *p, explain_string_buffer_t *sb,
    int errnum, int fildes, int request, const void *data)
{
    switch (errnum)
    {
    case EINVAL:
        if (!data)
        {
            explain_buffer_is_the_null_pointer(sb, "data");
            return;
        }

        {
            const struct video_mmap *arg;

            arg = data;
            if (!explain_is_efault_pointer(arg, sizeof(*arg)))
            {
                struct video_capability cap;

                /*
                 * Size could be wrong.
                 */
                if (ioctl(fildes, VIDIOCGCAP, &cap) >= 0)
                {
                    if (arg->width < cap.minwidth || arg->width > cap.maxwidth)
                    {
                        explain_buffer_einval_out_of_range
                        (
                            sb,
                            "data->width",
                            cap.minwidth,
                            cap.maxwidth
                        );
                        return;
                    }
                    if
                    (
                        arg->height < cap.minheight
                    ||
                        arg->height > cap.maxheight
                    )
                    {
                        explain_buffer_einval_out_of_range
                        (
                            sb,
                            "data->height",
                            cap.minheight,
                            cap.maxheight
                        );
                        return;
                    }
                }

                /* FIXME: format could be wrong */

                /*
                 * Frame number could be wrong.
                 */
                {
                    struct video_mbuf qry;

                    if
                    (
                        ioctl(fildes, VIDIOCGMBUF, &qry) >= 0
                    &&
                        qry.frames > 0
                    &&
                        (unsigned)arg->frame >= (unsigned)qry.frames
                    )
                    {
                        explain_buffer_einval_out_of_range
                        (
                            sb,
                            "data->frame",
                            0,
                            qry.frames
                        );
                        return;
                    }
                }
            }
        }

        /* No idea */
        explain_buffer_einval_vague(sb, "data");
        break;

    default:
        explain_iocontrol_generic_print_explanation
        (
            p,
            sb,
            errnum,
            fildes,
            request,
            data
        );
        break;
    }
}


const explain_iocontrol_t explain_iocontrol_vidiocmcapture =
{
    "VIDIOCMCAPTURE", /* name */
    VIDIOCMCAPTURE, /* value */
    0, /* disambiguate */
    0, /* print_name */
    print_data,
    print_explanation,
    0, /* print_data_returned */
    sizeof(struct video_mmap), /* data_size */
    "struct video_mmap *", /* data_type */
    0, /* flags */
    __FILE__,
    __LINE__,
};

#else /* ndef VIDIOCMCAPTURE */

const explain_iocontrol_t explain_iocontrol_vidiocmcapture =
{
    0, /* name */
    0, /* value */
    0, /* disambiguate */
    0, /* print_name */
    0, /* print_data */
    0, /* print_explanation */
    0, /* print_data_returned */
    0, /* data_size */
    0, /* data_type */
    0, /* flags */
    __FILE__,
    __LINE__,
};

#endif /* VIDIOCMCAPTURE */

/* vim: set ts=8 sw=4 et : */