libexplain  1.4.D001
libexplain/iocontrol/tioclinux.c
Go to the documentation of this file.
00001 /*
00002  * libexplain - Explain errno values returned by libc functions
00003  * Copyright (C) 2009-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/linux/tiocl.h>
00021 #include <libexplain/ac/sys/ioctl.h>
00022 
00023 #include <libexplain/buffer/tioclinux.h>
00024 #include <libexplain/iocontrol/tioclinux.h>
00025 
00026 
00027 #ifdef TIOCLINUX
00028 
00029 static void
00030 print_data(const explain_iocontrol_t *p, explain_string_buffer_t *sb,
00031     int errnum, int fildes, int request, const void *data)
00032 {
00033     (void)p;
00034     (void)errnum;
00035     (void)fildes;
00036     (void)request;
00037     explain_buffer_tioclinux(sb, data);
00038 }
00039 
00040 
00041 /*
00042  * Bletch!
00043  *
00044  * This should have been about a dozen separate ioctl requests.
00045  * Someone needs to read Rusty's hierarchy of API goodness.
00046  * http://ozlabs.org/~rusty/index.cgi/tech/2008-03-30.html
00047  * http://www.pointy-stick.com/blog/2008/01/09/api-design-rusty-levels/
00048  * http://ozlabs.org/~rusty/ols-2003-keynote/ols-keynote-2003.html
00049  */
00050 union foo
00051 {
00052     char a[1 + sizeof(struct tiocl_selection)];
00053     char b[4 + sizeof(struct { long dummy[8]; })];
00054     char c[1 + sizeof(char *)];
00055 };
00056 
00057 /*
00058  * There are several cases that return data BUT they overwrite the
00059  * control bytes, so we don't know at print_data_returned time which
00060  * code it was, and thuis can't print a representation.  Sigh.
00061  */
00062 
00063 const explain_iocontrol_t explain_iocontrol_tioclinux =
00064 {
00065     "TIOCLINUX", /* name */
00066     TIOCLINUX, /* value */
00067     0, /* disambiguate */
00068     0, /* print_name */
00069     print_data,
00070     0, /* print_explanation */
00071     0, /* print_data_returned */
00072     sizeof(union foo), /* data_size */
00073     "union foo *", /* data_type */
00074     IOCONTROL_FLAG_SIZE_DOES_NOT_AGREE, /* flags */
00075     __FILE__,
00076     __LINE__,
00077 };
00078 
00079 #else
00080 
00081 const explain_iocontrol_t explain_iocontrol_tioclinux =
00082 {
00083     0, /* name */
00084     0, /* value */
00085     0, /* disambiguate */
00086     0, /* print_name */
00087     0, /* print_data */
00088     0, /* print_explanation */
00089     0, /* print_data_returned */
00090     0, /* data_size */
00091     0, /* data_type */
00092     0, /* flags */
00093     __FILE__,
00094     __LINE__,
00095 };
00096 
00097 #endif
00098 
00099 
00100 /* vim: set ts=8 sw=4 et : */