On Alpha and Integrity server systems, allows a process to map
a section of its address space to a specified physical address
range represented by page frame numbers. This service creates and
maps a private page frame section.
This service accepts 64-bit addresses.
Format
SYS$CRMPSC_PFN_64 region_id_64 ,start_pfn ,page_count ,acmode
,flags ,return_va_64 ,return_length_64
[,start_va_64]
C Prototype
int sys$crmpsc_pfn_64 (struct _generic_64 *region_id_64,
unsigned int start_pfn, unsigned
int page_count, unsigned int
acmode, unsigned int flags, void
*(*(return_va_64)), unsigned __int64
*return_length_64,...);
1 – Arguments
region_id_64
OpenVMS usage:region identifier
type: quadword (unsigned)
access: read only
mechanism: by 32- or 64-bit reference
The region ID associated with the region to map the private page
frame section. The file VADEF.H in SYS$STARLET_C.TLB and the
$VADEF macro in STARLET.MLB define a symbolic name for each of
the three default regions in P0, P1, and P2 space.
The following region IDs are defined:
Symbol Region
VA$C_P0 Program region
VA$C_P1 Control region
VA$C_P2 64-bit program region
Other region IDs, as returned by the $CREATE_REGION_64 service,
can be specified.
start_pfn
OpenVMS usage:page frame number
type: longword (unsigned)on Alpha, quadword (unsigned) on
Integrity servers
access: read only
mechanism: by value
The CPU-specific page frame number where the section begins in
memory.
page_count
OpenVMS usage:CPU-specific page count
type: longword (unsigned) on Alpha, quadword (unsigned)
on Integrity servers
access: read only
mechanism: by value
Length of the page frame section in CPU-specific pages.
acmode
OpenVMS usage:access_mode
type: longword (unsigned)
access: read only
mechanism: by value
Access mode that is to be the owner of the pages created during
the mapping. The acmode argument is a longword containing the
access mode.
The $PSLDEF macro in STARLET.MLB and the file PSLDEF.H in
SYS$STARLET_C.TLB define the following symbols and their values
for the four access modes:
Value Symbolic Name Access Mode
0 PSL$C_KERNEL Kernel
1 PSL$C_EXEC Executive
2 PSL$C_SUPER Supervisor
3 PSL$C_USER User
The most privileged access mode used is the access mode of the
caller. The calling process can delete pages only if those pages
are owned by an access mode equal to or less privileged than the
access mode of the calling process.
Address space cannot be created within a region that has a create
mode associated with it that is more privileged than the caller's
mode. The condition value SS$_IVACMODE is returned if the caller
is less privileged than the create mode for the region.
flags
OpenVMS usage:mask_longword
type: longword (unsigned)
access: read only
mechanism: by value
Flag mask specifying the characteristics of the private section
to be created. The flags argument is a longword bit vector in
which each bit corresponds to a flag. The $SECDEF macro and the
SECDEF.H file define a symbolic name for each flag. You construct
the flags argument by performing a logical OR operation on the
symbol names for all desired flags.
The following table describes each flag that is valid for the
$CRMPSC_PFN_64 service:
Flag Description
SEC$M_ARGS64 Indicates that all parameters, specifically
start_pfn and page_count, are passed as 64-bit
numbers. This flag is ignored on OpenVMS Alpha
but must be set on Integrity server systems. If
the flag is not set on Integrity servers, the
error code SS$_IVSECFLG is returned.
SEC$M_EXPREG Pages are mapped into the first available space
at the current end of the specified region.
SEC$M_NO_ Pages cannot overmap existing address space.
OVERMAP By default, pages can overmap existing address
space.
SEC$M_PFNMAP Pages form a page frame section. By default, this
flag is always present in this service and cannot
be disabled.
SEC$M_ Flag that must be set when a PFN-mapped section
UNCACHED is created if this section must be treated
as uncached memory. Flag is ignored on Alpha
systems; it applies only to Integrity server
systems.
SEC$M_WRT Pages form a read/write section. By default,
pages form a read-only section.
All other bits in the flags argument are reserved for future
use by VSI and should be specified as 0. The condition value
SS$_IVSECFLG is returned if any undefined bits are set or if
an invalid combination of flags is set.
return_va_64
OpenVMS usage:address
type: quadword address
access: write only
mechanism: by 32- or 64-bit reference
The lowest process virtual address into which the private page
frame section was mapped. The return_va_64 argument is the 32- or
64-bit virtual address of a naturally aligned quadword into which
the service returns the virtual address.
return_length_64
OpenVMS usage:byte count
type: quadword (unsigned)
access: write only
mechanism: by 32- or 64-bit reference
The length of the virtual address range mapped. The
return_length_64 argument is the 32- or 64-bit virtual address
of a naturally aligned quadword into which the service returns
the length of the virtual address range in bytes.
start_va_64
OpenVMS usage:address
type: quadword address
access: read only
mechanism: by value
The starting virtual address to map the private page frame
section. The specified virtual address must be a CPU-specific
page aligned address. If the flag SEC$M_EXPREG is specified, the
start_va_64 argument must not be specified or must be specified
as 0. If SEC$M_EXPREG is set and the start_va_64 argument is
nonzero, the condition value SS$_IVESCFLG is returned.