Address several issues from compiling examples

Compiling the code from examples "code-block:: c" along with public
includes and a bsp exposed a few issues amongst a lot of false
positives. Address some of these:

* Terminate struct declarations with ';'. Mainly for pedantic
  correctness.

* Show ptrdiff_t instead of size_t for the sbrk() prototype, matching
  the current argument type in rtems.

* Replace some occurrences of unsigned16 with uint16_t.

* Fix odd type declaration, "uint8_t char*" -> "char*".

* Use appropriate helper to get chain head instead of invalid access to
  nonexistent struct member.

* Remove several excess '\' escapes.

* Use RTEMS_SELF instead of undefined SELF.

* Use rtems_task instead of void for task functions.

* Add missing stack size parameter in task creation.

* Use rtems_interrupt_level instead of undefined rtems_interrupt.

* Correct return value format for rtems_object_id_get_api()
  rtems_object_id_get_index() (enum and uint16_t) and also fix
  corresponding print formatting.

* Correct return value documentation for rtems_object_id_get_class(),
  rtems_object_id_get_node() and rtems_object_id_get_index()
  int -> uint32_t.

* Use RTEMS_SUCCESSFUL instead of undefined RTEMS_STATUS_SUCCESSFUL and
  fix return value variable name in rate monotonic examples.

* Use RTEMS_TIMEOUT instead of undefined TIMEOUT and RTEMS_PERIOD_STATUS
  instead of undefined STATUS.

* Add missing fields to ftpd configuration.

* Correct parameter types in ftpd hook prototype,
  unsigned char * -> void *.

* Fix various code-block:: attributes, c -> makefile and c -> shell.

* Add missing parenthesis in socket buffer memory calculation example.

* Remove typedef in declaration of mq_attr since it is defiend without
  typedef in reality.

* Update siginfo_t declaration to match current reality.

* Update shell user command definition example to include mode, uid and
  gid.

1 files changed, 10 insertions, 9 deletions

diff --git a/c-user/object_services.rst b/c-user/object_services.rst
index 2524d52..544ff02 100644
--- a/c-user/object_services.rst
+++ b/c-user/object_services.rst
@@ -114,7 +114,7 @@ printing the values.
     void printObjectId(rtems_id id)
     {
         printf(
-            "API=%d Class=%d Node=%d Index=%d\n",
+            "API=%d Class=%" PRIu32 " Node=%" PRIu32 " Index=%" PRIu16 "\n",
             rtems_object_id_get_api(id),
             rtems_object_id_get_class(id),
             rtems_object_id_get_node(id),
@@ -157,13 +157,14 @@ parts and "pretty-printed."
 
     void prettyPrintObjectId(rtems_id id)
     {
-        int tmpAPI, tmpClass;
+        int tmpAPI;
+        uint32_t tmpClass;
 
         tmpAPI   = rtems_object_id_get_api(id),
         tmpClass = rtems_object_id_get_class(id),
 
         printf(
-            "API=%s Class=%s Node=%d Index=%d\n",
+            "API=%s Class=%s Node=%" PRIu32 " Index=%" PRIu16 "\n",
             rtems_object_get_api_name(tmpAPI),
             rtems_object_get_api_class_name(tmpAPI, tmpClass),
             rtems_object_id_get_node(id),
@@ -373,8 +374,8 @@ OBJECT_ID_GET_CLASS - Obtain Class from Id
 CALLING SEQUENCE:
     .. code-block:: c
 
-        int rtems_object_id_get_class(
-            rtems_id id
+        uint32_t rtems_object_id_get_class(
+                 rtems_id id
         );
 
 DIRECTIVE STATUS CODES:
@@ -403,8 +404,8 @@ OBJECT_ID_GET_NODE - Obtain Node from Id
 CALLING SEQUENCE:
     .. code-block:: c
 
-        int rtems_object_id_get_node(
-            rtems_id id
+        uint32_t rtems_object_id_get_node(
+                 rtems_id id
         );
 
 DIRECTIVE STATUS CODES:
@@ -433,8 +434,8 @@ OBJECT_ID_GET_INDEX - Obtain Index from Id
 CALLING SEQUENCE:
     .. code-block:: c
 
-        int rtems_object_id_get_index(
-            rtems_id id
+        uint16_t rtems_object_id_get_index(
+                 rtems_id id
         );
 
 DIRECTIVE STATUS CODES: