Table of Contents

Name

BldCrtPartition - create AccelNET shared memory partition for use by Xcrt

Description

BldCrtPartiton creates and initializes the shared memory partition for use by Xcrt. Usually this function is called by crt(1) .

This function creates an initializes a database partition in a manner similiar to BldMasterPartition(3tbl) except that it allows another (arbitrary) data structure to placed in the partition.

The size of the structure is specified by CCsize and a pointer to the structure is returned in CCpnt. Xcrt uses this structure to hold data which is private to Xcrt but must be shared by the two programs (crt and ts) which make up Xcrt.

This function is part of tblmngr.

Syntax

HEADER_TBL *BldCrtPartition(
   MASTER_SIZE *SZpnt,

   char **CCpnt,

   int CCsize,

   unsigned int key,

   char *s_addr,

   char *s_wperm,

   int *part_key,

   int *part_id,

   int *part_size,

   int *part_wperm,

   void **attach_addr

   );

Arguments

SZpnt
Pointer to the MASTER_SIZE record which contains the table size information.
**CCpnt

Pointer to a pointer in which to return the private data structure pointer.
CCsize

The size of the private data structure.
key

if key == 0 then IPC_PRIVATE is used else key is used as the shared memory identifier in the shared mem partition create.
s_addr

attachment address, if this is null the hardcoded default value is used
s_wperm
permissions mask, if this is null the hardcoded default value is used
part_key

returned value - the shared memory key
part_id

Pointer to an integer in which to return the shared memory id returned by the call to CreateShMem(3tbl) .
part_size

returned value - the shared memory partition size
part_wperm

returned value - the shared memory partition permissions
attach_addr

returned value - the attachment address

Returns

A pointer to the HEADER_TBL if successful. NULL is returned on most other failures.

See Also

tblmngr(3tbl)

Manual page revision

$Id: BldCrtP.3,v 1.4 2008/03/13 14:52:51 kitchen Exp $


Table of Contents