نام (NAME)

zramctl - پیکربندی و کنترل دستگاه‌های zram

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

دریافت اطلاعات:

zramctl [options]

بازنشانی zram:

zramctl -r zramdev...

چاپ نام نخستین دستگاه zram استفاده‌نشده:

zramctl -f

راه‌اندازی و پیکربندی یک دستگاه zram:

zramctl [-f | zramdev] [-s size] [-t number] [-a algorithm]

توضیحات (DESCRIPTION)

دستور zramctl برای پیکربندی سریع پارامترهای دستگاه zram، بازنشانی دستگاه‌های zram و استعلام وضعیت دستگاه‌های zram استفاده‌شده به کار می‌رود.

اگر هیچ گزینه‌ای مشخص نشود، تمامی دستگاه‌های zram با اندازه غیرصفر نمایش داده می‌شوند.

توجه داشته باشید که گره zramdev مشخص‌شده در خط فرمان باید از قبل وجود داشته باشد. دستور zramctl تنها زمانی گره‌های جدید /dev/zram<N> را ایجاد می‌کند که گزینه --find مشخص شده باشد. این امکان وجود دارد (و معمول است) که پس از راه‌اندازی سیستم، گره‌های /dev/zram<N> هنوز ایجاد نشده باشند.

گزینه‌ها (OPTIONS)

تنظیم الگوریتم فشرده‌سازی مورد استفاده برای فشرده‌سازی داده‌ها در دستگاه zram.

ممکن است فهرست الگوریتم‌های پشتیبانی‌شده دقیق نباشد زیرا به پیکربندی فعلی هسته بستگی دارد. یک نمای کلی مقدماتی را می‌توان با استفاده از دستور «cat /sys/block/zram0/comp_algorithm» به دست آورد؛ با این حال، لطفاً توجه داشته باشید که این فهرست نیز ممکن است ناقص باشد. دلیل این امر آن است که ZRAM از Crypto API استفاده می‌کند، و اگر الگوریتم‌های خاصی به‌صورت ماژول ساخته شده باشند، فهرست کردن همه آن‌ها غیرممکن خواهد بود.

-f, --find

یافتن نخستین دستگاه zram استفاده‌نشده. اگر آرگومان --size مشخص شده باشد، دستگاه مقداردهی اولیه می‌شود.

-n, --noheadings

خط سرستون در خروجی وضعیت چاپ نشود.

-o, --output list

تعیین ستون‌های خروجی وضعیت برای استفاده. اگر هیچ ترتیبی برای خروجی مشخص نشود، از یک مجموعه پیش‌فرض استفاده می‌شود. برای دریافت فهرست تمامی ستون‌های پشتیبانی‌شده از --help استفاده کنید.

در صورتی که list با قالب +list مشخص شود (برای نمونه zramctl -o+COMP-RATIO)، فهرست پیش‌فرض ستون‌ها گسترش می‌یابد.

-p, --algorithm-params

تنظیم پارامترهای الگوریتم؛ برای نمونه level=9 dict=/etc/dictionary برای تنظیم سطح فشرده‌سازی و واژه‌نامه از‌پیش‌آموزش‌دیده. پارامترها مختص هر الگوریتم هستند.

--output-all

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

--raw

استفاده از قالب خام (raw) برای خروجی وضعیت.

-r, --reset

بازنشانی گزینه‌های دستگاه(های) zram مشخص‌شده. تنظیمات دستگاه zram تنها پس از بازنشانی قابل تغییر هستند.

-s, --size size

ایجاد یک دستگاه zram با size مشخص‌شده. دستگاه‌های zram با صفحات حافظه هم‌تراز می‌شوند؛ هنگامی که size درخواستی مضربی از اندازه صفحه نباشد، به مضرب بعدی گرد می‌شود. در صورت عدم تعیین، واحد پارامتر size بایت است.

آرگومان size می‌تواند با پسوندهای ضربی KiB (=1024)، MiB (=1024*1024) و به همین ترتیب برای GiB، TiB، PiB، EiB، ZiB و YiB (پسوند «iB» اختیاری است؛ برای نمونه «K» همان معنای «KiB» را دارد) یا پسوندهای KB (=1000)، MB (=1000*1000) و به همین ترتیب برای GB، TB، PB، EB، ZB و YB همراه باشد.

-t, --streams number

تنظیم بیشینه تعداد جریان‌های فشرده‌سازی که می‌توانند برای دستگاه استفاده شوند. مقدار پیش‌فرض استفاده از تمام CPUها است و برای هسته‌های قدیمی‌تر از ۴.۶ یک جریان است.

-h, --help

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

-V, --version

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

وضعیت خروج (EXIT STATUS)

دستور zramctl در صورت موفقیت 0 و در صورت شکست مقداری غیرصفر برمی‌گرداند.

پرونده‌ها (FILES)

/dev/zram[0..N]

دستگاه‌های بلوکی zram

مثال‌ها (EXAMPLE)

دستورهای زیر یک دستگاه zram با اندازه یک گیگابایت را راه‌اندازی کرده و از آن به عنوان دستگاه swap استفاده می‌کنند.

# zramctl --find --size 1024M
/dev/zram0
# mkswap /dev/zram0
# swapon /dev/zram0
...
# swapoff /dev/zram0
# zramctl --reset /dev/zram0

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

Timofey Titovets <nefelim4ag@gmail.com>، Karel Zak <kzak@redhat.com>

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

مستندات هسته لینوکس https://docs.kernel.org/admin-guide/blockdev/zram.html

گزارش اشکالات (REPORTING BUGS)

برای گزارش اشکالات، از سامانه پیگیری اشکالات https://github.com/util-linux/util-linux/issues استفاده کنید.

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

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