'\" t
.\"     Title: chmem
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-16
.\"    Manual: System Administration
.\"    Source: util-linux 2.41.5
.\"  Language: Persian
.\"
.TH "CHMEM" "8" "2026-06-16" "util\-linux 2.41.5" "مدیریت سیستم"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
chmem \- پیکربندی برخط یا برون‌خط حافظه سیستم
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBchmem\fP [\fB\-h\fP] [\fB\-V\fP] [\fB\-v\fP] [\fB\-e\fP|\fB\-d\fP] [\fISIZE\fP|\fIRANGE\fP \fB\-b\fP \fIBLOCKRANGE\fP] [\fB\-z\fP \fIZONE\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBchmem\fP اندازه یا بازه مشخصی از حافظه را برخط (online) یا برون‌خط (offline) می‌کند.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
مقدار \fISIZE\fP را به صورت <size>[m|M|g|G] مشخص کنید. با m یا M، مقدار <size> اندازه حافظه را بر حسب مبی‌بایت (MiB یا ۱۰۲۴ × ۱۰۲۴ بایت) مشخص می‌کند. با g یا G، مقدار <size> اندازه حافظه را بر حسب گیبی‌بایت (GiB یا ۱۰۲۴ × ۱۰۲۴ × ۱۰۲۴ بایت) تعیین می‌کند. یکای پیش‌فرض MiB است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
مقدار \fIRANGE\fP را به فرم 0x<start>\-0x<end> همانند آنچه در خروجی دستور \fBlsmem\fP(1) نشان داده می‌شود مشخص کنید. مقدار <start> نشانی هگزادسیمال نخستین بایت و <end> نشانی هگزادسیمال آخرین بایت در بازه حافظه است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
مقدار \fIBLOCKRANGE\fP را به فرم <first>\-<last> یا <block> همانند آنچه در خروجی دستور \fBlsmem\fP(1) نشان داده می‌شود مشخص کنید. مقدار <first> شماره نخستین بلوک حافظه و <last> شماره آخرین بلوک حافظه در بازه حافظه است. همچنین می‌توان یک بلوک منفرد را مشخص کرد. استفاده از \fIBLOCKRANGE\fP نیازمند گزینه \fB\-\-blocks\fP است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
مقدار \fIZONE\fP را به عنوان نام یک ناحیه حافظه، همانند آنچه در خروجی دستور \fBlsmem \-o +ZONES\fP نشان داده شده مشخص کنید. این خروجی یک یا چند ناحیه معتبر حافظه را برای هر بازه حافظه نشان می‌دهد. اگر چندین ناحیه نشان داده شود، بازه حافظه در حال حاضر متعلق به ناحیه نخست است. به‌طور پیش‌فرض، \fBchmem\fP در صورتی که ناحیه Movable در میان نواحی معتبر باشد، حافظه را در این ناحیه برخط می‌کند. این پیش‌فرض را می‌توان با تعیین گزینه \fB\-\-zone\fP به همراه یک ناحیه معتبر دیگر تغییر داد. برای بالونینگ حافظه (memory ballooning)، توصیه می‌شود در صورت امکان ناحیه Movable برای برخط و برون‌خط کردن حافظه انتخاب شود. احتمال اینکه حافظه در این ناحیه بتواند مجدداً برون‌خط شود بسیار بیشتر است، اما نمی‌توان از آن برای تخصیص‌های دلخواه هسته استفاده کرد، بلکه تنها برای صفحات قابل‌انتقال (مانند صفحات ناشناس و حافظه پنهان صفحه) قابل استفاده است. برای دیدن تمام نواحی موجود از گزینه \fB\-\-help\fP استفاده کنید.
.RE
.sp
مقادیر \fISIZE\fP و \fIRANGE\fP باید با اندازه بلوک حافظه لینوکس تراز (aligned) باشند، همان‌طور که در خروجی دستور \fBlsmem\fP(1) نشان داده شده است.
.sp
برخط کردن حافظه ممکن است به دلایل گوناگونی با شکست مواجه شود. در سیستم‌های مجازی‌سازی‌شده، اگر هایپروایزر حافظه کافی در اختیار نداشته باشد (برای نمونه به دلیل تخصیص بیش از حد یا overcommit شدن حافظه)، این عملیات ممکن است شکست بخورد. برون‌خط کردن حافظه نیز در صورتی که لینوکس نتواند حافظه را آزاد کند ممکن است ناموفق باشد. اگر تنها بخشی از حافظه درخواستی بتواند برخط یا برون‌خط شود، پیامی به شما اعلام می‌کند که به جای مقدار درخواستی، چه مقدار حافظه برخط یا برون‌خط شده است.
.sp
هنگام برخط کردن حافظه، \fBchmem\fP از کمترین شماره‌های بلوک حافظه شروع می‌کند. هنگام برون‌خط کردن حافظه، \fBchmem\fP از بیشترین شماره‌های بلوک حافظه آغاز می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-b\fP, \fB\-\-blocks\fP
.RS 4
استفاده از پارامتر \fIBLOCKRANGE\fP به جای \fIRANGE\fP یا \fISIZE\fP برای گزینه‌های \fB\-\-enable\fP و \fB\-\-disable\fP.
.RE
.sp
\fB\-d\fP, \fB\-\-disable\fP
.RS 4
برون‌خط کردن \fIRANGE\fP، \fISIZE\fP یا \fIBLOCKRANGE\fP مشخص‌شده از حافظه.
.RE
.sp
\fB\-e\fP, \fB\-\-enable\fP
.RS 4
برخط کردن \fIRANGE\fP، \fISIZE\fP یا \fIBLOCKRANGE\fP مشخص‌شده از حافظه.
.RE
.sp
\fB\-z\fP, \fB\-\-zone\fP
.RS 4
انتخاب ناحیه حافظه (\fIZONE\fP) که قرار است \fIRANGE\fP، \fISIZE\fP یا \fIBLOCKRANGE\fP مشخص‌شده از حافظه در آن برخط یا برون‌خط شود. به‌طور پیش‌فرض، در صورت امکان حافظه در ناحیه Movable برخط خواهد شد.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
حالت پرگو (verbose). باعث می‌شود \fBchmem\fP پیام‌های اشکال‌زدایی درباره روند پیشرفت خود را چاپ کند.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
دستور \fBchmem\fP مقادیر وضعیت خروج زیر را دارد:
.sp
\fB0\fP
.RS 4
موفقیت
.RE
.sp
\fB1\fP
.RS 4
شکست
.RE
.sp
\fB64\fP
.RS 4
موفقیت نسبی
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
\fBchmem \-\-enable 1024\fP
.RS 4
این دستور درخواست برخط شدن ۱۰۲۴ مبی‌بایت از حافظه را می‌دهد.
.RE
.sp
\fBchmem \-e 2g\fP
.RS 4
این دستور درخواست برخط شدن ۲ گیبی‌بایت از حافظه را می‌دهد.
.RE
.sp
\fBchmem \-\-disable 0x00000000e4000000\-0x00000000f3ffffff\fP
.RS 4
این دستور درخواست برون‌خط شدن بازه حافظه از 0x00000000e4000000 تا 0x00000000f3ffffff را می‌دهد.
.RE
.sp
\fBchmem \-b \-d 10\fP
.RS 4
این دستور درخواست برون‌خط شدن بلوک شماره ۱۰ حافظه را می‌دهد.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBlsmem\fP(1)
.SH "گزارش اشکالات (REPORTING BUGS)"
.sp
برای گزارش اشکال‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "ردیاب اشکال" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBchmem\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."