Package com.upmem.dpu

Interface DpuSet

All Known Implementing Classes:

Dpu, DpuRank, DpuSystem

public interface DpuSet

Interface for one or more DPUs.

See Also:

DpuSystem, DpuRank, Dpu

Method Summary

Modifier and Type	Method	Description
DpuSetAsync	async()	Provide access to the subset of methods which can be used asynchronously.
void	copy(byte[][] dstBuffers, DpuSymbol srcSymbol)	Copy data from each DPU of the DPU set.
void	copy(byte[][] dstBuffers, java.lang.String srcSymbol)	Copy data from each DPU of the DPU set.
void	copy(DpuSymbol dstSymbol, byte[] srcBuffer)	Copy data to the DPU set.
void	copy(DpuSymbol dstSymbol, byte[][] srcBuffers)	Copy different data to each DPU of the DPU set.
void	copy(java.lang.String dstSymbol, byte[] srcBuffer)	Copy data to the DPU set.
void	copy(java.lang.String dstSymbol, byte[][] srcBuffers)	Copy different data to each DPU of the DPU set.
java.util.List<Dpu>	dpus()	Provide the DPU devices in the set.
void	exec()	Execute the previously loaded DPU program on the DPU set.
void	exec(java.io.PrintStream logStream)	Execute the previously loaded DPU program on the DPU set, then log the DPU logs in the given stream.
DpuProgramInfo	load(java.lang.String dpuExecutable)	Load the given DPU program in the DPU set.
void	log()	Print the DPU set logs on the default log stream.
void	log(java.io.PrintStream logStream)	Print the DPU set logs on the given log stream.
java.util.List<DpuRank>	ranks()	Provide the DPU ranks in the set.
void	reset()	Apply the reset process to the DPU set.

Method Detail

dpus

java.util.List<Dpu> dpus()

Provide the DPU devices in the set.

Returns:

The DPUs in the set.

See Also:

Dpu

ranks

java.util.List<DpuRank> ranks()

Provide the DPU ranks in the set.

Returns:

The DPU ranks in the set.

See Also:

DpuRank

async

DpuSetAsync async()

Provide access to the subset of methods which can be used asynchronously.

Returns:

The asynchronous interface for the current DPU set.

See Also:

DpuSetAsync

reset

void reset()
    throws DpuException

Apply the reset process to the DPU set.

Throws:

DpuException - When the reset fails.

See Also:

DpuException

load

DpuProgramInfo load(java.lang.String dpuExecutable)
             throws DpuException

Load the given DPU program in the DPU set.

Parameters:

dpuExecutable - The path to the DPU program.

Returns:

The information on the loaded DPU program.

Throws:

DpuException - When the program cannot be loaded.

See Also:

DpuProgramInfo, DpuException

copy

void copy(java.lang.String dstSymbol,
          byte[] srcBuffer)
   throws DpuException

Copy data to the DPU set.

Parameters:

dstSymbol - The destination DPU symbol name.

srcBuffer - The host data to be copied to the DPU set.

Throws:

DpuException - When the data cannot be copied.

See Also:

DpuException

copy

void copy(DpuSymbol dstSymbol,
          byte[] srcBuffer)
   throws DpuException

Copy data to the DPU set.

Parameters:

dstSymbol - The destination DPU symbol.

srcBuffer - The host data to be copied to the DPU set.

Throws:

DpuException - When the data cannot be copied.

See Also:

DpuSymbol, DpuException

copy

void copy(java.lang.String dstSymbol,
          byte[][] srcBuffers)
   throws DpuException

Copy different data to each DPU of the DPU set.

Parameters:

dstSymbol - The destination DPU symbol name.

srcBuffers - The host data to be copied to the DPU set.

Throws:

DpuException - When the data cannot be copied.

See Also:

DpuException

copy

void copy(DpuSymbol dstSymbol,
          byte[][] srcBuffers)
   throws DpuException

Copy different data to each DPU of the DPU set.

Parameters:

dstSymbol - The destination DPU symbol.

srcBuffers - The host data to be copied to the DPU set.

Throws:

DpuException - When the data cannot be copied.

See Also:

DpuSymbol, DpuException

copy

void copy(byte[][] dstBuffers,
          java.lang.String srcSymbol)
   throws DpuException

Copy data from each DPU of the DPU set.

Parameters:

dstBuffers - The host buffers storing the DPU data.

srcSymbol - The source DPU symbol name.

Throws:

DpuException - When the data cannot be copied.

See Also:

DpuException

copy

void copy(byte[][] dstBuffers,
          DpuSymbol srcSymbol)
   throws DpuException

Copy data from each DPU of the DPU set.

Parameters:

dstBuffers - The host buffers storing the DPU data.

srcSymbol - The source DPU symbol.

Throws:

DpuException - When the data cannot be copied.

See Also:

DpuSymbol, DpuException

exec

void exec()
   throws DpuException

Execute the previously loaded DPU program on the DPU set.

If a default log stream has been provided during the DPU system allocation, it will be used to print the DPU logs after the execution

Throws:

DpuException - When the program execution triggers a DPU fault.

See Also:

load(java.lang.String), DpuException, DpuFaultDump

exec

void exec(java.io.PrintStream logStream)
   throws DpuException

Execute the previously loaded DPU program on the DPU set, then log the DPU logs in the given stream.

Parameters:

logStream - Where to print the DPU logs after execution.

Throws:

DpuException - When the program execution triggers a DPU fault.

See Also:

load(java.lang.String), DpuException, DpuFaultDump

log

void log()
  throws DpuException

Print the DPU set logs on the default log stream.

If no default stream was provided during the allocation, uses the standard output.

Throws:

DpuException - When the DPU logs cannot be fetched or displayed.

See Also:

DpuException

log

void log(java.io.PrintStream logStream)
  throws DpuException

Print the DPU set logs on the given log stream.

Parameters:

logStream - The stream on which the DPU logs will be printed.

Throws:

DpuException - When the DPU logs cannot be fetched or displayed.

See Also:

DpuException