B.2 C hooks

To save the backend developer from having to implement coNCePTuaL backends entirely from scratch, coNCePTuaL provides a codegen_c_generic.py module that defines a base class for code generators that output C code. The base class handles the features that are specific to C but independent of any messaging library. Derived classes need only define those “hook” functions that are needed to implement library-specific functionality.

Hooks are named after the method from which they’re called but with an all-uppercase tag appended. The following list shows each hook-calling method in codegen_c_generic.py and the set of hooks it calls. See Hook methods, for more information.

• code_declare_datatypes
  • - code_declare_datatypes_EXTRA_EVENTS
  • - code_declare_datatypes_EXTRA_EVENT_STATE
  • - code_declare_datatypes_EXTRA_EVS
  • - code_declare_datatypes_MCAST_STATE
  • - code_declare_datatypes_POST
  • - code_declare_datatypes_PRE
  • - code_declare_datatypes_RECV_STATE
  • - code_declare_datatypes_REDUCE_STATE
  • - code_declare_datatypes_SEND_STATE
  • - code_declare_datatypes_SYNC_STATE
  • - code_declare_datatypes_WAIT_STATE
• code_declare_globals
  • - code_declare_globals_DUMMY_VAR
  • - code_declare_globals_EXTRA
• code_def_alloc_event
  • - code_def_alloc_event_DECLS
  • - code_def_alloc_event_POST
  • - code_def_alloc_event_PRE
• code_def_exit_handler
  • - code_def_exit_handler_BODY
• code_def_finalize
  • - code_def_finalize_DECL
  • - code_def_finalize_POST
  • - code_def_finalize_PRE
• code_def_init_check_pending
  • - code_def_init_check_pending_POST
  • - code_def_init_check_pending_PRE
• code_def_init_cmd_line
  • - code_def_init_cmd_line_POST_ARGS
  • - code_def_init_cmd_line_POST_PARSE
  • - code_def_init_cmd_line_PRE_ARGS
  • - code_def_init_cmd_line_PRE_PARSE
• code_def_init_decls
  • - code_def_init_decls_POST
  • - code_def_init_decls_PRE
• code_def_init_init
  • - code_def_init_init_POST
  • - code_def_init_init_PRE
• code_def_init_misc
  • - code_def_init_misc_EXTRA
  • - code_def_init_misc_PRE_LOG_OPEN
• code_def_init_msg_mem
  • - code_def_init_msg_mem_EACH_TAG
  • - code_def_init_msg_mem_POST
  • - code_def_init_msg_mem_PRE
• code_def_init_reseed
  • - code_def_init_reseed_BCAST
• code_def_init_seed
  • - code_def_init_seed_POST
  • - code_def_init_seed_PRE
• code_def_init_uuid
  • - code_def_init_uuid_BCAST
• code_def_mark_used
  • - code_def_mark_used_POST
  • - code_def_mark_used_PRE
• code_def_procev
  • - code_def_procev_DECL
  • - code_def_procev_EVENTS_DECL
  • - code_def_procev_EXTRA_EVENTS
  • - code_def_procev_POST
  • - code_def_procev_POST_SWITCH
  • - code_def_procev_PRE
  • - code_def_procev_PRE_SWITCH
• code_def_procev_arecv
  • - code_def_procev_arecv_BODY
• code_def_procev_asend
  • - code_def_procev_asend_BODY
• code_def_procev_etime
  • - code_def_procev_etime_REDUCE_MIN
• code_def_procev_mcast
  • - code_def_procev_mcast_BODY
• code_def_procev_newstmt
  • - code_def_procev_newstmt_BODY
• code_def_procev_recv
  • - code_def_procev_recv_BODY
• code_def_procev_reduce
  • - code_def_procev_reduce_BODY
• code_def_procev_repeat
  • - code_def_procev_repeat_BODY
• code_def_procev_send
  • - code_def_procev_send_BODY
• code_def_procev_sync
  • - code_def_procev_sync_BODY
• code_def_procev_wait
  • - code_def_procev_wait_BODY_RECVS
  • - code_def_procev_wait_BODY_SENDS
• code_def_small_funcs
  • - code_def_small_funcs_POST
  • - code_def_small_funcs_PRE
• code_define_functions
  • - code_define_functions_INIT_COMM_1
  • - code_define_functions_INIT_COMM_2
  • - code_define_functions_INIT_COMM_3
  • - code_define_functions_POST
  • - code_define_functions_PRE
• code_define_macros
  • - code_define_macros_POST
  • - code_define_macros_PRE
• code_define_main
  • - code_define_main_DECL
  • - code_define_main_POST_EVENTS
  • - code_define_main_POST_INIT
  • - code_define_main_PRE_EVENTS
  • - code_define_main_PRE_INIT
• code_output_header_comments
  • - code_output_header_comments_EXTRA
• code_specify_include_files
  • - code_specify_include_files_POST
  • - code_specify_include_files_PRE
• code_synchronize_all
  • - code_synchronize_all_BODY
• n_for_count
  • - n_for_count_SYNC_ALL
• n_mcast_stmt
  • - n_mcast_stmt_DECL
  • - n_mcast_stmt_INIT
  • - n_mcast_stmt_MANY_MANY
  • - n_mcast_stmt_POST
  • - n_mcast_stmt_PRE
• n_recv_stmt
  • - n_recv_stmt_BODY
• n_reduce_stmt
  • - n_reduce_stmt_DECL
  • - n_reduce_stmt_HAVE_PEERS
  • - n_reduce_stmt_INIT
  • - n_reduce_stmt_INIT2
  • - n_reduce_stmt_POST
  • - n_reduce_stmt_PRE
• n_send_stmt
  • - n_send_stmt_BODY
• n_sync_stmt
  • - n_sync_stmt_DECL
  • - n_sync_stmt_INIT
  • - n_sync_stmt_POST
  • - n_sync_stmt_PRE