[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Xen-devel] [PATCH RFC] CODING_STYLE: document intended usage of types

Signed-off-by: Jan Beulich <jbeulich@xxxxxxxx>

@@ -88,6 +88,26 @@ Braces should be omitted for blocks with
 if ( condition )
+Use basic C types and C standard mandated typedef-s where possible (and
+with preference in this order).  This in particular means to avoid u8,
+u16, etc despite those types continuing to exist in our code base.
+Fixed width types should only be used when a fixed width quantity is
+meant (which for example may be a value read from or to be written to a
+When signedness matters, qualify plain char, short, int, long, and
+long long with "signed" or "unsigned".  Signedness is specifically
+considered to matter when the valid value range of a variable covers
+only non-negative values.  The prime example of such is a variable used
+to index an array (negative array indexes, while they may occur, are
+rather rare).
+Especially with pointer types, whenever the pointed to object is not
+(supposed to be) modified, qualify the pointed to type with "const".

Xen-devel mailing list



Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.