usr/src/man/man2/mmap.2
changeset 14241 573953c13d1a
parent 13504 5b2854ecc12d
equal deleted inserted replaced
14240:85f7bb2246ca 14241:573953c13d1a
     1 '\" te
     1 '\" te
       
     2 .\" Copyright 2013 OmniTI Computer Consulting, Inc. All Rights Reserved.
     2 .\" Copyright 1989 AT&T.  Copyright (c) 2009, Sun Microsystems, Inc.  All Rights Reserved.  Portions Copyright (c) 1992, X/Open Company Limited.  All Rights Reserved.
     3 .\" Copyright 1989 AT&T.  Copyright (c) 2009, Sun Microsystems, Inc.  All Rights Reserved.  Portions Copyright (c) 1992, X/Open Company Limited.  All Rights Reserved.
     3 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at
     4 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at
     4 .\" http://www.opengroup.org/bookstore/.
     5 .\" http://www.opengroup.org/bookstore/.
     5 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
     6 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
     6 .\"  This notice shall appear on any product containing this material.
     7 .\"  This notice shall appear on any product containing this material.
   201 .RS 17n
   202 .RS 17n
   202 Map initialized data segment.
   203 Map initialized data segment.
   203 .RE
   204 .RE
   204 
   205 
   205 .sp
   206 .sp
       
   207 .ne 2
       
   208 .na
       
   209 \fB\fBMAP_32BIT\fR\fR
       
   210 .ad
       
   211 .RS 17n
       
   212 Map to the lower 32 bits of address space.
       
   213 .RE
       
   214 
       
   215 .sp
   206 .LP
   216 .LP
   207 The \fBMAP_SHARED\fR and \fBMAP_PRIVATE\fR options describe the disposition of
   217 The \fBMAP_SHARED\fR and \fBMAP_PRIVATE\fR options describe the disposition of
   208 write references to the underlying object. If \fBMAP_SHARED\fR is specified,
   218 write references to the underlying object. If \fBMAP_SHARED\fR is specified,
   209 write references will change the memory object. If \fBMAP_PRIVATE\fR is
   219 write references will change the memory object. If \fBMAP_PRIVATE\fR is
   210 specified, the initial write reference will create a private copy of the memory
   220 specified, the initial write reference will create a private copy of the memory
   286 the system can choose a mapping size larger than the page size returned by
   296 the system can choose a mapping size larger than the page size returned by
   287 \fBsysconf()\fR. The \fBMAP_INITDATA\fR option should be used only by the
   297 \fBsysconf()\fR. The \fBMAP_INITDATA\fR option should be used only by the
   288 dynamic linker for mapping initialized data of shared objects.
   298 dynamic linker for mapping initialized data of shared objects.
   289 .sp
   299 .sp
   290 .LP
   300 .LP
       
   301 The \fBMAP_32BIT\fR option informs the system that the search space for
       
   302 mapping assignment should be limited to the first 32 bits (4 Gbytes) of the
       
   303 caller's address space.  This flag is accepted in both 32-bit and 64-bit
       
   304 process models, but does not alter the mapping strategy when used in a
       
   305 32-bit process model.
       
   306 .sp
       
   307 .LP
   291 The \fIoff\fR argument is constrained to be aligned and sized according to the
   308 The \fIoff\fR argument is constrained to be aligned and sized according to the
   292 value returned by \fBsysconf()\fR when passed \fB_SC_PAGESIZE\fR or
   309 value returned by \fBsysconf()\fR when passed \fB_SC_PAGESIZE\fR or
   293 \fB_SC_PAGE_SIZE\fR. When \fBMAP_FIXED\fR is specified, the \fIaddr\fR argument
   310 \fB_SC_PAGE_SIZE\fR. When \fBMAP_FIXED\fR is specified, the \fIaddr\fR argument
   294 must also meet these constraints. The system performs mapping operations over
   311 must also meet these constraints. The system performs mapping operations over
   295 whole pages. Thus, while the  \fIlen\fR argument need not meet a size or
   312 whole pages. Thus, while the  \fIlen\fR argument need not meet a size or