Martin: /* See also */ Add cat

2022-03-23T11:17:10Z

Darya.zelenina: Created page with "'''$LCKPAG''', or '''Lock Pages in Memory''', is a system service that locks a page or range of pages in memory. =Description= The Lock Pages in Memory se..."

2019-07-24T16:12:26Z

Created page with "'''$LCKPAG''', or '''Lock Pages in Memory''', is a system service that locks a page or range of pages in memory. =Description= The Lock Pages in Memory se..."

New page

'''$LCKPAG''', or '''Lock Pages in Memory''', is a [[System Service|system service]] that locks a page or range of pages in memory.

=Description=

The Lock Pages in Memory service locks a page or range of pages in memory. The specified virtual pages are forced into the working set and then locked in memory.

A locked page is not swapped out of memory if the working set of the process is swapped out. These pages are not candidates for page replacement and in this sense are locked in the working set as well.

If more than one page is being locked and you need to determine specifically which pages were previously locked, the pages should be locked one at a time. If an error occurs while the $LCKPAG service is locking pages, the return array, if requested, indicates the pages that were successfully locked before the error occurred. If no pages are locked, both longwords in the return address array contain the value –1.

On [[Alpha]] and [[I64|Integrity]] systems, if you are attempting to lock executable code, you should issue multiple $LCKPAG calls: one to lock the code pages and others to lock the linkage section references into these pages.

=Syntax=

<nowiki>SYS$LCKPAG </nowiki>[[#inadr|inadr]]<nowiki> ,[</nowiki>[[#retadr|retadr]]<nowiki>] ,[</nowiki>[[#acmode|acmode]]<nowiki>]</nowiki>

C Prototype:

int sys$lckpag (struct _va_range *inadr, struct _va_range *retadr, unsigned
int acmode);

=Arguments=

==inadr==
{{SyservArgument|address_range|longword (unsigned)|read only|by reference}}

Starting and ending virtual addresses of the range of pages to be locked. The inadr argument is the address of a 2-longword array containing, in order, the starting and ending process virtual addresses. Only the virtual page number portion of each virtual address is used; the low-order byte-within-page bits are ignored.

On [[VAX]] systems, if the starting and ending virtual addresses are the same, a single page is locked.

==retadr==
{{SyservArgument|address_range|longword (unsigned)|write only|by reference}}

Starting and ending process virtual addresses of the pages that $LCKPAG actually locked. The retadr argument is the address of a 2-longword array containing, in order, the starting and ending process virtual addresses.

==acmode==
{{SyservArgument|access_mode|longword (unsigned)|read only|by value}}

Access mode to be associated with the pages to be locked. The acmode argument is a longword containing the access mode. The [[$PSLDEF]] macro defines the four access modes.

The most privileged access mode used is the access mode of the caller. For the $LCKPAG service to complete successfully, the resultant access mode must be equal to or more privileged than the access mode already associated with the pages to be locked.

=Condition Values Returned=
{| class="wikitable"
! colspan="col" | Value
! colspan="col" | Description
|-
| SS$_WASCLR
| The service completed successfully. All of the specified pages were previously unlocked.
|-
| SS$_WASSET
| The service completed successfully. At least one of the specified pages was previously locked.
|-
| SS$_ACCVIO
| The input array cannot be read; the output array cannot be written; the page in the specified range is inaccessible or nonexistent; or an attempt to lock pages was made by a caller whose access mode is less privileged than the access mode associated with the pages.
|-
| SS$_LCKPAGFUL
| The system-defined maximum limit on the number of pages that can be locked in memory has been reached.
|-
| SS$_LDWSETFUL
| The locked working set is full. If any more pages are locked, not enough dynamic pages will be available to continue execution.
|-
| SS$_NOPRIV
| The process does not have the privilege to lock pages in memory.
|-
| SS$_PAGOWNVIO
| The pages could not be locked because the access mode associated with the call to $LCKPAG was less privileged than the access mode associated with the pages that were to be locked.
|}

=Required Access or Privileges=
The calling process must have PSWAPM privilege to lock pages into memory.

=Required Quota=
None

=See also=
* [[$ULKPAG]]
* [https://support.hpe.com/hpsc/doc/public/display?docId=emr_na-c04621447 OpenVMS Programming Concepts Manual]

← Older revision		Revision as of 11:17, 23 March 2022
Line 77:		Line 77:
	* [[$ULKPAG]]		* [[$ULKPAG]]
	* [https://support.hpe.com/hpsc/doc/public/display?docId=emr_na-c04621447 OpenVMS Programming Concepts Manual]		* [https://support.hpe.com/hpsc/doc/public/display?docId=emr_na-c04621447 OpenVMS Programming Concepts Manual]

			[[Category:System Services]]

$LCKPAG - Revision history

Martin: /* See also */ Add cat

Darya.zelenina: Created page with "'''$LCKPAG''', or '''Lock Pages in Memory''', is a system service that locks a page or range of pages in memory. =Description= The Lock Pages in Memory se..."