MISRA.md

MISRA Compliance

The FreeRTOS-Plus-TCP library files conform to the MISRA C:2012 guidelines, with some noted exceptions. Compliance is checked with Coverity static analysis. Since the FreeRTOS-Plus-TCP library is a low level library and might need to interact with the network hardware directly, some MISRA violations as listed below are not "fixed". Deviations from the MISRA standard are listed below:

Flagged by Coverity

Deviation	Category	Justification
Rule 1.2	Advisory	Language extenstions are being used in a portable manner for each specific compiler.
Rule 8.7	Advisory	Functions without an external linkage are being used in other projects. Thus, function declarations are kept.
Rule 19.2	Advisory	Unions are used to reduce the memory footprint and to represent packet formats in the FreeRTOS-Plus-TCP network stack.
Directive 4.6	Advisory	Non-typedef-ed variables are used in compiler and platform specific manner (portable).
Rule 20.1	Advisory	#includes are used to include compiler specific attributes to make "packed structures".
Rule 11.4	Advisory	Integer to pointer conversion is done in various modules to aid in pointer arithmetic and to pass error codes using pointers (such as FREERTOS_INVALID_SOCKET).
Rule 11.3	Required	Pointer conversions are done to access various data members of a given data packet.
Rule 15.4	Advisory	break statements are used in conjucture with do-while(0) to reduce if-else nesting.
Rule 8.13	Advisory
Rule 10.5	Advisory	Numerical casting is done only for the ucTCPState member of xTCP structure to cast it to eIPTCPState_t enum which has been verified to be big enough to store all values in the ucTCPState.
Rule 11.8	Required	const identifier is removed in some cases since certain structs are made to be used with modifiable types.
Rule 14.4	Required	Condition 0 not having an essentially boolean type is used in portable layer of the Kernel for taskENTER_CRITICAL and taskEXIT_CRITICAL.
Rule 8.6	Required	Some functions are declared but not defined since they are to be defined by the user application to provide 'hooks' for certain events.
Rule 2.3	Advisory
Rule 20.10	Advisory	For casting between pointer types, FreeRTOS-Plus-TCP uses utility inline functions created using the ## operator to improve readability.
Rule 10.4	Required	Signed and unsigned variables are used together due to the variables acquired from the portable code.
Rule 13.5	Required	In prvTCPSendPacket (present in FreeRTOS_TCP_IP.c) persistent side effect of function call as right-hand operators of `
Rule 15.5	Advisory	Some FreeRTOS-Plus-TCP functions use multiple return statements; These have not been refactored to comply with this rule.
Rule 18.3	Required	Relational operators are used with members of unions.
Rule 21.6	Required	In FreeRTOS_strerror_r (present in FreeRTOS_IP.c) snprintf is used to format strings before placing them into buffers.
Rule 10.8	Required	Unsigned expression in function prvSendData (present in FreeRTOS_TCP_IP.c) is cast to signed to compare with a signed variable.
Rule 11.1	Required	In FreeRTOS_setsockopt (present in FreeRTOS_Sockets.c), void * is used to pass variables of various types to be set as the socket option. One of these options allow the users to pass function pointer as well thereby violating the rule. To adhere to the Berkeley standard, the function signature cannot be changed.
Rule 14.3	Required	Use of conditional compilation hides the update to the controlling expression which can causes false positives of this rule. The violation occurs in the function prvProcessIPPacket present in FreeRTOS_IP.c.
Rule 2.2	Required	FreeRTOS+TCP uses unions which can cause false positives of this rule. The false positive occurs once in FreeRTOS_IP.c module in the function usGenerateChecksum.
Rule 5.9	Advisory	Utility functions are defined in various files to not break various other projects.
Rule 8.9	Advisory	For ease, configuration parameters are defined at a global scope even when used only once.

Suppressed with Coverity Comments

None.