From: Eli Bendersky Date: Sat, 9 Mar 2013 13:54:00 +0000 (-0800) Subject: Add warning in ctypes documentation for #16575 and #16576 X-Git-Tag: v3.2.4rc1~47 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=490cf4472ec1d5ce70f7e4817b47c392f22d579c;p=thirdparty%2FPython%2Fcpython.git Add warning in ctypes documentation for #16575 and #16576 --- diff --git a/Doc/library/ctypes.rst b/Doc/library/ctypes.rst index 486c96355738..6f093fe1cf53 100644 --- a/Doc/library/ctypes.rst +++ b/Doc/library/ctypes.rst @@ -603,6 +603,13 @@ for debugging because they can provide useful information:: .. _ctypes-structureunion-alignment-byte-order: +.. warning:: + + :mod:`ctypes` does not support passing unions or structures with bit-fields + to functions by value. While this may work on 32-bit x86, it's not + guaranteed by the library to work in the general case. Unions and + structures with bit-fields should always be passed to functions by pointer. + Structure/union alignment and byte order ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^