نام (NAME)

lsmem - نمایش محدوده و وضعیت حافظه سیستم

خلاصه دستور (SYNOPSIS)

lsmem [options]

توضیحات (DESCRIPTION)

دستور lsmem محدوده‌های حافظه در دسترس را همراه با وضعیت برخط (online) بودن آن‌ها فهرست می‌کند. بلوک‌های حافظه فهرست‌شده متناظر با نحوه نمایش بلوک حافظه در sysfs هستند. این دستور همچنین اندازه بلوک حافظه و مقدار حافظه در حالت‌های برخط (online) و برون‌خط (offline) را نمایش می‌دهد.

خروجی پیش‌فرض با پیاده‌سازی اصلی در s390-tools سازگار است، اما اکیداً توصیه می‌شود از خروجی‌های پیش‌فرض در اسکریپت‌های خود استفاده نکنید. در محیط‌هایی که خروجی پایدار مورد نیاز است، همیشه ستون‌های مورد انتظار را با استفاده از گزینه --output همراه با فهرستی از ستون‌ها به صراحت مشخص کنید.

دستور lsmem هر زمان که بلوک حافظه جاری در برخی از ستون‌های خروجی با بلوک قبلی تفاوت داشته باشد، یک محدوده حافظه جدید را فهرست می‌کند. می‌توان این رفتار پیش‌فرض را با گزینه --split بازنویسی کرد (به عنوان مثال، lsmem --split=ZONES). کلمه ویژه "none" می‌تواند برای نادیده گرفتن تمام تفاوت‌های بین بلوک‌های حافظه و ایجاد محدوده‌های پیوسته تا حد امکان بزرگ استفاده شود. مفهوم مخالف آن --all است که تک‌تک بلوک‌های حافظه را فهرست می‌کند.

توجه داشته باشید اگر یک سیاست تفکیک، lsmem را مجبور کند تفاوت‌ها در برخی ویژگی‌ها را نادیده بگیرد، ممکن است برخی ستون‌های خروجی اطلاعات نادرستی ارائه دهند. به عنوان مثال اگر بلوک‌های حافظه قابل جابجایی (removable) و غیرقابل جابجایی (non-removable) را در یک محدوده ادغام کنید، آنگاه در خروجی lsmem تمام محدوده به عنوان غیرقابل جابجایی علامت‌گذاری می‌شود.

همه ستون‌ها در تمام سیستم‌ها پشتیبانی نمی‌شوند. اگر ستونی بدون پشتیبانی مشخص شود، lsmem آن ستون را چاپ می‌کند اما هیچ داده‌ای برای آن ارائه نمی‌دهد.

برای مشاهده توضیحات ستون‌ها از گزینه --help استفاده کنید.

گزینه‌ها (OPTIONS)

-a, --all

فهرست کردن هر بلوک حافظه به صورت جداگانه، به جای ادغام بلوک‌های حافظه با ویژگی‌های مشابه.

-b, --bytes

چاپ اندازه‌ها بر حسب بایت به جای یک قالب خوانا برای انسان.

به طور پیش‌فرض، واحدی که اندازه‌ها بر حسب آن بیان می‌شوند بایت است و پیشوندهای واحد با توان‌های 2^10 (1024) هستند. کوته‌نوشت‌های نمادها برای دستیابی به خوانایی بهتر به صورت کوتاه شده و تنها با نمایش حرف اول آن‌ها نشان داده می‌شوند؛ مثال‌ها: "1 KiB" و "1 MiB" به ترتیب به صورت "1 K" و "1 M" نمایش داده می‌شوند، و عبارت "iB" که بخشی از این کوته‌نوشت‌هاست به عمد حذف می‌شود.

-J, --json

استفاده از قالب خروجی JSON.

-n, --noheadings

خط سرایند چاپ نشود.

-o, --output list

مشخص کردن این‌که کدام ستون‌های خروجی چاپ شوند. از --help برای دریافت فهرستی از تمام ستون‌های پشتیبانی‌شده استفاده کنید. فهرست پیش‌فرض ستون‌ها در صورتی که list در قالب +list مشخص شود، قابل گسترش است (به عنوان مثال، lsmem -o +NODE).

--output-all

نمایش تمام ستون‌های موجود در خروجی.

-P, --pairs

تولید خروجی در قالب جفت‌های key="value". تمام نویسه‌های بالقوه ناامن در مقادیر به صورت هگزادسیمال اسکیپ می‌شوند (\x<code>).

-r, --raw

تولید خروجی در قالب خام (raw). تمام نویسه‌های بالقوه ناامن به صورت هگزادسیمال اسکیپ می‌شوند (\x<code>).

-S, --split list

مشخص کردن این‌که از کدام ستون‌ها (ویژگی‌ها) برای تفکیک بلوک‌های حافظه به محدوده‌ها استفاده شود. ستون‌های پشتیبانی‌شده عبارتند از STATE، REMOVABLE، NODE و ZONES یا "none". سایر ستون‌ها بدون هشدار نادیده گرفته می‌شوند. برای جزئیات بیشتر به بخش DESCRIPTION در بالا مراجعه کنید.

-s, --sysroot directory

جمع‌آوری داده‌های حافظه برای یک نمونه لینوکس غیر از نمونه‌ای که دستور lsmem از آن صادر شده است. directory مشخص‌شده، دایرکتوری ریشه سیستم (system root) نمونه لینوکسی است که باید بررسی شود.

--summary[=when]

این گزینه خروجی خطوط خلاصه را کنترل می‌کند. آرگومان اختیاری when می‌تواند never، always یا only باشد. اگر آرگومان when حذف شود، مقدار پیش‌فرض آن "only" است. خروجی خلاصه برای گزینه‌های --raw، --pairs و --json غیرفعال می‌شود.

-h, --help

نمایش متن راهنما و خروج.

-V, --version

نمایش نسخه و خروج.

نویسندگان (AUTHORS)

دستور lsmem در ابتدا توسط Gerald Schaefer برای s390-tools در زبان Perl نوشته شد. نسخه C برای util-linux توسط Clemens von Mann، Heiko Carstens و Karel Zak نوشته شده است.

همچنین ببینید (SEE ALSO)

chmem(8)

گزارش باگ‌ها (REPORTING BUGS)

برای گزارش باگ‌ها، از ردیاب اشکال https://github.com/util-linux/util-linux/issues.

در دسترس بودن (AVAILABILITY)

دستور lsmem بخشی از بسته util-linux است که می‌تواند از بایگانی هسته لینوکس https://www.kernel.org/pub/linux/utils/util-linux. دریافت شود.