Class IobufRetriever

java.lang.Object
uk.ac.manchester.spinnaker.front_end.BoardLocalSupport
uk.ac.manchester.spinnaker.front_end.iobuf.IobufRetriever
All Implemented Interfaces:
AutoCloseable

public class IobufRetriever
extends BoardLocalSupport
implements AutoCloseable
Retrieves and processes IOBUFs.
Author:
Donal Fellows
  • Constructor Details

    • IobufRetriever

      @MustBeClosed public IobufRetriever​(TransceiverInterface transceiver, uk.ac.manchester.spinnaker.machine.Machine machine, int parallelSize)
      Create a IOBUF retriever.
      Parameters:
      transceiver - How to talk to the machine.
      machine - Description of the machine being talked to.
      parallelSize - How many tasks to do at once (at most).
  • Method Details

    • close

      public void close() throws InterruptedException
      Specified by:
      close in interface AutoCloseable
      Throws:
      InterruptedException
    • retrieveIobufContents

      public NotableMessages retrieveIobufContents​(IobufRequest request, File provenanceDir) throws IOException, ProcessException, InterruptedException
      Retrieve and translate some IOBUFs.
      Parameters:
      request - Mapping from the full paths to the APLX files executing, to the cores on which those executables are running and which are to have their IOBUFs extracted. There must be a .dict file as a sibling to each APLX file.
      provenanceDir - The directory in which provenance data is written.
      Returns:
      The errors and warnings that have been detected. The order of the messages is not determined.
      Throws:
      IOException - If network IO fails or the mapping dictionary is absent.
      ProcessException - If SpiNNaker rejects a message.
      InterruptedException - If communications are interrupted.
      RuntimeException - If an unexpected exception happens.
    • retrieveIobufContents

      public NotableMessages retrieveIobufContents​(uk.ac.manchester.spinnaker.machine.CoreSubsets cores, File binaryFile, File provenanceDir) throws IOException, ProcessException, InterruptedException
      Retrieve and translate some IOBUFs.
      Parameters:
      cores - The cores from which the IOBUFs are to be extracted. They must be running the executable contained in binaryFile or the buffers will contain the wrong information.
      binaryFile - The APLX file being executed. There must be a .dict file as a sibling to it.
      provenanceDir - The directory in which provenance data is written.
      Returns:
      The errors and warnings that have been detected. The order of the messages is not determined.
      Throws:
      IOException - If network IO fails or the mapping dictionary is absent.
      ProcessException - If SpiNNaker rejects a message.
      InterruptedException - If communications are interrupted.
      RuntimeException - If an unexpected exception happens.