This is in interim update to the current edition of this book published
by the ITSO. It is available in on-line form only.
The following is a summary of the amendments included in this edition. Volume
and Page number references refer to the original printed edition (SG24-4640-00).
Vol1 Page 31, 1.10 Exceptions
Change heading of
exception table to say # instead of TRAP
Vol1 Page 196, The Kernel Semaphore (KSEM)
Add
an additional comment about Event KSEMs.
Vol1 Page 338 ,Vol2 Page 274, Glossary
Re-worded
glossary entry for BMP.
Vol1 Page 350 ,Vol2 Page 287, Glossary
Added
references to Vol 4 in VMKH entry.
Vol1 Page 350 ,Vol2 Page 287, Glossary
Re-worded
glossary entry for UVIRT.
Vol2 Page 53, 2.2 Dump Decompression
DCOMP
added to DF user guide.
Vol2 Page 170, 3.4.5.6 Physical Device Driver Header
Corrected
.D DEV note about DevInt
Vol2 Page 198 .MA - Format Memory Arena Records
Added
description of hashing table.
Vol2 Page 227, 3.4.17.1 Idle PFs and 3.4.17.2 Free PFs
Clarify
description of how to locate idle and free PFs.
Vol2 Page 251, 3.4.21 .PB - Display Blocked Thread Information
Add
an additional comment about Event KSEMs.
Vol2 Page 261, 3.4.24 Display User's Registers
.R
command EI flag should read DI flag when bit 9 is 0 for Flag register bit
mnemonics.
Vol2 Page 266, 3.4.26 .S - Set or Display Default Thread Slot
.S,
command S option edited.
Vol4 Pages 27 and 32, 2.8.4 LogGetEntries
Removed
references to LogGetEntries. This API is not supported.
Vol4 Page 49, 3.2.2 System Anchor Segment (SAS)
Correct
offsets in SAS base section and inserted length field for SAS_Info_Data.
Vol4 Page 52 VMBH BMP Header Structure
Structure
added to miscellaneous section
Vol4 Pages 80, 82, 83, and 88
Amended VMAR,
VMAL, PF and VP structures to show correct layout of bit fields. Added pf_block
to PF structure.
Vol4 Pages 88
Kernel Heap Structures added.
Vol4 Page 184, 3.7.3 System File Table Entry for OS/2 Warp 3.0
Corrected
SFT length of sft_sfi and offsets of fields following.
Vol4 Page 210, 3.8.3 PDD IRQ Information Blocks
Corrected
title of PDD IQR to PDD IRQ
Vol4 Page 245, 4.4 Standard GDT Assignments
Deleted
note at end of table. Added new note before table.
Vol4 Page 280, 4.9 OS/2 FixPak to Build Level Cross-Reference.
Corrected
build levels for Warp GA, Connect and title of 8.200
Vol4 Page 210, 3.8.3 PDD IRQ Information Blocks
Corrected
VMOwner info for DIRQ and IRQI.
Interim update 0.2
Vol1 Page 101, Predefined Dynamic Trace Events
Vol1 Page 103, TRCUST, The Dynamic Trace Customizer
Vol1 page 130, DosEnterCriticalSection ....
'crt'
state is incorrectly described.
Vol1 page 134, The Dispatcher, Priorities and Dispatching Classes
Added
note at end of section on running in the kernel and device drivers.
Vol1 Page 135, The Status of a Thread
'crt'
state is corrected.
Vol1 Page 137, A Form for Unwinding Stacks
Removed
from INF version.
Vol1 page 202, Involuntary Suspension
Critical
Section: typo, helped should read held.
Vol1 page 202, Involuntary Suspension
Pre-emption:
added note about kernel mode.
Vol1 page 308, How to find the MQ of any Thread
AAB
at TLMA offset +0x8 (not +0xc)
Vol1 page 308, How to find the MQ of any Thread
Expanded
note at the bottom of the page.
Vol1 page 317, Finding the System Queue
Current
read pointer should be offset +0x0c (not +0x0e).
Vol2 Page 126, Q Command
Typos: cases->causes,
memu-> menu
Vol2 Page 129, 3.4.24 Display User's Registers
R
command NV flag value should be 0.
Vol2 Page 255, .PQ Scheduler Priority Queues
._ptcbPriQRunner
should say 'run' state
Vol2 Page 261, 3.4.24 Display User's Registers
.R
command NV flag value should be 0.
Vol3 Page 45, Major Code Assignments
MONCALLS
separately listed
Vol3 Page 218-245, PMSHAPI
Obsolete tracepoints
removed.
Vol4 Page 188, Record Lock Record for OS/2 Warp V3.0
GDT_FSC
should read GDT_RLR
Vol4 Page 88, Virtual Page Structure
vpf_s
type should be S and vp_flink type should be D.
Interim update 0.3
Vol1 Pages 245 14.1.2.1 Who Owns Virtual Memory and Who Allocated it?
Correct
typographic error: pseud-objects -> pseudo-object (on-line version only)
Vol2 Page 80, List of Internal Commands
.L
should read L (printed edition only)
Vol2 Page 52 Dump Formatter Installation
In
printed copy only, Note: DF&US.RET.EXE and DF&US.DEB.EXE should
read df_ret.exe and df_deb.exe
Vol2 Page 214 3.4.16.2 Pseudo-Object Records
Correct
typographic error in Notes: (psuedo)
Vol2 Pages 226 3.4.17.1 Free Page Frame Structures
Correct
typographic error in Notes: (psuedo)
Vol2 Pages 227 3.4.17.2 Idle Page Frame Structures
Correct
typographic error in Notes: (psuedo)
Vol3 Page 17 RETEP
Note added about modern
C compilers.
Vol3 Page 5
Note added following first paragraph.
Vol3 Page 45 3.4 Trace Major and Minor Code Assignments
Table
extended to include major codes reserved for other components.
Vol4 Pages 9 and 10, 2.1.2 DevHlp_SysRAS
References
to DevHlp_SysTrace and DevHlp_SysRAS should read DevHlp_RAS.
Vol4 Page 14 2.2.1 Trace Buffer Structures
CHECK
KEY: filed->field, Exclusively starts with Upper case E.
Interim update 0.4
Vol1 Page xx Acknowledgments
Vol1 Page 9 1.3.5.2 Descriptor Flags
Correct
definitions of bit 53 and 54
Vol1 Page 10 1.3.5.3 Descriptor Table Summary
Correct
VDM considerations for IDT and LDT
Vol1 Page 196 The Kernel Semaphore
Clarify
use of KSEM blockids
Vol1 Page 295 14.1.3.5
Added more useful PM
message queue and window symbols
Vol1 Page 342 Interrupt Descriptor Table
Added
information on VDM use of IDTs.
Vol1 Page 343 Local Descriptor Table
Added
information on VDM use of LDTs.
Vol2 Page 14 Forcing a System Dump from the Kernel Debugger
Add
.SYSDUMP command to first paragraph.
Vol2 Page 17-18 Forcing a System Dump from the Kernel Debugger
Add
RegSA for Pentium processor support.
Vol2 Page 41 1.5 Kernel Debugger Breakpoints
Update
XCPTBuildR3DispatcherStack
Vol2 Page 41 1.5 Kernel Debugger Breakpoints
Add
DOS32R3EXCEPTIONDISPATCHER
Vol2 Page 45-46 1.6 Exception Logic
Correct
information about local exception handlers used by the system and the exception
handling logic. Add details of Dos32R3ExceptionDispatcher and Dos32ExceptionCallBack.
Vol2 Page 48 1.6.2 Excepton Handling - Overview diagram
DosRaiseException
flow corrected. Dos32ExceptionDispatcher
Vol2 Page 86-87 3.3.6 BL command
Update for
I/O breakpoints.
Vol2 Page 89 3.8.8 BR
Vol2 Page 99 3.3.17.1 Descriptor formats Table 4
Clarify
BIG C32 definitions
Vol2 Page 105 3.3.20.1 DP command
Add note
about invalidity of PDEs under DF.
Vol2 Page 127 3.3.35.1 R command
Add note
about addressing mode.
Vol2 Page 127 - 129 3.3.35.1 R command
Remove
reference to 24-bit registers and move GDTB and IDTB to 32-bit registers.
Vol2 Page 128 3.3.35.1 R command
Add CR4 to
32-bit reg syntax diagram
Vol2 Page 131 3.3.35.1 R command
Add note
on CR4 and correct 32-bit register
Vol2 Page 137 3.3.38 U command
Add note about
V8086 mode addressing.
Vol2 Page 147 External Commands
Vol2 Page 147 External Commands
Vol2 Page 148 3.4.1 .? command
Vol2 Page 161 3.4.5.11 .D
typo in warning
formate->format
Vol2 Page 161 3.4.5 .D
Note added about <512
byte segments
Vol2 Page 167 3.4.5.5 figure 33
Vol2 Page 168 3.4.5.5 figure 33
Add note about
KSEM blockids
Vol2 Page 174 3.4.5.8 .D MFT
Note added about
ALLSTRICT kernel
Vol2 Page 196 .M
Added note about defaults
for FP29 and V4
Vol2 Page 182 3.4.5.11 .D SEM32 etc..
pNname
typo corrected no->not
Vol2 Page 190 3.4.1 .lm command
Added I option.
Updated Note. Update Results and Notes.
Vol2 Page 204 .MC
Vol2 Page 205 .MC
Added additonal note about
early versions of DF
Vol2 Page 207 .MK
Updated warning about freed
memory.
Vol2 Page 210 .ML Results and Notes
Updated
note about the need for kernel symbols
Vol2 Page 213 .MO Results and Notes
Added
note about hmte use and interpretation.
Vol2 Page 225 .MP Syntax
Added I option and
clarified syntax.
Vol2 Page 226 .MP R and L option Warnings.
Updated
warnings for use of R and L
Vol2 Page 230 .MV R and L option Warnings.
Updated
warnings for use of R and L
Vol2 Page 237 .O command
Vol2 Page 247 .PB Sta
Vol2 Page 250 .PB Notes:
Updated note on ChildWait.
Vol2 Page 258 3.3.35.1 .R command
Add note
about addressing mode.
Vol2 Page 266 .SYSDUMP
Vol4 Page 41 and 89, 3.0 and 3.5 Scheduler control blocks
ljmp
structure added to list of scheduler structures.
Vol4 Page 96 3.5.1.7 Excepton Handling - Overview diagram
DosRaiseException
flow corrected. Dos32ExceptionDispatcher replaced _xcptExceptionDispatcher.
Vol4 Page 125 long-jump buffer
Interim update 0.5
Introduction to the current edition
Vol1 Page 103 Chapter 8 TRCUST The Dynmaic Trace Customizer
Remove
duplicate chapter from volume 1
Vol1 Page 81 5.6.1.1 How to find the TSS
Add
additional fields to the TSS
Vol1 Page 129 11.1.2 Multiprocessor Methods - Spin Locks
Correct
formatting error in note about LOCK prefix.
Vol1 Page 142, 13.1.1.1 Address Space Arenas and Regions
Add
note about Protected Region post FP19 Warp 3.0
Vol1 Page 143, 13.1.1.1 Address Space Arenas and Regions
Add
note about Packed Region post FP19 Warp 3.0
Vol1 Page 255,256 Exploring Memory Management, Private Arena private
data Vol1 Page 260, Exploring Memory Managenent, Finding
Who Owns Memory
Note about .mam after 3.0 FP29
and 4.0 GA
Vol1 Page 322, 14.1.4.1 Ring 0 Loop Dump Analysis Example
Add
note about fsd and dd system owners after 3.0 FP29 and 4.0 GA
Vol2 Page 1, Kernel Debugger User Guide
Added
up to date URL and FTP information.
Vol2 Page 46, 1.6 Trap and Exceptions Processing
Added
information about VSU and clarified DelayHardError.
Vol2 Page 46, 1.6 Trap and Exceptions Processing
Added
exception handler return code values.
Vol2 Page 50, 1.6.4 Intercepting Exceptions and Traps
Added
information about VSU.
Vol2 Page 139. 3.3.39 Exception/Trap/Fault Vector Commands
Added
information about VSU.
Vol2 Page 140. 3.3.39 Exception/Trap/Fault Vector Commands
Added
information about VSU.
Vol2 Page 140. 3.3.39 Exception/Trap/Fault Vector Commands
Vol2 Page 217-219 .MO command
Clarification
of own and hmte fields. Remove 'main' from expression 'main
executable' in the 'description' section. Add note about System Owner Ojects
on page 219 for 3.0 FP29 and 4.0 GA.
Vol2 Page 219 System Object Ids.
Clarification
of use of system object Ids.
Vol3 Page 5 TRCUST reference
Update notes
on restrictions.
Vol3 Page 13 2.2.2 TSF Header
Add note about
modname requirements
Vol3 Page 14 2.2.2 TSF Header
Add node on
major code range.
Vol3 Page 14 2.2.2 TSF Header
Add node on
maxdatalength default and range.
Vol3 Page 20 2.2.5.7 FMT Keyword
Vol3 Page 21 2.2.5.7 FMT Keyword
Vol3 Page 21 2.2.5.7 FMT Keyword
Add %C formatting
control
Vol3 Page 21 2.2.5.7 FMT Keyword
Vol3 Page 22 2.2.5.7 FMT Keyword
Update use
of %U and dump format
Vol3 Page 31 2.3 Formatting Trace Data
Vol3 Page 45 3.4 Trace Event Major and Minor Code Assignment
Vol3 Page 163 Resource Manager Tracepoints
Vol3 Page 217 Multi-Media Extensions Tracepoints
Vol4 Page 70 Virtual Address Space Regions.
Add
diagrams for OS/2 V2.11 and OS/2 Warp V4.0
Vol4 Page 98 Thread Control Block for OS/2 Warp V4.0
Vol4 Page 125 Per-Task Data Area for OS/2 Warp V4.0 ALLSTRICT kernel
Add OS/2 Warp V4.0 ALLSTRICT kernel ptda
Vol4 Page 131 Per-Task Data Area for OS/2 Warp V4.0 RETAIL kernel
Add
OS/2 Warp V4.0 RETAIL kernel ptda
Vol4 Page 167 Swappable Module Table Entry for OS/2 Warp V4.0
Vol4 Page 117 3.7.1.5 Anonymous and Named Pipes
Update
diagram to show instances of named pipes.
Vol4 Page 199 3.7.10 Named Pipe Structures for OS/2 Warp V3.0
Add
pointer information about instances of named pipes.
Vol4 Page 237 System exceptions.
Add note
about XCPT_PROCESS_TERMINATE
Vol4 Page 243 4.3 Trap Screen Reference - System Internal Processing
Error.
Clarified line number info in an IPE.
Vol4 Page 244 4.3 Trap Screen Reference
Correct
typo formatter -> formatted.
Vol4 Page 244 4.3 Trap Screen Reference
Vol4 Page 249 VM System Object Owber Ids.
Clarification
of use of system object Ids.
Vol4 Page 255 4.7 DevHlp Function Cross-Reference.
Remove
duplicate DevHlp_DevDone
Vol4 Page 256 4.7 DevHlp Function Cross-Reference.
Add
new DevHlps for SMP and the Security feature.
Vol4 Page 280 4.8 Fix Pack to Build Level Cross-Reference.
Updated
for more recent fix packs and OS/2 Warp V4.0
Interim update 0.6
Vol1 Page 27 1.8.6 System Flags
Add reference to
the EFLAGS register.
Vol1 Page 99 7.2 TRACE and TRACE Processing
Add
note about dynmaic tracepoints
Vol1 Page 210 13.1.2.3 Priority Inverion
Reword
last 5 paragraphs.
Vol1 Page 344 Glossary
Vol2 Page 17-18 Forcing a System Dump from the Kernel Debugger
Correct
offset on RegSA for CR4.
Vol2 Page 89 3.8.8 BR
Add note about I/O breakpoint
address specification.
Vol2 Page 89 3.8.8 BR
Add note about I/O breakpoint
bug.
Vol2 Page 206 3.4.14 .MK Display Memory Lock Information Records
Add
note about HSTRICT kernel.
Vol2 Page 208 3.4.14 .MK Display Memory Lock Information Records
Add
note about the use of cs and eip for 16-bit callers.
Vol2 Page 231 3.4.18.1 Free Virtual Page Structures
Vol2 Page 267 2.4.27 .T Dump the System Trace Buffer
Add note about suspending the trace from the kernel
debugger console.
Vol4 Pages 69 & 80 Memory Management Control Block Reference
Added
Physical Arena Information structures.
Vol4 Page 98 Thread Control Block for OS/2 Warp V4.0
OS/2
Warp V4.0 tcb was not added correct by #0.5
Vol4 Page Page 238 4.2 OS/2 System Exception Codes
Add
XCPT_UNKNOWN_ACCESS to P2 = -1 for XCPT_ACCESS_VIOLATION.
Interim update 0.7
Vol1 page 127 10.2 Steps to Diagnose a Loop
Typo
in online version: threas-> threads
Vol1 page 129 11.1.2 Multiprocessor Methods - Spin Locks
Typo
in online version: .Exchange -> Exchange
Vol1 page 130 11.1.3 DosEnterCriticalSection and DosExitCriticalSection
Reword second sentence for better understanding.
Vol1 page 147 13.1.1.2 Virtual Address Space Management
Add
_ahvmhShr and correct label typos for _ahvmShr and _ahvmSys
Vol2 Page 45-46 1.6 Exception Logic
Add parameter
information for _XCPTBuildR3DispatcherStack.
Vol2 Page 190s and 192 3.4.10 .LM - Format Loader Structures
Add
references to RASKDATA.
Vol2 Page 206 3.4.14 .MK - Display Memory Lock Information Records
Add references to RASKDATA.
Vol2 Page 247 .PB BlockId
Vol3 page 5 TRCUST Reference
Added information
on latest system trace tools.
Vol3 page 5 TRCUST Reference
Updated note
on dynamic trace restrictions
Vol3 page 7-8 1.2.1 Invoking the Trace Customizer
Updated
syntax diagram and description for TRCUST 3.06
Added /D, /L, /NODE, /NOLN, /RM, /RS, /I, /P, /PREINV, /RAS
Vol3 page 8 2.1.3.1 Source Level Symbolic Support
Updated
information on supported compilers and added reference to VisulAge and DEDEL.
Vol3 page 9 2.1.3.2 MAP File Support
Vol3 page 9 2.1.3.3 Building a Module
Added
reference to DEBDEL
Vol3 page 11 2.1.2 TDF and TFF File Usage
Added
references to latest tools (DTRACE, TRACEGET, TRSPOOL, TRACE /Q)
Vol3 page 13 2.2.2 TSF Header
Added TDFID
and changed MAJOR to be optional.
Vol3 page 13 2.2.2 TSF Header
Updated major
code range for RAS Enhancements
Vol3 page 14 2.2.3 Typelist Definition
Clarified
use of TYPELIST
Vol3 page 14 2.2.4 Grouplist Definition
Clarified
use of GROUPLIST
Vol3 page 15 2.2.5 Tracepoint Definition
Added
new RETEP options to syntax.
Vol3 page 16 2.2.5.1 MINOR Keyword
Vol3 page 16 2.2.5.2 TP Keyword
Clarified
use of @STATIC. Referenced MAKETSF. Refereced /PREINV. Updated RETEP description
for new sub-keywords. Corrected invalid opcode list.
Vol3 pages 20-22 2.2.5.7 FMT Keyword
Clarified
use of %P, %C, %U. Added note on TRACEFMT dump format. Clarified not for
CMVC users.
Vol3 page 28 2.2.5.15 Address Specification
Added
note about /I and name length limitations.
Vol3 page 28 2.2.5.15 Address Specification - Flat Register Form
Updated
32-bit register lists.
Vol3 page 29 2.2.5.15 Address Specification - Segmented Register Form
Updated 16-bit register lists. Clarify use or R
prefix.
Vol3 page 31 2.3 Formatting Trace Data
Clarify
use of %P and %R. Add details of pefix format.
Vol3 pages 38 2.5.1 External Messages
Remove
this section. These messages are not generated.
Vol3 pages 39-42 2.5.2 Internal Messages
Rename
section and add new messages for TRCUST 3.06
Vol3 page 44 3.2 Group Qualifiers
Vol3 page 44 3.3a DosXxxx API Pre-invocation Tracepoints
Added
section describing return addresses.
Vol3 page 45 3.4 Major Code Cross-Reference
Vol3 page 55 3.4.7 Kernel Services Trace Events
Vol3 page 96 3.4.9 Kernel Services Trace Events
Add
tracepoints for the following APIs:
Dos32CancelLockRequest
Dos32SetFileLocks
Dos32ProtectSetFileLocks
DosCreateSpinLock
DosAcquireSpinLock
DosReleaseSpinLock
DosFreeSpinLock
Dos32IProtectRead
Dos32IProtectWrite
Correct the following tracepoints:
Dos32PMPostEventSem
Dos32PMWaitMuxWaitSem
Dos32PMWaitEventSem
Vol3 page 97 3.4.7 OS2KRNLD Trace Events
Remove
this section since identical with OS2KRNLR
Vol3 page 164 3.4.21 DOSCALL1.DLL Trace Events
Vol3 page 168 3.4.21 DOSCALL1.DLL Trace Events
Added
parameters to Dos32RaiseException, DosFsSemClear and DosFsSemRequest.
Vol3 page 168 and 170 3.4.21 DOSCALL1.DLL Trace Events
Added
Dos32R3ExceptionDispatcher, Dos32ExceptionCallBack, xcptExecuteExeceptionHandler,
UT16_RETURN and UT32_RETURN tracepoints.
Vol3 page 209 3.4.30 QUECALLS.DLL Trace Events
Vol3 page 209 3.4.33 SESMGR.DLL Trace Events
Vol3 page 203 3.4.28 OS2CHAR.DLL Trace Events
Added
CharBuffer to KbdStringIn Post-Invocation.
Vol3 page 345 3.4.51 PMGPIR Trace Events
Remove
this section since identical with PMGPI
Vol3 page 345 3.4.51 PMGPIR Trace Events
Remove
this section since identical with PMGPI
Vol3 page 382 3.4.54 PMGPID Trace Events
Remove
this section since identical with PMGPI
Vol4 page 1 Chapter 1 CONFIG.SYS RAS Commands
Change
title to CONFIG.SYS RAS Statements
Vol4 page 1 Chapter 1 CONFIG.SYS RAS Commands
Added
SCKILLFEATUREENABLED.
Vol4 page 1 Chapter 1 CONFIG.SYS RAS Commands
Vol4 page 2 1.2a RASKDATA
Inserted RASKDATA
section.
Vol4 page 2 1.3a SCKILLFEATUREENABLED
Inserted
SCKILLFEATUREENABLED.
Vol4 page 4 1.6 SUPPRESSPOPUPS
Updated for
SUPPRESSPOPUPS=0
Vol4 page 6 1.10 TRAPDUMP
Added PD parameter
and Ctrl-Alt-F10-F10 key sequence.
Vol4 page 6 1.10 TRAPDUMP
Added reference
to the TRAPDUMP command.
Vol4 page 7 1a Miscellaneous RAS Command Command Utilities
Added
new chapter to describe TRAPLOG, TRAPDUMP and SYSDUMP
Vol4 Page 52 VMBH BMP Header Structure
Structure
added more examples of BMP use.
Vol4 page 69 & 80 Memory Management Control Block Reference
Added
Per Arena Page Table Data (PGDATA)
Vol4 Page 88 VMKSH Structures
Fix swappable
heap header offsets.
Vol4 page 172 3.7 File System Block Reference
Vol4 page 242 4.3 Trap Screen Reference
Correct
wording of xSLIM descripton.
Vol4 Page 255 4.7 DevHlp Function Cross-Reference.
Correct
typo in DevHlp_RegisterDeviceClass
Vol4 Page 255 4.7 DevHlp Function Corss-Reference.
Added:
helper functions 0x7f - 0x83
Vol4 page 257 4.7a Device Driver Strategy Commands
Added
table to system cross-reference.
[Back: Trademarks]
[Next: Preface]