DOKK / manpages / debian 12 / libsc-doc / sc_ShmMessageGrp.3.en
sc::ShmMessageGrp(3) MPQC sc::ShmMessageGrp(3)

sc::ShmMessageGrp - The ShmMessageGrp class is an implementation of MessageGrp that allows multiple process to be started that communicate with shared memory.

#include <messshm.h>

Inherits sc::intMessageGrp.


ShmMessageGrp ()
Reads the number of processors from environmental variable NUMPROC. ShmMessageGrp (const Ref< KeyVal > &)
The ShmMessageGrp KeyVal constructor takes a single keyword that specifies the number of processors. ShmMessageGrp (int nprocs)
Initialize ShmMessageGrp to use nprocs processors. void sync ()
Synchronize all of the processors. Ref< MessageGrp > clone (void)
Returns a copy of this MessageGrp specialization that provides an independent communication context.


void basic_send (int target, int type, const void *data, int nbyte)
Must be implemented by specializations. void basic_recv (int type, void *data, int nbyte)
Must be implemented by specializations. int basic_probe (int type)
Must be implemented by specializations. void initialize (int nprocs)
void initialize ()
msgbuf_t * NEXT_MESSAGE (msgbuf_t *m)
void get_change (int node)
void put_change (int node)
void wait_for_write (int node)
void release_write (int node)
void print_buffer (int node, int me)


commbuf_t * commbuf [MAXPROCS]
int shmid
int semid
int change_semid
void * sharedmem
struct sembuf semdec
struct sembuf seminc

The ShmMessageGrp class is an implementation of MessageGrp that allows multiple process to be started that communicate with shared memory.

This only provides improved performance if you have multiple CPU's in a symmetric multiprocessor configuration. Nonetheless, it is quite useful on a single CPU for tracking down bugs.

The ShmMessageGrp KeyVal constructor takes a single keyword that specifies the number of processors. Here is an example of a ParsedKeyVal input that creates a ShmMessageGrp that runs on four processors:

message<ShmMessageGrp>: n = 4

Must be implemented by specializations.

Implements sc::intMessageGrp.

Must be implemented by specializations.

Implements sc::intMessageGrp.

Must be implemented by specializations.

Implements sc::intMessageGrp.

Ref< MessageGrp > sc::ShmMessageGrp::clone (void) [virtual]

Returns a copy of this MessageGrp specialization that provides an independent communication context.

Implements sc::MessageGrp.

Synchronize all of the processors.

Reimplemented from sc::MessageGrp.

Generated automatically by Doxygen for MPQC from the source code.

Fri Dec 2 2022 Version 2.3.1