_WIRE - wire page(s), if necessary.

(GCOS8 only)

Usage:

#include <climb.h>
_wire(ptr, nbytes);

Where:

void *ptr;
points to the beginning of the area of memory that you want to wire.
int nbytes;
is the number of bytes in that area of memory.

Description:

"_wire" wires one or more pages into memory, if the pages have not already been wired.

You may call "_wire" several times to wire the same set of pages. The function only wires the pages physically the first time you call it; after that, it increments a count of how often the pages have been wired.

Calls to the companion function "_unwire" decrement the same count. When the count reaches zero, "_unwire" physically unwires the pages.

Copyright © 1996, Thinkage Ltd.