libexplain  1.4.D001
libexplain/iocontrol/vidioc_enumoutput.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/is_the_null_pointer.h>
00026 #include <libexplain/buffer/v4l2_output.h>
00027 #include <libexplain/iocontrol/generic.h>
00028 #include <libexplain/iocontrol/vidioc_enumoutput.h>
00029 #include <libexplain/is_efault.h>
00030 
00031 #ifdef VIDIOC_ENUMOUTPUT
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_output(sb, data, 0);
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         {
00060             const struct v4l2_output *arg;
00061 
00062             arg = data;
00063             if (!explain_is_efault_pointer(arg, sizeof(*arg)))
00064             {
00065                 int             noutputs;
00066 
00067                 noutputs = explain_v4l2_output_get_noutputs(fildes);
00068                 if (noutputs == 0)
00069                 {
00070                     explain_iocontrol_generic_print_explanation
00071                     (
00072                         p,
00073                         sb,
00074                         ENOTTY,
00075                         fildes,
00076                         request,
00077                         data
00078                     );
00079                     return;
00080                 }
00081                 if (noutputs > 0 && arg->index >= (unsigned)noutputs)
00082                 {
00083                     explain_buffer_einval_out_of_range
00084                     (
00085                         sb,
00086                         "data->index",
00087                         0,
00088                         noutputs - 1
00089                     );
00090                     return;
00091                 }
00092             }
00093         }
00094 
00095         explain_buffer_einval_vague(sb, "data->index");
00096         break;
00097 
00098     default:
00099         explain_iocontrol_generic_print_explanation
00100         (
00101             p,
00102             sb,
00103             errnum,
00104             fildes,
00105             request,
00106             data
00107         );
00108         break;
00109     }
00110 }
00111 
00112 
00113 static void
00114 print_data_returned(const explain_iocontrol_t *p, explain_string_buffer_t *sb,
00115     int errnum, int fildes, int request, const void *data)
00116 {
00117     (void)p;
00118     (void)errnum;
00119     (void)fildes;
00120     (void)request;
00121     explain_buffer_v4l2_output(sb, data, 1);
00122 }
00123 
00124 
00125 const explain_iocontrol_t explain_iocontrol_vidioc_enumoutput =
00126 {
00127     "VIDIOC_ENUMOUTPUT", /* name */
00128     VIDIOC_ENUMOUTPUT, /* value */
00129     0, /* disambiguate */
00130     0, /* print_name */
00131     print_data,
00132     print_explanation,
00133     print_data_returned,
00134     sizeof(struct v4l2_output), /* data_size */
00135     "struct v4l2_output *", /* data_type */
00136     0, /* flags */
00137     __FILE__,
00138     __LINE__,
00139 };
00140 
00141 #else /* ndef VIDIOC_ENUMOUTPUT */
00142 
00143 const explain_iocontrol_t explain_iocontrol_vidioc_enumoutput =
00144 {
00145     0, /* name */
00146     0, /* value */
00147     0, /* disambiguate */
00148     0, /* print_name */
00149     0, /* print_data */
00150     0, /* print_explanation */
00151     0, /* print_data_returned */
00152     0, /* data_size */
00153     0, /* data_type */
00154     0, /* flags */
00155     __FILE__,
00156     __LINE__,
00157 };
00158 
00159 #endif /* VIDIOC_ENUMOUTPUT */
00160 
00161 /* vim: set ts=8 sw=4 et : */