.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (c) 1996 Tom Bjorkholm <tomb@mydata.se>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"

.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
.\" 1996-04-11 Tom Bjorkholm <tomb@mydata.se>
.\"            First version written (1.3.86)
.\" 1996-04-12 Tom Bjorkholm <tomb@mydata.se>
.\"            Update for Linux 1.3.87 and later
.\" 2005-10-11 mtk: Added NOTES for MREMAP_FIXED; revised EINVAL text.
.\"
.\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
.\"         all rights reserved.
.\" Translated 1997-02-23, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\" Updated 2002-11-26, Kentaro Shirakata <argrath@ub32.org>
.\" Updated 2005-10-09, Kentaro Shirakata <argrath@ub32.org>
.\" Updated 2006-04-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.28
.\"
.\"WORD:	virtual memory		ۥ
.\"WORD:	remap			ƥޥåԥ
.\"WORD:	argument		
.\"WORD:	address space		ɥ쥹
.\"WORD:	page align		ڡ
.\"WORD:	linear			˥
.\"WORD:	process			ץ
.\"WORD:	segment			
.\"WORD:	real memory		¥
.\"WORD:	segmentation violation	ơ󿯳
.\"WORD:	segmentation fault	ơȿ
.\"WORD:	scheme			
.\"WORD:	implement		
.\"WORD:	lock			å
.\"
.TH MREMAP 2 2005-09-13 "Linux" "Linux Programmer's Manual"
.SH ̾
mremap \- ۥꡦɥ쥹ƥޥåԥ󥰤
.SH 
.nf
.B #define _GNU_SOURCE
.br
.B #include <sys/mman.h>
.sp
.BI "void *mremap(void *" old_address ", size_t " old_size ,
.BI "             size_t " new_size ", int " flags );
.fi
.SH 
.BR mremap ()
ϴ¸Υꡦޥåԥ󥰤γĥ (ޤϽ̾) Ԥ
Ʊ˰ư뤳Ȥ⤢
(\fIflags\fP Ѳǽʲۥɥ쥹֤ˤäƷޤ)

\fIold_address\fP ϳĥ (ޤϽ̾) 褦Ȥ벾ۥꡦ֥å
θΥɥ쥹Ǥ롣\fIold_address\fP ϥڡ˹äƤʤ
ʤʤդ뤳ȡ\fIold_size\fP ϸβۥꡦ֥å
Ǥ롣
\fInew_size\fP ׵᤹ѹβۥꡦ֥åΥǤ롣

Linux Ǥϥϥڡʬ䤵롣桼ץ (Ĥޤ)
ʣΥ˥ʲۥꥻȤġ
줾βۥꥻȤϰİʾμ¥ꡦڡ
˥ޥåԥ󥰤Ƥ (ޥåԥ󥰾ϥڡơ֥Ǵ)
ۥꥻȤˤϥݸ () ꤵƤꡢ
꤬˥줿 (㤨ɤ߹ѤΥȤ
񤭹)ơ󿯳 (segmentation violation) 
ޤȳβۥ˥ˤ
ơ󿯳ȯ롣

.BR mremap ()
 Linux Υڡơ֥Ѥ롣
.BR mremap ()
ϲۥɥ쥹ȥꡦڡΥޥåԥ󥰤ѹ롣˸ΨŪ
.BR realloc (3)
Τ˻ѤƤ롣

\fIflags\fP ӥåȥޥ 0 ޤϰʲΥե饰ޤ:
.TP
.B MREMAP_MAYMOVE
ǥեȤǤϡߤΰ֤˥ޥåԥ󥰤ĥ뤿
ʬʶʤ
.BR mremap ()
ϼԤ롣
Υե饰ꤵȡͥɬפХޥåԥ󥰤
ۥɥ쥹˺֤뤳ȤǤ
ޥåԥ󥰤֤ȡŤޥåԥ󥰰֤ؤХݥ󥿤
̵ˤʤ (ޥåԥ󥰤γϥɥ쥹ХեåȤͭΤޤޤǤ)
.TP
.BR MREMAP_FIXED " (Linux 2.3.31 ʹ)"
Υե饰
.BR mmap (2)

.B MAP_FIXED
ե饰Ȼ褦ŪѤ롣
Υե饰ꤵȡ
.BR mremap ()
 5 ܤΰ
.I "void *new_address"
ꡢΰϥޥåԥ󥰤ư٤ɥ쥹ꤹ롣
Υɥ쥹ϥڡ˹äƤʤФʤʤ
.I new_address

.I new_size
ǻꤵ륢ɥ쥹ϰϤ˲Υޥåԥ󥰤ä硢
Υޥåԥ󥰤ϥޥåפ (unmapped)
.B MREMAP_FIXED
ꤷϡ
.B MREMAP_MAYMOVE
ꤷʤФʤʤ
.PP
.I old_address

.I old_size
ǻꤵꥻȤ
.RB ( mlock (2)
ƱͤΤΤ) åƤ硢ȤΥѤä
֤줿ꤷ˥åݻ롣
η̡ץˤäƥå̤Ѳ롣
.SH ֤

.BR mremap ()
ϿۥΰؤΥݥ󥿤֤
顼ξ
.B MAP_FAILED
(ʤ \fI(void\ *)\ \-1\fP) ֤졢
\fIerrno\fP Ŭڤꤵ롣
.SH 顼
.TP
.B EAGAIN
ƤӽФåƤꥻȤĥ褦Ȥ
.B RLIMIT_MEMLOCK
꥽¤ۤˤԤȤǤʤ
.TP
.B EFAULT
֥ơȿ(segmentation fault)
\fIold_address\fP  \fIold_address\fP+\fIold_size\fP 
ϰϤΥɥ쥹Τɤ줫Υץˤʲۥꡦɥ쥹Ǥ롣
Ȥ׵ᤷɥ쥹Τޤ褦ʥޥåԥ󥰤äȤƤ⡢
Υޥåԥ󥰤ۤʤäʤ
.B EFAULT

.TP
.B EINVAL
ʰͿ줿
ǽΤ븶ϰʲ̤Ǥ:
Ƥ \fIold_address\fP ڡ
äƤʤ;
.I flags

.B MREMAP_MAYMOVE
ޤ
.B MREMAP_FIXED
ʳͤꤵƤ;
.I new_size
;
.I new_size
ޤ
.I new_address
ͤ;
.I new_address

.I new_size
ǻꤵ뿷ɥ쥹ϰϤ
.I old_address

.I old_size
ǻꤵŤɥ쥹ϰϤȽŤʤäƤ;
.B MREMAP_FIXED
ꤵƤ뤬
.B MREMAP_MAYMOVE
ꤵƤʤ
.TP
.B ENOMEM
ߤβۥɥ쥹Ǥϥΰ褬ĥǤ
.B MREMAP_MAYMOVE
ե饰 \fIflags\fP ꤵƤʤ
ޤϽʬ () ꤬¸ߤʤ
.SH 
Υ Linux ͭǤꡢܿտޤץ
Ѥ٤ǤϤʤ
.\" 4.2BSD ˤ (ºݤ˼Ƥ櫓ǤϤʤ)
.\" ۤä (semantics) ˤ
.\" .BR mremap (2)
.\" 뤬ä
.\" FIXME perhaps remove above statement about 4.2BSD.
.SH 
С 2.4  glibc Ǥϡ
.B MREMAP_FIXED
ϸƤ餺
.BR mremap ()
Υץȥפ
.I new_address
ʤä
.SH Ϣ
.BR brk (2),
.BR getpagesize (2),
.BR getrlimit (2),
.BR mlock (2),
.BR mmap (2),
.BR sbrk (2),
.BR realloc (3),
.BR malloc (3),
.BR feature_test_macros (7)
.P
ڡʬ䤵줿ˤĤƤäȾܤΤꤿʤ
ʤιߤ OS ζʽ򻲾Ȥ뤳ȡ
(\fIModern Operating Systems\fP by Andrew S. Tannenbaum,
\fIInside Linux\fP by Randolf Bentson,
\fIThe Design of the UNIX Operating System\fP by Maurice J. Bach.)