[rtems-central commit] spec/cache/coherent: Add return value for add area

[Joel Sherrill]

Module:    rtems-central
Branch:    master
Commit:    8966d7063513ce5a733218dc36bf89f3988c025f
Changeset: http://git.rtems.org/rtems-central/commit/?id=8966d7063513ce5a733218dc36bf89f3988c025f

Author:    Kinsey Moore <kinsey.moore at oarcorp.com>
Date:      Wed Jan 24 11:00:38 2024 -0600

spec/cache/coherent: Add return value for add area

This changes the return type for rtems_cache_coherent_add_area from void
to rtems_status_code so that the function can report errors when they
occur.

---

 spec/rtems/cache/if/coherent-add-area.yml | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/spec/rtems/cache/if/coherent-add-area.yml b/spec/rtems/cache/if/coherent-add-area.yml
index 410f3c58..1b2f19f8 100644
--- a/spec/rtems/cache/if/coherent-add-area.yml
+++ b/spec/rtems/cache/if/coherent-add-area.yml
@@ -10,7 +10,7 @@ definition:
     params:
     - void *${.:/params[0]/name}
     - ${/c/if/uintptr_t:/name} ${.:/params[1]/name}
-    return: void
+    return: ${../../status/if/code:/name}
   variants: []
 description: null
 enabled-by: true
@@ -40,5 +40,13 @@ params:
     is the size in bytes of the cache coherent memory area to add.
   dir: null
   name: size
-return: null
+return:
+  return: null
+  return-values:
+  - description: |
+      The requested operation was successful.
+    value: ${../../status/if/successful:/name}
+  - description: |
+      The requested operation was not successful.
+    value: ${../../status/if/unsatisfied:/name}
 type: interface