weShareMem.c File Reference

One chunk of shared memory on a Raspberry Pi. More...

#include "weShareMem.h"

Functions
int	deleteSemas ()
	Delete the one semaphore set. More...
int	deleteSharedMem ()
	Delete and detach the shared memory. More...
int	detachSharedMem ()
	Detach the shared memory.
int	getSemas ()
	Get the one semaphore set. More...
int	initialiseSemas ()
	Initialise the one semaphore set. More...
void *	initialiseSharedMem ()
	Initialise shared memory. More...
int	semaphoreClt (int const semNum, int const op, semCtlPar_t par)
	Control semaphores of the set. More...
int	semaphoreLock (int const semNum, int const ms)
	Lock one semaphore of the set. More...
int	semaphoreOperation (int const semNum, int op, int const ms)
	Operation on one semaphore of the set. More...
int	semaphoreUnlock (int const semNum)
	Unlock one semaphore of the set. More...

Variables
int	shMemErrno
	Last error number of (some ) semaphore operations. More...
int	shMemSem
	Semaphore set identifier. More...
const semCtlPar_t	VAL0
	value 0 for SETVAL
const semCtlPar_t	VAL1
	value 1 for SETVAL
const semCtlPar_t	VAL9
	value 9 for SETVAL

Detailed Description

One chunk of shared memory on a Raspberry Pi.

Copyright  (c)  2018  2025   Albrecht Weinert
weinert-automation.de            a-weinert.de
 
    /         /      /\
   /         /___   /  \      |
   \        /____\ /____\ |  _|__
    \  /\  / \    /      \|   |
     \/  \/   \__/        \__/|_                                 

Revision history

Rev. 76  26.02.2025
Rev.  73+ 16.11.2017 : new
Rev.  75  30.11.2017 : signal semaphore initialised to 0
Rev. 188  15.10.2018 : minor typos
Rev.  76  24.02.2025 : clarification of 64 bit OS malfunction

cross-compile by:

arm-linux-gnueabihf-gcc -DMCU=BCM2837 -I./include -c -o weRasp/weShareMem.o weRasp/weShareMem.c

For documentation see also the include file weShareMem.h

Function Documentation

getSemas()

int getSemas

(

)

Get the one semaphore set.

The one semaphore set, if existing, will be registered and used as is.

Returns

0: OK found existing semaphore set; -1: error (errno set and errorText generated)

initialiseSemas()

int initialiseSemas

(

)

Initialise the one semaphore set.

The number of semaphores in the set is ANZ_SEMAS (default three). The one semaphore set, if existing, will be registered and used as is. If this is not possible it will be made and initialised.

Hint: This function has two OK return values!

Returns

1: OK semaphore set made new; 0: OK found existing semaphore set; -1: error (errno set and errorText generated)

deleteSemas()

int deleteSemas

(

)

Delete the one semaphore set.

Server operation only.

Returns

0: OK; -1: error (errno set and errorText generated)

semaphoreOperation()

int semaphoreOperation	(	int const	semNum,
		int const	op,
		int	ms
	)

Operation on one semaphore of the set.

Parameters

semNum	the semaphore number in the set (0..ANZ_SEMAS -1)
op	the semaphore operation
ms	if 2..20000 a timeout in ms

Returns

0: OK; -1: error (errno set and errorText generated)

semaphoreLock()

int semaphoreLock	(	int const	semNum,
		int	ms
	)

Lock one semaphore of the set.

Parameters

semNum	the semaphore number in the set (0..ANZ_SEMAS -1)
ms	if 2..20000 a timeout in ms

Returns

0: OK; -1: error (errno set and errorText generated)

semaphoreUnlock()

int semaphoreUnlock

(

int const

semNum

)

Unlock one semaphore of the set.

Parameters

semNum

the semaphore number in the set (0..ANZ_SEMAS -1)

Returns

0: OK; -1: error (errno set and errorText generated)

semaphoreClt()

int semaphoreClt	(	int const	semNum,
		int const	op,
		semCtlPar_t	par
	)

Control semaphores of the set.

Parameters

semNum	the semaphore number in the set (0..ANZ_SEMAS -1)
op	the semaphore operation, like e.g. SETVAL
par	op's parameter if any

Returns

0: OK; -1: error (errno set and errorText generated)

initialiseSharedMem()

void * initialiseSharedMem

(

)

Initialise shared memory.

Make or get and attach. return pointer to attached shared memory or (void *)-1

deleteSharedMem()

int deleteSharedMem

(

)

Delete and detach the shared memory.

Server operation only.

Variable Documentation

shMemSem

int shMemSem

Semaphore set identifier.

The value returned by e.g. semget() (within getSemas() etc.) On success, semget() returns the semaphore set identifier (a nonnegative integer). On failure, -1 is returned, and errno is set to indicate the error.

shMemErrno

int shMemErrno

Last error number of (some ) semaphore operations.