Files @ b33d1be6d118
Branch filter:

Location: CSY/reowolf/docs/runtime/known_issues.md

Max Henger
Merge branch 'fix-compiler-bin-2' into 'master'

fix: add support for log level to bin-compiler

See merge request nl-cwi-csy/reowolf!10
# Known Issues

The current implementation of Reowolf has the following known issues:

- Cannot create uninitialized variables that are later known to be initialized. This is not a problem for the regular types (perhaps a bit tedious), but is a problem for channels/ports. That is to say: if a component needs a temporary variable for a port, then it must create a complete channel. e.g.

  ```
  comp send(out<u32> tx1, out<u32> tx2, in<bool> which) {
    channel unused -> temporary;
    while (true) sync {
      if (get(which)) {
        temporary = tx1;
      } else {
        temporary = tx2;
      }
      put(temporary, 1);
    }
  }
  ```

- Reserved memory for ports will grow without bounds: Ports can be given away from one component to another by creating a component, or by sending a message containing them. The component sending those ports cannot remove them from its own memory if there are still other references to the transferred port in its memory. This is because we want to throw a reasonable error if that transferred port is used by the original owner. Hence we need to keep some information about that transferred port in the sending component's memory. The solution is to have reference counting for the ports, but this is not implemented.

- An extra to the above statements: when transferring ports to a new component, the memory that remembers the state of that port is removed from the component that is creating the new one. Hence using old references to that port within the creating component's PDL code results in a crash.

- Some control algorithms are not robust under multithreading. Mainly error handling when in sync mode (because there needs to be a revision where we keep track of which components are still reachable by another component). And complicated scenarios where ports are transferred.