source: rtems-central/spec/rtems/req/ident-local.yml

SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
copyrights:
- Copyright (C) 2020 embedded brains GmbH & Co. KG
enabled-by: true
functional-type: action
links:
- role: requirement-refinement
  uid: group
post-conditions:
- name: Status
  states:
  - name: Ok
    test-code: |
      T_rsc( ctx->status, RTEMS_SUCCESSFUL );
    text: |
      The return status shall be ${../status/if/successful:/name}.
  - name: InvAddr
    test-code: |
      T_rsc( ctx->status, RTEMS_INVALID_ADDRESS );
    text: |
      The return status shall be ${../status/if/invalid-address:/name}.
  - name: InvName
    test-code: |
      T_rsc( ctx->status, RTEMS_INVALID_NAME );
    text: |
      The return status shall be ${../status/if/invalid-name:/name}.
  test-epilogue: null
  test-prologue: null
- name: Id
  states:
  - name: Nop
    test-code: |
      T_eq_ptr( ctx->id, &ctx->id_value );
      T_eq_u32( ctx->id_value, 0xffffffff );
    text: |
      The value of the object identifier referenced by the id parameter shall
      be the value before the action.
  - name: 'Null'
    test-code: |
      T_null( ctx->id )
    text: |
      While the id is NULL.
  - name: Id
    test-code: |
      T_eq_ptr( ctx->id, &ctx->id_value );
      T_eq_u32( ctx->id_value, ctx->id_local_object );
    text: |
      The value of the object identifier referenced by the id parameter shall
      be the identifier of a local object of the specified class with a name
      equal to the name parameter.  If more than one local object of the
      specified class with such a name exists, then it shall be the identifier
      of the object with the lowest object index.
  test-epilogue: null
  test-prologue: null
pre-conditions:
- name: Name
  states:
  - name: Invalid
    test-code: |
      ctx->name = 1;
    text: |
      While the ``name`` parameter is not associated with an active object of
      the specified class .
  - name: Valid
    test-code: |
      ctx->name = ctx->name_local_object;
    text: |
      While the ``name`` parameter is associated with an active object of the
      specified class .
  test-epilogue: null
  test-prologue: null
- name: Id
  states:
  - name: Valid
    test-code: |
      ctx->id_value = 0xffffffff;
      ctx->id = &ctx->id_value;
    text: |
      While the ``id`` parameter references an object of type
      ${../type/if/id:/name}.
  - name: 'Null'
    test-code: |
      ctx->id = NULL;
    text: |
      While the ``id`` parameter is ${/c/if/null:/name}.
  test-epilogue: null
  test-prologue: null
rationale: null
references: []
requirement-type: functional
skip-reasons: {}
test-action: |
  ctx->status = ( *ctx->action )( ctx->name, ctx->id );
test-brief: null
test-cleanup: null
test-context:
- brief: null
  description: null
  member: rtems_status_code status
- brief: null
  description: null
  member: rtems_name name
- brief: null
  description: null
  member: rtems_id *id
- brief: null
  description: null
  member: rtems_id id_value
test-context-support: null
test-description: null
test-header:
  code: null
  freestanding: false
  includes:
  - rtems.h
  local-includes: []
  run-params:
  - description: |
      is the identifier of an active object of the class under test.
    dir: null
    name: id_local_object
    specifier: rtems_id ${.:name}
  - description: |
      is the name of the active object of the class under test.
    dir: null
    name: name_local_object
    specifier: rtems_name ${.:name}
  - description: |
      is the action handler.
    dir: null
    name: action
    specifier: rtems_status_code ( *${.:name} )( rtems_name, rtems_id * )
  target: testsuites/validation/tr-object-ident-local.h
test-includes: []
test-local-includes:
- tr-object-ident-local.h
test-prepare: null
test-setup: null
test-stop: null
test-support: null
test-target: testsuites/validation/tr-object-ident-local.c
test-teardown: null
text: |
  When the specified object identification directive is called.
transition-map:
- enabled-by: true
  post-conditions:
    Id: 'Null'
    Status: InvAddr
  pre-conditions:
    Id:
    - 'Null'
    Name: all
- enabled-by: true
  post-conditions:
    Id: Nop
    Status: InvName
  pre-conditions:
    Id:
    - Valid
    Name:
    - Invalid
- enabled-by: true
  post-conditions:
    Id: Id
    Status: Ok
  pre-conditions:
    Id:
    - Valid
    Name:
    - Valid
type: requirement