1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/*
* SCCS: @(#)stab.h 1.8 (97/06/02)
*
* UniSoft Ltd., London, England
*
* (C) Copyright 1992 X/Open Company Limited
*
* All rights reserved. No part of this source code may be reproduced,
* stored in a retrieval system, or transmitted, in any form or by any
* means, electronic, mechanical, photocopying, recording or otherwise,
* except as stated in the end-user licence agreement, without the prior
* permission of the copyright owners.
*
* X/Open and the 'X' symbol are trademarks of X/Open Company Limited in
* the UK and other countries.
*/
/************************************************************************
SCCS: @(#)stab.h 1.8 97/06/02 TETware release 3.3
NAME: stab.h
PRODUCT: TETware
AUTHOR: Andrew Dingwall, UniSoft Ltd.
DATE CREATED: April 1992
DESCRIPTION:
sync event table description
MODIFICATIONS:
Andrew Dingwall, UniSoft Ltd., October 1994
added support for sync message data
Andrew Dingwall, UniSoft Ltd., June 1997
changes to enable parallel distributed test cases to work
correctly
************************************************************************/
/*
** Sync event table.
**
** An entry in the sync table is made for each sync event that may be
** waited on by client processes.
** The table is maintained and accessed by routines in stab.c.
**
** Each process that requests a sync event stores request parameters in
** the server-specific part of its process table entry.
**
** It is possible for processes to request the same sync event but with
** different sync numbers.
** The event ocurs as soon as all participating processes have voted but,
** if all processes vote YES, only those who have specified the lowest
** non-zero sync number are notified.
** In this case, the sync table element is retained for reuse when the
** processes next vote on the same event (with a higher sync number).
*/
/* per-user details structure for the sync event table */
struct ustab {
int us_sysid; /* system id */
int us_ptype; /* process type (only used by USYNC) */
int us_state; /* process state (defined in synreq.h) */
long us_spno; /* sync request spno parameter */
int us_ntimedout; /* no of times this user has caused this
event to time out */
struct ptab *us_ptab; /* ptr to user's ptab */
int us_smflags; /* sync message data flags -
only SM_SNDMSG and SM_RCVMSG used here
(defined in synreq.h) */
};
/*
** sync event table - this is a linked list
**
** the next and last pointers must be first so as to allow the
** use of the llist routines to manipulate the table
*/
struct stab {
struct stab *st_next; /* ptr to next element in list */
struct stab *st_last; /* ptr to last element in list */
long st_snid; /* id for auto sync request */
long st_xrid; /* xres id for user syncs */
long st_lastspno; /* spno of last event */
struct ptab *st_ptab; /* ptr to owner's ptab (a/sync) */
struct ustab *st_ud; /* ptr to per-user details */
int st_nud; /* no of valid elements in st_ud */
int st_udlen; /* length of st_ud */
int st_flags; /* flags - see below */
struct synmsg st_synmsg; /* sync message data -
only SM_DUP and SM_TRUNC are used
in st_synmsg.sm_flags */
};
/* values for st_flags (a bit field) */
#define SF_ATTENTION 001 /* entry needs servicing */
#define SF_INPROGRESS 002 /* sync is in progress */
#define SF_OK 004 /* sync has happend successfully */
#define SF_ERR 010 /* sync has happend unsuccessfully */
#define SF_TIMEDOUT 020 /* proc timed out in sync event */
#define SF_USYNC 040 /* entry is a user sync, else auto */
/* short names for st_synmsg members */
#define st_smdata st_synmsg.sm_data
#define st_smlen st_synmsg.sm_dlen
#define st_smdlen st_synmsg.sm_mdlen
#define st_smsysid st_synmsg.sm_sysid
#define st_smspno st_synmsg.sm_spno
#define st_smflags st_synmsg.sm_flags
/* syncd server-specific process table data - pointed to by ptab.pt_sdata */
struct sptab {
struct stab *sp_stab; /* sync event being waited on */
long sp_timeout; /* timeout from sync request */
long sp_xrid; /* XRID used by this process */
};
/* extern function declarations */
extern void stadd PROTOLIST((struct stab *));
extern struct stab *stafind PROTOLIST((long));
extern struct stab *stalloc PROTOLIST((void));
extern void stcheck PROTOLIST((struct stab *));
extern void stfree PROTOLIST((struct stab *));
extern void strm PROTOLIST((struct stab *));
extern void stuend PROTOLIST((long, int));
extern struct stab *stufind PROTOLIST((long, struct ustab *, int));
extern int ustalloc PROTOLIST((struct stab *, int));
|
