.mso www.tmac
.TH reptyr 1 "03 Feb 2011"
.SH "نام (NAME)"
reptyr \- تغییر والد و انتقال یک برنامهٔ در حال اجرا به یک ترمینال جدید
.SH "خلاصه دستور (SYNOPSIS)"
.B reptyr
.I PID

.B reptyr \-l|\-L [COMMAND [ARGS]]

.SH "توضیحات (DESCRIPTION)"

.B reptyr
ابزاری برای گرفتن یک برنامهٔ در حال اجرای موجود و اتصال آن به یک ترمینال جدید است. فرآیندی طولانی را از طریق
ssh
آغاز کرده‌اید، اما باید سیستم را ترک کنید و نمی‌خواهید آن را متوقف نمایید؟ کافی است یک نشست
screen
را شروع کنید، از
.B reptyr
برای گرفتن آن استفاده کنید، سپس نشست
ssh
را خاتمه داده و به خانه بروید.
.LP
.B reptyr
با اتصال به برنامهٔ هدف با استفاده از
.BR ptrace (2)،
تغییر مسیر توصیف‌کننده‌های فایل مربوطه، و تغییر ترمینال کنترلی برنامه (ببینید:
.BR tty (4))
کار می‌کند. همین جزئیات آخر است که باعث می‌شود
.B reptyr
بسیار بهتر از گزینه‌های جایگزین مانند
.BR retty (1)
عمل کند.

.LP
پس از پیوستن به برنامه، برنامه برای پوسته‌ای (shell) که از آن اجرا شده بود، به‌صورت در پس‌زمینه قرارگرفته یا تعلیق‌شده به نظر می‌رسد (بسته به نوع پوسته). برای بیشترین ضریب اطمینان می‌توانید دستور زیر را در پوستهٔ قبلی اجرا کنید:
.IP
bg; disown
.LP

تا وابستگی با برنامه حذف شود، با این وجود
.B reptyr
تلاش خواهد کرد تا اطمینان حاصل کند که برنامهٔ هدف حتی اگر بدون انجام این کار پوسته را ببندید، همچنان در حال اجرا باقی بماند.

.SH "گزینه‌ها (OPTIONS)"

.B \-T
.IP
استفاده از یک حالت اتصال جایگزین، «ربودن TTY» (TTY-stealing). در این حالت،
.B reptyr
روی فرآیند هدف
.BR ptrace (2)
را فراخوانی نمی‌کند، بلکه تلاش می‌کند شبیه‌ساز ترمینال را برای pty آن فرآیند شناسایی کرده و انتهای اصلی (master) pty را برباید. این حالت در شرایط بسیاری قابل اعتمادتر و انعطاف‌پذیرتر است (به‌عنوان مثال، می‌تواند همهٔ فرآیندهای موجود روی یک tty را متصل کند، نه فقط یک فرآیند تکی را). با این حال، به‌عنوان یک نقطه‌ضعف، فرآیندهای فرزند
.BR sshd (8)
را نمی‌توان از طریق
.B \-T
متصل کرد، مگر اینکه
.B reptyr
به‌عنوان کاربر ریشه (root) اجرا شود. برای اطلاعات بیشتر در مورد tty-stealing به نشانی
.URL https://blog.nelhage.com/2014/08/new-reptyr-feature-tty-stealing
مراجعه کنید.
.LP

.B \-l, \-L [COMMAND [ARGS]]
.IP
به جای اتصال به یک فرآیند جدید، یک جفت pty تازه ایجاد می‌کند، انتهای master را به ترمینال فعلی هدایت (proxy) می‌کند و سپس نام slave pty را چاپ می‌کند. این مقدار را می‌توان به عنوان مثال به گزینهٔ
.I set inferior-tty
در
.B gdb
پاس داد.

اگر یک
.B COMMAND
و
.B ARGS
اختیاری همراه با
.B \-l
داده شود، آن دستور به عنوان فرزندی از
.B reptyr
اجرا خواهد شد در حالی که متغیر محیطی
.B REPTYR_PTY
روی نام slave pty تنظیم شده است. اگر به جای
.B \-l
از
.B \-L
استفاده شود، آن‌گاه توصیف‌کننده‌های فایل ۰ تا ۲ فرزند نیز به سمت slave هدایت خواهند شد، و فرزند در یک نشست جدید همراه با slave به عنوان ترمینال کنترلی‌اش اجرا می‌شود.
.LP

.B \-s
.IP
به‌طور پیش‌فرض، reptyr هر توصیف‌کنندهٔ فایلی در هدف را که به ترمینال کنترلی هدف متصل بوده است، طوری منتقل می‌کند که به ترمینال جدید اشاره کند. گزینهٔ
.B \-s
باعث می‌شود که reptyr بدون قید و شرط توصیف‌کننده‌های فایل ۰، ۱ و ۲ را در هدف متصل کند، حتی اگر هدف فاقد ترمینال کنترلی باشد یا آن‌ها به یک ترمینال متصل نباشند.
.LP

.B \-v
.IP
چاپ نسخهٔ
.B reptyr
و خروج.
.LP

.B \-h
.IP
چاپ پیام راهنمای نحوهٔ استفاده و خروج.
.LP

.B \-V
.IP
چاپ خروجی اشکال‌زدایی پرگو (verbose) در حین اجرا.
.LP

.SH "نکات (NOTES)"

.B reptyr
برای اتصال به برنامهٔ هدف به فراخوانی سیستمی
.BR ptrace (2)
وابسته است. در توزیع Ubuntu نسخهٔ Maverick و بالاتر، این قابلیت به دلایل امنیتی به‌طور پیش‌فرض غیرفعال است. می‌توانید آن را موقتاً با اجرای دستور زیر به عنوان کاربر ریشه (root) فعال کنید:
.IP
 # echo 0 > /proc/sys/kernel/yama/ptrace_scope
.LP
یا به صورت دائمی با ویرایش فایل
.IR /etc/sysctl.d/10-ptrace.conf
که حاوی اطلاعات بیشتری در مورد این تنظیمات نیز می‌باشد.

.SH "گزارش باگ‌ها (BUGS)"

هنگام اتصال به برخی برنامه‌های curses، آن‌ها فوراً صفحه را بازترسیم نمی‌کنند و برای وادار کردن به بازترسیم، فشردن کلیدهای
.B ^L
یا موارد مشابه لازم خواهد بود.

به همین ترتیب، پس از اتصال به برنامه‌های خاص، ترمینال قبلی در یک وضعیت نامعمول رها خواهد شد و ممکن است اجرای
.B clear
یا حتی
.B reset
پیش از آنکه ترمینال قبلی دوباره قابل استفاده شود، لازم باشد.

اتصال به rtorrent (و احتمالاً برخی برنامه‌های دیگر) به درستی کار نمی‌کند (rtorrent پذیرش ورودی را متوقف می‌کند؛ مشکل این است که rtorrent از epoll برای نظارت بر stdin استفاده می‌کند، و ارجاع داخلی fd مربوط به epoll به tty قدیمی به‌روزرسانی نمی‌شود).

اتصال به فرآیندی که دارای فرآیندهای فرزند است به درستی کار نمی‌کند. رفع این مشکل باید امکان‌پذیر باشد -- فقط کافی است تک‌تک فرزندان به طور جداگانه ptrace شده و همین عملیات روی آن‌ها نیز پیاده شود.

اتصال به یک فرآیند
.BR less (1)
در صورتی که فایل
.I .lessfilter
داشته باشید کار نمی‌کند، زیرا در این حالت
.BR less
یک فرزند زامبی (zombie child) باقی می‌گذارد. می‌توان این مشکل را با راهکارهای جانبی برطرف کرد.

اشکالات باید به نویسنده (پایین را ببینید) یا از طریق سامانه پیگیری اشکالات در GitHub گزارش شوند.

.SH "نویسندگان (AUTHORS)"

نرم‌افزار reptyr توسط Nelson Elhage <nelhage@nelhage.com> نوشته شده است.

.SH "وب‌گاه (HOMEPAGE)"

.URL https://github.com/nelhage/reptyr

.SH "همچنین ببینید (SEE ALSO)"

.BR neercs (1),
.BR screen (1)