.I - Swap in Storage

Page in a TSD or a Page of Virtual Storage from the Swapper file.

Syntax:

────.I ─────┬──────────┬───────┬─────────── addr ─────────────
              │          ├── B ──┤
              │          └── D ──┘
              │
              │
              └── T ─────┬───────┬───────┬────────────┬─────────
                         ├── B ──┤       └─── slot ───┘
                         └── D ──┘

Parameters:

T

When specified it requests the Kernel Debugger page in the TSD for a specified thread slot.

One TSD is assigned to each thread slot. If the registers for an out-of-context thread need to be examined then it may be necessary to swap in the TSD for that slot, since the ring 3 stack frame is stored in the TSD when a thread enters the Kernel. The presence or absence of the TSD for a given slot may be deduced by the presence or absence of a value for the Disp field of the .P command.

If the T option is omitted it requests the Kernel Debugger page in the page of virtual storage that encompasses the specified addr.

B
When specified requests that all breakpoints be re-instated, including those which the current CS:EIP may be addressing.

This parameter is effectively obsolete since breakpoints at the current CS:EIP are correctly handled by the Breakpoint Commands.

D
Specifies that a page-in request be scheduled for the Kernel Debugger Daemon thread to execute. In most cases a page-in operation may be performed synchronously, but under the following conditions it is prohibited:
When an interrupt is being handled (that is, not at task time)
When a swapping operation is pending (TCBfswapping (TCB + 0x1a1) not 0)
When a the current thread is blocked (TK_WF_SLEEPING (0x40) is set in TCBWakeFlags (TCB + 0x162))
When in ring0 and InDos is 0
When one of these conditions occurs the page-in request may be scheduled for execution asynchronously by the Debugger Daemon thread by use of the D parameter. If the request is successfully scheduled the user is invited to enter the G command. The system will dispatch the Daemon thread, in time, which will attempt the page-in request. The Daemon returns control to the debug console using an INT 3 interrupt.

addr

This specifies the virtual address of the page to be paged in. The address is effectively rounded down to the nearest 4K page boundary.

Note: A selector:offset address specification can only be used if the selector does not reference the packed area of the LDT. If it does then a linear address must be supplied by the user.

slot
Specifies the thread slot number of the TSD to be paged in. The default slot is the current slot of the debugger's default slot if overridden with the .S command.

Results & Notes:

When an asynchronous page-in is requested the Kernel Debugger will prompt the user with one of the following:

task|addr %nnnn|%nnnnnnnn, LDT entry address %nnnnnnnn queued, G to continue


task|addr %nnnn|%nnnnnnnn queued, G to continue


TSD for slot s queued, G to continue

depending upon combination of parameters specified.

On successful completion of a synchronous page-in the user will be prompted with the command prompt.

If .I is unable to complete the request the OS/2 system error code will be displayed (in decimal) in the following message:

    OS/2 error code nt

refer to the Control Programming reference or to bseerr.h C header file for an interpretation of the error code.

---

[Back: 32-Bit Semaphore Structures (SEM32, OPENQ and MUXQ)]
[Next: .H - Display Dump File Header Information]