libexplain  1.4.D001
libexplain/iocontrol/vidioc_streamon.c
Go to the documentation of this file.
00001 /*
00002  * libexplain - a library of system-call-specific strerror replacements
00003  * Copyright (C) 2011, 2013 Peter Miller
00004  * Written by Peter Miller <pmiller@opensource.org.au>
00005  *
00006  * This program is free software; you can redistribute it and/or modify it
00007  * under the terms of the GNU Lesser General Public License as published by
00008  * the Free Software Foundation; either version 3 of the License, or (at your
00009  * option) any later version.
00010  *
00011  * This program is distributed in the hope that it will be useful, but WITHOUT
00012  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
00013  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
00014  * License for more details.
00015  *
00016  * You should have received a copy of the GNU Lesser General Public License
00017  * along with this program. If not, see <http://www.gnu.org/licenses/>.
00018  */
00019 
00020 #include <libexplain/ac/errno.h>
00021 #include <libexplain/ac/linux/videodev2.h>
00022 #include <libexplain/ac/sys/ioctl.h>
00023 
00024 #include <libexplain/buffer/einval.h>
00025 #include <libexplain/buffer/enotsup.h>
00026 #include <libexplain/buffer/is_the_null_pointer.h>
00027 #include <libexplain/buffer/v4l2_buf_type.h>
00028 #include <libexplain/iocontrol/generic.h>
00029 #include <libexplain/iocontrol/vidioc_streamon.h>
00030 
00031 #ifdef VIDIOC_STREAMON
00032 
00033 
00034 static void
00035 print_data(const explain_iocontrol_t *p, explain_string_buffer_t *sb,
00036     int errnum, int fildes, int request, const void *data)
00037 {
00038     (void)p;
00039     (void)errnum;
00040     (void)fildes;
00041     (void)request;
00042     explain_buffer_v4l2_buf_type_ptr(sb, data);
00043 }
00044 
00045 
00046 static void
00047 print_explanation(const explain_iocontrol_t *p, explain_string_buffer_t *sb,
00048     int errnum, int fildes, int request, const void *data)
00049 {
00050     switch (errnum)
00051     {
00052     case EINVAL:
00053         if (!data)
00054         {
00055             explain_buffer_is_the_null_pointer(sb, "data");
00056             return;
00057         }
00058 
00059         switch (explain_v4l2_buf_type_ptr_check(fildes, data))
00060         {
00061         case explain_v4l2_buf_type_check_no_idea:
00062         default:
00063             /* best guess */
00064             explain_buffer_einval_vague(sb, "*data");
00065             return;
00066 
00067         case explain_v4l2_buf_type_check_ok:
00068             /* the control id is supported, something else is wrong */
00069             goto generic;
00070 
00071         case explain_v4l2_buf_type_check_notsup:
00072             explain_buffer_enotsup_device(sb, "*data");
00073             return;
00074 
00075         case explain_v4l2_buf_type_check_nosuch:
00076             explain_buffer_einval_vague(sb, "*data");
00077             return;
00078         }
00079         break;
00080 
00081     default:
00082         generic:
00083         explain_iocontrol_generic_print_explanation
00084         (
00085             p,
00086             sb,
00087             errnum,
00088             fildes,
00089             request,
00090             data
00091         );
00092         break;
00093     }
00094 }
00095 
00096 
00097 const explain_iocontrol_t explain_iocontrol_vidioc_streamon =
00098 {
00099     "VIDIOC_STREAMON", /* name */
00100     VIDIOC_STREAMON, /* value */
00101     0, /* disambiguate */
00102     0, /* print_name */
00103     print_data,
00104     print_explanation,
00105     0, /* print_data_returned */
00106     sizeof(int), /* data_size */
00107     "int *", /* data_type */
00108     0, /* flags */
00109     __FILE__,
00110     __LINE__,
00111 };
00112 
00113 #else /* ndef VIDIOC_STREAMON */
00114 
00115 const explain_iocontrol_t explain_iocontrol_vidioc_streamon =
00116 {
00117     0, /* name */
00118     0, /* value */
00119     0, /* disambiguate */
00120     0, /* print_name */
00121     0, /* print_data */
00122     0, /* print_explanation */
00123     0, /* print_data_returned */
00124     0, /* data_size */
00125     0, /* data_type */
00126     0, /* flags */
00127     __FILE__,
00128     __LINE__,
00129 };
00130 
00131 #endif /* VIDIOC_STREAMON */
00132 
00133 /* vim: set ts=8 sw=4 et : */