HP Visualize J5000 hp workstations - hp-ux 10.20 graphics administration guide - Page 37

Enabling and Disabling of SMT, Begin Note for Programmers, Only for R5 Applications

Get HP Visualize J5000 - Workstation PDF manuals and user guides View all HP Visualize J5000 manuals
Add to My Manuals
Save this manual to your list of manuals

Page 37 highlights

Enabling and Disabling of SMT The special value of 0 for Region Size specifies that SMT is to be disabled. Disabling SMT removes it from the Xserver causing it not to be available for any transports. Any non-zero Region Size enables SMT on the Xserver. The default Region Size for a diskless Xserver is zero (disabling SMT from the Xserver) to minimize the access of files across the network. The default Region Size for non-siskless Xserver is 100000 (which is rounded to 0x19000). Begin Note for Programmers: X Applications which call fork(), and access the same display structure from both the parent and the child cannot be expected to operate reliably without extreme care (if at all), whether or not SMT is used. However, SMT is more sensitive to this than UDS. The problem is quite similar to stdio, where fflush() must be used to assure that data makes it from the buffer onto the file exactly once. Similarly to stdio's use of fflush(), XFlush() (not _XFlush()) must be called immediately before any fork() call that will be accessing the display from both the parent and child, as well as any time control is transferred between the parent and child, or vice-versa. (Calls to fork() which immediately do an exec() are not a problem.) The SMT library code attempts to detect improper use of display connections after a fork, and issues a warning at runtime. However, not all such usages can be detected. Symptoms include reporting the error, and hanging applications. Also, because the parent and child might read from the same display connection (either replies or events) the library can detect inconsistent sequence numbers, which it will report. It will attempt to recover from such errors, but depending on what the application has done, recovery cannot always be successful. Only for R5 Applications SMT requires a change to an internal interface with the X library. In theory, no application should be calling this interface, but some applications, including at least one X test suite, are known to call it. The interface is _XConnectDisplay. Applications using it directly may not be able to use SMT for the display specified, and must add an extra (ninth) parameter, which is the address of an integer: int dummy; _XConnectDisplay(..., &dummy); Symptoms include both damaged data and core dumps. (There was an earlier HP Shared Memory Transport, which this one replaces. It used the same parameter, so it may be the case that any such calls have already been fixed.) This problem does not occur in the R6 library. End Note for Programmers Page 37 Graphics Administration Guide for HP-UX 10.20

  • 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
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
Enabling and Disabling of SMT
The special value of 0 for Region Size specifies that SMT is to be disabled. Disabling SMT removes it
from the Xserver causing it not to be available for any transports. Any non-zero Region Size enables
SMT on the Xserver. The default Region Size for a diskless Xserver is zero (disabling SMT from the
Xserver) to minimize the access of files across the network. The default Region Size for non-siskless
Xserver is 100000 (which is rounded to 0x19000).
____________________________________________________________________________________
Begin Note for Programmers:
X Applications which call
fork()
, and access the same display structure from both the parent and the
child cannot be expected to operate reliably without extreme care (if at all), whether or not SMT is used.
However, SMT is more sensitive to this than UDS.
The problem is quite similar to stdio, where fflush()
must be used to assure that data makes it from the buffer onto the file exactly once.
Similarly to stdio's use of
fflush()
,
XFlush()
(not
_XFlush()
) must be called immediately before any
f
ork()
call that will be accessing the display from both the parent and child, as well as any time control is
transferred between the parent and child, or vice-versa. (Calls to
fork()
which immediately do an
exec()
are not a problem.)
The SMT library code attempts to detect improper use of display connections after a fork, and issues a
warning at runtime. However, not all such usages can be detected. Symptoms include reporting the
error, and hanging applications.
Also, because the parent and child might read from the same display connection (either replies or
events) the library can detect inconsistent sequence numbers, which it will report. It will attempt to
recover from such errors, but depending on what the application has done, recovery cannot always be
successful.
Only for R5 Applications
SMT requires a change to an internal interface with the X library. In theory, no application should be
calling this interface, but some applications, including at least one X test suite, are known to call it. The
interface is
_XConnectDisplay
. Applications using it directly may not be able to use SMT for the display
specified, and must add an extra (ninth) parameter, which is the address of an integer:
int dummy;
_XConnectDisplay(..., &dummy);
Symptoms include both damaged data and core dumps.
(There was an earlier HP Shared Memory Transport, which this one replaces. It used the same
parameter, so it may be the case that any such calls have already been fixed.)
This problem does not occur in the R6 library.
End Note for Programmers
____________________________________________________________________________________
Graphics Administration Guide for HP-UX 10.20
Page 37