نام (NAME)

dmtcp_launch - اجرای یک فرایند تحت واپایش DMTCP

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

dmtcp_launch [OPTIONS] <command> [args...]

توضیحات (DESCRIPTION)

dmtcp_launch یک فرایند را تحت واپایش DMTCP اجرا می‌کند.

نمونه‌ای از کاربرد معمول:
rm ckpt_a.out_*.dmtcp # حذف هرگونه نسخه قدیمی از تصویر بازرسی (ckpt)
dmtcp_launch --interval 5 a.out
dmtcp_command --checkpoint # اجرای این دستور در پنجره‌ای دیگر
# بستن فرایند a.out که در حال اجرا است
dmtcp_restart ckpt_a.out_*.dmtcp

گزینه‌ها (OPTIONS)

اتصال به هماهنگ‌کننده DMTCP

-h, --coord-host hostname (متغیر محیطی DMTCP_COORD_HOST): نام میزبانی که dmtcp_coordinator روی آن اجرا می‌شود (پیش‌فرض: localhost)
-p, --coord-port port (متغیر محیطی DMTCP_COORD_PORT): درگاهی که dmtcp_coordinator روی آن اجرا می‌شود (پیش‌فرض: 7779)
--port-file filename: فایلی برای نوشتن شماره درگاه شنونده (listener). (هنگام استفاده با --coord-port 0، که برای انتساب یک درگاه تصادفی به کار می‌رود، مفید است)
-j, --join: پیوستن به یک هماهنگ‌کننده موجود؛ در صورتی که هماهنگ‌کننده‌ای از قبل وجود نداشته باشد خطا اعلام می‌شود
--new-coordinator: ایجاد یک هماهنگ‌کننده جدید روی درگاه داده‌شده. در صورتی که از قبل هماهنگ‌کننده‌ای روی درگاه داده‌شده وجود داشته باشد، با شکست مواجه می‌شود. درگاه را می‌توان با --coord-port یا با متغیر محیطی DMTCP_COORD_PORT مشخص کرد. اگر هیچ درگاهی مشخص نشود، هماهنگ‌کننده روی یک درگاه تصادفی آغاز به کار می‌کند (مشابه تعیین درگاه '0').
--no-coordinator: اجرای فرایند در حالت مستقل و بدون هماهنگ‌کننده (coordinator-less).
برای درخواست نقاط بازرسی از dmtcp_command یا --interval استفاده کنید.
-i, --interval seconds (متغیر محیطی DMTCP_CHECKPOINT_INTERVAL): زمان به ثانیه میان نقاط بازرسی خودکار. مقدار 0 به معنای هرگز است (فقط ایجاد دستی نقطه بازرسی)؛ در صورت تنظیم نشدن و نبود متغیر محیطی، از مقدار پیش‌فرض تنظیم‌شده در dmtcp_coordinator یا dmtcp_command استفاده می‌شود. در صورت مشخص شدن --join مجاز نیست

ایجاد تصویر نقطه بازرسی

--gzip, --no-gzip (متغیر محیطی DMTCP_GZIP=[01]): فعال/غیرفعال کردن فشرده‌سازی تصاویر نقطه بازرسی (پیش‌فرض: 1 (فعال))
هشدار: gzip چند ثانیه به زمان اضافه می‌کند. بدون gzip، ذخیره نقطه بازرسی اغلب کمتر از ۱ ثانیه طول می‌کشد
--ckptdir path (متغیر محیطی DMTCP_CHECKPOINT_DIR): دایرکتوری برای ذخیره تصاویر نقطه بازرسی (پیش‌فرض: دایرکتوری جاری در هنگام اجرا)
--ckpt-open-files: ایجاد نقطه بازرسی از فایل‌های باز و بازیابی دایرکتوری کاری پیشین. (پیش‌فرض: هیچ‌کدام انجام نمی‌شود)
--checkpoint-open-files: منسوخ شده است. به جای آن از --ckpt-open-files استفاده کنید.
--ckpt-signal signum: شماره سیگنالی که در داخل DMTCP برای ایجاد نقطه بازرسی به کار می‌رود (پیش‌فرض: 12)
--ckpt-signal signum: منسوخ شده است. به جای آن از --ckpt-signal استفاده کنید.

فعال/غیرفعال‌سازی افزونه‌ها

--with-plugin plugins (متغیر محیطی DMTCP_PLUGIN): فهرستی از افزونه‌های DMTCP جداشده با دونقطه (:) برای پیش‌بارگذاری با DMTCP. (مسیرهای کامل و مطلق الزامی است.)
--batch-queue, --rm: فعال‌سازی پشتیبانی از مدیران منابع (Torque PBS و SLURM). (پیش‌فرض: غیرفعال)
--modify-env: به‌روزرسانی متغیرهای محیطی بر اساس محیط میزبان بازنشانی (برای مثال، DISPLAY=$DISPLAY). این مقدار را می‌توان در یک فایل dmtcp_env.txt تنظیم کرد. (پیش‌فرض: غیرفعال)
--disable-alloc-plugin (متغیر محیطی DMTCP_ALLOC_PLUGIN=[01]): غیرفعال کردن افزونه alloc (پیش‌فرض: فعال).
--disable-dl-plugin (متغیر محیطی DMTCP_DL_PLUGIN=[01]): غیرفعال کردن افزونه dl (پیش‌فرض: فعال).
--disable-all-plugins (فقط برای افراد خبره، جهت اشکال‌زدایی): غیرفعال کردن همه افزونه‌ها.

سایر گزینه‌ها

--prefix path: پیشوند (prefix) مسیر نصب DMTCP روی گره‌های راه دور.
--tmpdir path (متغیر محیطی DMTCP_TMPDIR): دایرکتوری برای ذخیره فایل‌های موقت (پیش‌فرض: $TMDPIR/dmtcp-$USER@$HOST یا /tmp/dmtcp-$USER@$HOST)
-q, --quiet (یا تنظیم متغیر محیطی DMTCP_QUIET = 0، 1 یا 2): صرف‌نظر کردن از پیام‌های NOTE؛ اگر دو بار مشخص شود، از WARNINGها نیز صرف‌نظر می‌کند
--help: چاپ این پیام راهنما و خروج.
--version: چاپ اطلاعات نسخه و خروج.

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

گزارش باگ‌ها به: dmtcp-forum@lists.sourceforge.net
صفحه اصلی DMTCP: http://dmtcp.sourceforge.net

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

dmtcp(1), dmtcp_coordinator(1), dmtcp_launch(1), dmtcp_restart(1), dmtcp_command(1)

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

فایل /usr/share/doc/dmtcp-3.0.0/AUTHORS را ببینید.

نسخه (VERSION)

DMTCP نسخه 3.0.0 مربوط به سپتامبر 2018.

کپی‌رایت و تکثیر (COPYRIGHT)

فایل /usr/share/doc/dmtcp-3.0.0/COPYING را ببینید.

مجوز LGPLv3+: گنو LGPL نسخه 3 یا بالاتر http://gnu.org/licenses/lgpl.html.

این برنامه کاملاً بدون هیچ‌گونه ضمانتی ارائه می‌شود. این یک نرم‌افزار آزاد است و شما مجاز هستید تحت شرایط خاصی آن را بازتوزیع کنید؛ برای جزئیات به فایل COPYING مراجعه کنید.