A. Summary of `TOP-C' Commands

From 4.1 The Main TOP-C Library Calls.

void TOPC_init ( int *argc, char ***argv )

void TOPC_finalize ( void )

  Function

void TOPC_master_slave

( TOPC_BUF (*generate_task_input)(),
   TOPC_BUF (*do_task)(void *input),
   TOPC_ACTION (*check_task_result)(void *input, void *output),
   void (*update_shared_data)(void *input, void *output)
)

  Function

TOPC_BUF TOPC_MSG ( void *buf, int buf_size )

  Function

From Callback Functions for TOPC_master_slave() .

TOPC_BUF GenerateTaskInput ( void )

  Function

TOPC_BUF DoTask ( void *input )

  Function

TOPC_ACTION CheckTaskResult ( void *input, void *output)

  Function

void UpdateSharedData ( void *input, void *output )

  Function

From Actions Returned by CheckTaskResult() .

Action TOPC_ACTION NO_ACTION

  Action

Action TOPC_ACTION UPDATE

  Action

Action TOPC_ACTION REDO

  Action

Action TOPC_ACTION CONTINUATION ( void *next_input )

  Action

From 4.4 TOP-C Utilities.

TOPC_BOOL TOPC_is_up_to_date ( void )

  Function

int TOPC_rank ( void )

  Function

TOPC_BOOL TOPC_is_master ( void )

  Function

int TOPC_num_slaves ( void )

  Function

int TOPC_num_idle_slaves ( void )

  Function

int TOPC_node_count ( void )

  Function

From Optimizing TOP-C Code for the Shared Memory Model .

TOPC_thread_private

  Variable

TOPC_thread_private_t

  Type

void TOPC_ATOMIC_READ ( 0 ) { ... C code ... }

void TOPC_ATOMIC_WRITE ( 0 ) { ... C code ... }

  Function

void TOPC_BEGIN_ATOMIC_READ ( 0 )

void TOPC_END_ATOMIC_READ ( 0 )

void TOPC_BEGIN_ATOMIC_WRITE ( 0 )

void TOPC_END_ATOMIC_WRITE ( 0 )

  Function

From Raw `TOP-C' interface: raw_master_slave .

void TOPC_raw_begin_master_slave

(do_task, check_task_result, update_shared_data)

void TOPC_raw_end_master_slave ()

  Function

void TOPC_raw_submit_task_input ( TOPC_BUF input )

  Function

TOPC_BOOL TOPC_raw_wait_for_task_result ()

  Function

From 8.2 Aborting Tasks.

void TOPC_abort_tasks ( void )

TOPC_BOOL TOPC_is_abort_pending ( void )

  Function

From 8.1 Testing for Task Continuations and Redos.

TOPC_BOOL TOPC_is_REDO ( void )

TOPC_BOOL TOPC_is_CONTINUATION ( void )

  Function

From 8.3.2 Using TOPC_MSG_PTR() to Avoid Copying Large Buffers.

TOPC_BUF TOPC_MSG_PTR ( void *buf, int buf_size )

  Function

From Command Line Options in TOP-C Applications .

--TOPC-help`[=<0/1>]'

  [boolean, default: false]

--TOPC-verbose`[=<0/1>]'

  [boolean, default: false]

--TOPC-stats`[=<0/1>]'

  [boolean, default: false]

--TOPC-num-slaves`=<int>'

  [default: -1 (system-defined)]

--TOPC-slave-wait`=<int>'

  [default: 0]

--TOPC-slave-timeout`=<int>'

  [default: 1800 s]

--TOPC-trace`=<int: 0/1/2>'

  [trace (0: notrace, 1: trace, 2: user trace fncs, default: 2)]

--TOPC-procgroup`=<string>'

  [default: "./procgroup"]

--TOPC-safety`=<int: 0..20>'

  [default: 0]

From 6.4 Tracing Messages.

int TOPC_OPT_trace

void (*)(void *input) TOPC_OPT_trace_input

void (*)(void *input, void *output) TOPC_OPT_trace_result