نام (NAME)
criu - ایجاد چک‌پوینت و بازیابی در فضای کاربری (checkpoint/restore in userspace)

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

criu command [option ...]

توضیحات (DESCRIPTION)

ابزار criu برنامه‌ای برای ایجاد چک‌پوینت و بازیابی برنامه‌های در حال اجرا است. این کار با ذخیره وضعیت آن‌ها در قالب مجموعه‌ای از فایل‌ها (دستور dump را ببینید) و ساخت فرآیندهای معادل از روی آن فایل‌ها (دستور restore را ببینید) انجام می‌پذیرد. عملیات بازیابی می‌تواند در زمانی دیگر، بر روی سیستمی دیگر، یا هر دو حالت انجام شود.

گزینه‌ها (OPTIONS)

بیشتر فلگ‌های طولانی را می‌توان با پیشوند no- برای نقیض کردن گزینه به کار برد (برای نمونه: --isplay-stats و --0-isplay-stats).

گزینه‌های عمومی (Common options)

گزینه‌های عمومی برای هر دستور قابل اعمال هستند.

-v[v...], --

-vnum, --

--onfig file

--0-efault-onfig

--idfile
file

-o, --

--isplay-ats

-D, --images-ir path

--ream

--rev-images-ir
path

-W, --216

--lose fd

-L, --r path

--\nable-

--ction-ript script

--nprivileged

-V, --

-h, --

pre-dump

انجام فرآیند پیش‌تخلیه (pre-dump) که طی آن criu یک اسنپ‌شات از تغییرات حافظه نسبت به pre-dump قبلی ثبت می‌کند. توجه داشته باشید که در طول این فرآیند، criu همچنین کش fsnotify را می‌سازد که فرآیند restore را تسریع می‌بخشد. دستور pre-dump حداقل به گزینه -t نیاز دارد (بخش dump در ادامه را ببینید). علاوه بر این، گزینه‌های page-server نیز قابل تعیین هستند.

--rack-m

--re-ump-de=mode

dump

انجام عملیات ایجاد چک‌پوینت (checkpoint).

-t, --ree pid

-R, ---unning

-s, ---opped

--\xternal type[id]:value

--\xternal mnt[mountpoint]:name

--\xternal mnt[]:flags

--\xternal dev[major/minor]:name

--\xternal file[mnt_id:inode]

--\xternal tty[rdev:dev]

--\xternal unix[id]

--\xternal net[inode]:name

--\xternal pid[inode]:name

--

--nage-groups

--group-rops
spec

"c1":
 - "strategy": "merge"
 - "properties": ["a", "b"]
"c2":
 - "strategy": "replace"
 - "properties": ["c", "d"]

--cgroup-props "

--group-rops-

--group-ump-ontroller name

--group-yard path

#subsys_name hierarchy num_cgroups enabled
cpu          1         1           1
devices      2         2           1
freezer      2         2           1

mkdir private_yard
cd private_yard
mkdir cpu
mount -t cgroup -o cpu none cpu
mkdir devices,freezer
mount -t cgroup -o devices,freezer none devices,freezer

--cp-\stablished

--cp-lose

--ip-in-

--\vasive-evices

--age-rver

--

--uto-edup

-l, --

--

--imeout number

--ost-t size

--ost-

-j, --ell-job

--pu-ap [cap[,cap...]]

--group-oot [controller:]/newroot

--ges

--

--0twork-de]

--llow-probes

یک uprobes vma به‌طور خودکار توسط هسته پس از تحریک یک uprobe ایجاد
می‌شود. این نگاشت حتی پس از حذف uprobe نیز پاک نمی‌شود. بنابراین حتی اگر
فرآیندی در گذشته دارای uprobes بوده و اکنون حذف شده باشد، این گزینه
همچنان لازم است زیرا criu راهی برای تشخیص وجود uprobe فعال ندارد.

هنگام استفاده از این گزینه در بازیابی، مطمئن شوید که uprobeهای فعال روی فرآیند
هنوز فعال باشند؛ در غیر این صورت با رسیدن اجرا به نقطه uprobe، سیگنال
SIGTRAP ارسال خواهد شد.

برای نمونه، اگر uprobe روی تابع foo از فرآیند p_bar تنظیم شده باشد و دست‌کم
یک بار اجرا شود، هسته نگاشت uprobes vma را ایجاد می‌کند. پس از dump اگر uprobe
حذف شود، با رسیدن به تابع foo سیگنال SIGTRAP به p_bar ارسال شده و در صورت
عدم مدیریت سیگنال، برنامه کرش خواهد کرد.

restore

بازیابی فرآیندهایی که قبلاً از آن‌ها چک‌پوینت تهیه شده است.

--inherit-fd fd[N]:resource

-d, --estore-etached

-s, ---opped

-S, --estore-bling

--

-r, --oot path

--\xternal type[id]:value

--\xternal mnt[name]:mountpoint

--\xternal mnt[]

--\xternal dev[name]:/dev/path

--\xternal veth[inner_dev]:outer_dev@bridge

--\xternal macvlan[inner_dev]:outer_dev

-J, --join-0 NS:{PID|NS_FILE}[,EXTRA_OPTS]

--nage-groups [mode]

--group-yard path

--group-oot [controller:]/newroot

--cp-\stablished

--cp-lose

--

-l, --

--

--

context="system_u:object_r:container_file_t:s0:c82,c137"

--lsm-mount-context "system_u:object_r:container_file_t:s0:c204,c495"

--uto-edup

-j, --ell-job

--pu-ap [cap[,cap...]]

--192

--ges

--

--ip-

--llow-probes

check

بررسی اینکه آیا هسته از ویژگی‌های مورد نیاز criu برای تخلیه و بازیابی یک درخت فرآیند پشتیبانی می‌کند یا خیر.

سه دسته پشتیبانی هسته وجود دارد: دستور criu check همواره ویژگی‌های دسته ۱ را بررسی می‌کند مگر آنکه --

Category 1

Category 2

Category 3

اگر هیچ خطا یا هشداری وجود نداشته باشد، criu عبارت "Looks good." را چاپ کرده و کد خروج آن 0 خواهد بود.

فقدان یک ویژگی دسته ۱ باعث چاپ "Does not look good." شده و کد خروج غیرصفر خواهد بود.

فقدان ویژگی‌های دسته‌های ۲ و ۳ باعث چاپ "...Looks good but" شده و کد خروج غیرصفر خواهد بود.

بدون هیچ گزینه‌ای، criu check ویژگی‌های دسته ۱ را بررسی می‌کند. با گزینه‌های زیر می‌توان این رفتار را تغییر داد:

--\xtra

--\xperimental

--ll

--

page-server

راه‌اندازی criu در حالت سرور صفحه (page server mode).

--aemon

--atus-

--ddress address

--ort
number

--s-cket
fd

--ges

--ls-acert file

--ls-acrl file

--ls-ert file

--ls-y file

--ls

lazy-pages

راه‌اندازی criu در حالت دیمن lazy-pages.

دیمن lazy-pages مسئولیت مدیریت صفحه‌بندی درخواستی در سطح کاربر برای فرآیندهای بازیابی‌شده را بر عهده دارد. این دیمن اطلاعات لازم برای پر کردن صفحات حافظه را از restore و دایرکتوری چک‌پوینت دریافت می‌کند و صفحات درخواست‌نشده را در پس‌زمینه تزریق می‌نماید.

exec

اجرای یک فراخوانی سیستمی درون کانتکست تسک مقصد. این قابلیت منسوخ شده است؛ لطفاً به جای آن از Compel استفاده نمایید.

service

راه‌اندازی criu در حالت دیمن RPC، که در آن criu روی سوکت به دستورات RPC گوش می‌دهد. این حالت برای مواردی مناسب است که خود دیمن با دسترسی کاربر ارشد (ریشه) اجرا می‌شود اما کلاینت‌ها دسترسی ممتاز ندارند.

dedup

آغاز فرآیند حذف داده‌های تکراری در pagemap، که در آن criu کلیه فایل‌های pagemap را اسکن کرده و تعداد ورودی‌ها را با استفاده از ارجاعات تصویر والد به حداقل می‌رساند.

cpuinfo dump

واکشی ویژگی‌های پردازنده فعلی و نوشتن آن‌ها در یک فایل تصویر.

cpuinfo check

واکشی ویژگی‌های پردازنده فعلی (پردازنده‌ای که criu روی آن اجرا می‌شود) و آزمایش سازگاری آن‌ها با موارد موجود در یک فایل تصویر.

فایل‌های پیکربندی (CONFIGURATION FILES)

ابزار Criu از فایل‌های پیکربندی برای پرهیز از درج مکرر گزینه‌ها در خط فرمان پشتیبانی می‌کند. یک فایل پیکربندی مشخص را می‌توان با گزینه "--onfig file" ارسال کرد. اگر فایلی مشخص نشود، فایل‌های پیکربندی پیش‌فرض /etc/criu/default.conf و $HOME/.criu/default.conf (در صورت وجود) پردازش خواهند شد. همچنین اگر متغیر محیطی CRIU_CONFIG_FILE تنظیم شده باشد، پردازش می‌گردد.

گزینه‌های ارسال‌شده به CRIU از طریق CLI، RPC یا فایل پیکربندی با ترتیب زیر ارزیابی می‌شوند:

پردازش فایل‌های پیکربندی پیش‌فرض را می‌توان در صورت نیاز با "--0-efault-onfig" غیرفعال کرد. فایل‌های پیکربندی با گزینه‌های خط فرمان ادغام شده و امکان بازنویسی گزینه‌ها را فراهم می‌کنند.

نحو فایل‌های پیکربندی (Configuration file syntax)

کامنت‌ها با علامت '#' پشتیبانی می‌شوند و ادامه خط نادیده گرفته می‌شود. گزینه‌ها همانند گزینه‌های خط فرمان بدون پیشوند '--' هستند (یک گزینه در هر سطر همراه با آرگومان مربوطه که با فاصله جدا شده است). آرگومان‌ها را می‌توان در صورت نیاز درون جفت‌گیومه قرار داد. استفاده از دستورات در فایل پیکربندی مجاز نیست.

نمونه‌ای از فایل پیکربندی برای نمایش نحو نگارش:

$ cat ~/.criu/default.conf
tcp-established
work-dir "/home/USERNAME/criu/my
# این یک کامنت است
no-restore-sibling   # این کامنت دیگری است

فایل‌های پیکربندی در حالت RPC (Configuration files in RPC mode)

ابزار criu نه تنها در حالت CLI بلکه در حالت RPC نیز فایل‌های پیکربندی را بررسی می‌کند. مقادیر فایل پیکربندی ابتدا ارزیابی می‌شوند، بدین معنا که هر گزینه‌ای که از طریق RPC تنظیم شود، تنظیمات فایل پیکربندی را رونویسی خواهد کرد.

کلاینت RPC همچنین می‌تواند یک فایل پیکربندی اضافی تعیین کند که پس از گزینه‌های RPC ارزیابی خواهد شد (از طریق "req.opts.config_file = /path/to/file"). مقادیر این فایل بر تمام گزینه‌های دیگر اولویت خواهد داشت. این کار می‌تواند منجر به رفتارهای ناخواسته در criu شود و تنها باید با احتیاط استفاده گردد.

کاربر غیرریشه (NON-ROOT)

ابزار criu می‌تواند به صورت غیرریشه با استفاده از قابلیت CAP_SYS_ADMIN یا با قابلیت CAP_CHECKPOINT_RESTORE (معرفی‌شده در هسته لینوکس 5.9) به کار گرفته شود. داشتن CAP_CHECKPOINT_RESTORE حداقل پیش‌نیاز است.

همچنین criu به قابلیت CAP_SYS_PTRACE یا مقدار 0 در /proc/sys/kernel/yama/ptrace_scope (مستندات ptrace(2) را ببینید) نیاز دارد تا بتواند فرآیند را جهت dump متوقف کند.

اجرای criu به عنوان غیرریشه محدودیت‌های متعددی دارد و بسته به فرآیند مد نظر ممکن است امکان‌پذیر نباشد.

علاوه بر CAP_CHECKPOINT_RESTORE، می‌توان قابلیت‌های بیشتری برای فعال‌سازی ویژگی‌های تکمیلی به criu اعطا کرد:

توجه داشته باشید برای برخی عملیات، داشتن قابلیت در فضایی به جز فضای نام init (فضای نام ریشه/پیش‌فرض) کافی نیست. برای نمونه جهت خواندن symlinkها در proc/[pid]/map_files، داشتن CAP_CHECKPOINT_RESTORE در فضای نام init الزامی است.

صرف‌نظر از قابلیت‌ها، همواره استفاده از "--nprivileged" برای پذیرش محدودیت‌های criu در حالت غیرریشه الزامی است.

مثال‌ها (EXAMPLES)

برای ایجاد چک‌پوینت از برنامه‌ای با شناسه فرآیند 1234 و نوشتن تمام فایل‌های تصویر درون دایرکتوری checkpoint:

criu dump -D checkpoint -t 1234

برای بازیابی این برنامه همراه با جدا شدن criu:

criu restore -d -D checkpoint

نویسنده (AUTHOR)

تیم CRIU.

حق نشر (COPYRIGHT)

Copyright (C) 2011-2016, Parallels Holdings, Inc.