Minor Doxygen updates/fixes.

[libserialport.git] / linux_termios.c

diff --git a/linux_termios.c b/linux_termios.c
index 874889aba4641c7ed268923f1eeb32d4908b5d47..328c4d39b4024bc06fc218a52a69e7ac2cbd079c 100644 (file)
--- a/linux_termios.c
+++ b/linux_termios.c
@@ -17,6 +17,24 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
+/*
+ * At the time of writing, glibc does not support the Linux kernel interfaces
+ * for setting non-standard baud rates and flow control. We therefore have to
+ * prepare the correct ioctls ourselves, for which we need the declarations in
+ * linux/termios.h.
+ *
+ * We can't include linux/termios.h in serialport.c however, because its
+ * contents conflict with the termios.h provided by glibc. So this file exists
+ * to isolate the bits of code which use the kernel termios declarations.
+ *
+ * The details vary by architecture. Some architectures have c_ispeed/c_ospeed
+ * in struct termios, accessed with TCSETS/TCGETS. Others have these fields in
+ * struct termios2, accessed with TCSETS2/TCGETS2. Some architectures have the
+ * TCSETX/TCGETX ioctls used with struct termiox, others do not.
+ */
+
+#if defined(__linux__) && !defined(__ANDROID__)
+
 #include <linux/termios.h>
 #include "linux_termios.h"
 
@@ -81,8 +99,8 @@ int get_termiox_size(void)
 int get_termiox_flow(void *data)
 {
        struct termiox *termx = (struct termiox *) data;
-
        int flags = 0;
+
        if (termx->x_cflag & RTSXOFF)
                flags |= RTS_FLOW;
        if (termx->x_cflag & CTSXON)
@@ -111,3 +129,5 @@ void set_termiox_flow(void *data, int flags)
                termx->x_cflag |= DSRXON;
 }
 #endif
+
+#endif