.\" This file is part of GNU tar. -*- nroff -*- .\" Copyright 2013, 2018, 2023 Free Software Foundation, Inc. .\" .\" GNU tar is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 3 of the License, or .\" (at your option) any later version. .\" .\" GNU tar is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . .TH "RMT" "8" "مه ۲۰۲۵" "tar" "دستورات مدیریت سیستم" .SH "نام (NAME)" rmt \- کنترل ابزار نوار مغناطیسی از راه دور .SH "خلاصه دستور (SYNOPSIS)" .B rmt .SH "توضیحات (DESCRIPTION)" دستور \fBrmt\fR توسط برنامههایی مانند tar و cpio برای دسترسی به درایوهای نوار مغناطیسی و دستگاههای ذخیرهسازی از طریق شبکه اجرا میشود. این ابزار معمولاً با اجرای .BR rsh (1) یا .BR ssh (1) به ماشین راه دور فراخوانی می‌شود و در صورت تمایل می‌تواند از نام کاربری دیگری برای ورود استفاده کند. .PP برنامه فراخواننده از طریق ارسال درخواست‌ها بر روی ورودی استاندارد و خواندن پاسخ‌ها از خروجی استاندارد با .B rmt ارتباط برقرار می‌کند. یک درخواست شامل یک نویسه مشخص‌کننده درخواست، به همراه آرگومان (در صورت نیاز) و یک نویسه خط جدید است. داده‌های تکمیلی، در صورت وجود، پس از خط جدید ارسال می‌شوند. در صورت موفقیت، .B rmt پاسخ زیر را برمی‌گرداند: .PP .in +4 .BI A number \en .PP که در آن \fInumber\fR نمایش اَسکی از یک کد بازگشتی ده‌دهی است. داده‌های تکمیلی پس از این خط برگردانده می‌شوند. در صورت بروز خطا، پاسخ زیر برگردانده می‌شود: .PP .in +4 .BI E errno \en error-message \en .PP که در آن \fIerrno\fR یکی از کدهای خطای سیستم است، همان‌طور که در .BR errno (3) شرح داده شده است، و \fIerror-message\fR یک توصیف تک‌خطی و خوانا برای انسان از خطاست، به همان شکل که توسط .BR perror (3) چاپ می‌شود. .PP دستورات موجود و پاسخ‌های ممکن در بخش بعدی به تفصیل شرح داده شده‌اند. .SH "دستورات (COMMANDS)" .TP .BI O device \en flags \en دستگاه \fIdevice\fR را با فلگ‌های داده‌شده \fIflags\fR باز می‌کند. اگر دستگاهی قبلاً باز شده باشد، پیش از باز کردن دستگاه جدید بسته می‌شود. .sp .B آرگومان‌ها .RS .TP .I device نام دستگاهی که باید باز شود. .TP .I flags فلگ‌ها برای فراخوانی .BR open (2): یک عدد ده‌دهی، یا هر ثابت معتبر \fBO_*\fR از .B fcntl.h (پیشوند اولیه \fBO_\fR را می‌توان نادیده گرفت)، یا ترکیب بیتی (با استفاده از \fB|\fR) از هر تعداد از آن‌ها، مانند: .in +4 .EX 576 64|512 CREAT|TRUNC .EE .RS علاوه بر این، شکل ترکیبی نیز مجاز است؛ یعنی یک حالت ده‌دهی که به دنبال آن نمایش نمادین آن می‌آید. در این حالت به نمایش نمادین اولویت داده می‌شود. .RE .sp .B پاسخ .RS .B A0\en در صورت موفقیت. .RE .sp .B افزونه‌ها .RS نسخه BSD فقط عدد ده‌دهی را به عنوان \fIflags\fR می‌پذیرد. .RE 1 .TP \fBC\fR[\fIdevice\fR]\fB\en\fR دستگاهِ در حال حاضر باز را می‌بندد. .RS .TP .B آرگومان‌ها .br هرگونه آرگومانی بدون هیچ پیامی نادیده گرفته می‌شود. .TP .B پاسخ .br .B A0\en در صورت موفقیت. .RE .TP .BI L whence \en offset \en .RS یک عملیات .BR lseek (2) را با پارامترهای مشخص‌شده بر روی دستگاه فعلی باز انجام می‌دهد. .TP .B آرگومان‌ها .RS .TP .I whence مبدأ محاسبه فاصله (offset). مقادیر معتبر عبارتند از: .sp .nf .ta 1n 20n 0, SET, SEEK_SET جستجو از ابتدای فایل 1, CUR, SEEK_CUR جستجو از موقعیت فعلی 2, END, SEEK_END جستجو از انتهای فایل .fi .RE .TP .B پاسخ .br .BI A offset \en در صورت موفقیت. مقدار \fIoffset\fR موقعیت جدید در فایل است. .TP .B افزونه‌ها نسخه BSD فقط 0,1,2 را به عنوان \fIwhence\fR می‌پذیرد. .RE .TP .BI R count \en .br به میزان \fIcount\fR بایت داده از دستگاه فعلی می‌خواند. .RS .TP .B آرگومان‌ها .RS .TP .I count تعداد بایت‌هایی که باید خوانده شود. .RE .TP .B پاسخ .br در صورت موفقیت: .sp .in +4 .BI A rdcount \en .in .sp و پس از آن \fIrdcount\fR بایت از داده‌های خوانده‌شده از دستگاه می‌آید. .RE .TP .BI W count \en داده‌ها را بر روی دستگاه فعلی می‌نویسد. این دستور با \fIcount\fR بایت داده ورودی همراه است. .RS .TP .B آرگومان‌ها .RS .TP .I count تعداد بایت‌هایی که باید نوشته شود. .RE .TP .B پاسخ .br در صورت موفقیت: \fBA\fIwrcount\fB\en\fR، که در آن \fIwrcount\fR تعداد بایت‌های واقعاً نوشته‌شده است. .RE .TP .BI I opcode \en count \en یک دستور .BR ioctl (2) از نوع .B MTIOCOP را با پارامترهای مشخص‌شده اجرا می‌کند. .RS .TP .B آرگومان‌ها .RS .TP .I opcode کد عملیاتی .BR MTIOCOP . .TP .I count مقدار mt_count. .RE .TP .B پاسخ .br در صورت موفقیت: \fBA0\en\fR. .RE .TP .B S\en وضعیت دستگاه باز فعلی را مطابق با آنچه از فراخوانی .B MTIOCGET در .BR ioctl (2) به دست می‌آید برمی‌گرداند. .RS .TP .B آرگومان‌ها .br هیچ .TP .B پاسخ .br در صورت موفقیت: \fBA\fIcount\fB\en\fR و در ادامه \fIcount\fR بایت داده. .RE .SH "همچنین ببینید (SEE ALSO)" .BR tar (1). .SH "اشکالات (BUGS)" استفاده از این ابزار به عنوان یک ابزار عمومی برای دسترسی راه دور به فایل‌ها توصیه نمی‌شود. .SH "گزارش اشکالات (BUG REPORTS)" گزارش اشکالات را به بفرستید. .SH "تاریخچه (HISTORY)" دستور .B rmt نخستین بار در 4.2BSD ظاهر شد. نگارش گنو .BR rmt با استفاده از مشخصات BSD از پایه بازنویسی شده است. .SH "حق نشر (COPYRIGHT)" Copyright \(co 2013, 2018 Free Software Foundation, Inc. .br .na License GPLv3+: GNU GPL version 3 or later .br .ad این یک نرم‌افزار آزاد است: شما می‌توانید آن را تغییر داده یا بازتوزیع کنید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.