.\" -*- nroff -*- --------------------------------------------------------- *
.\"  
.\" Copyright (c) 1990, 1993, 1994
.\"     The Regents of the University of California.  All rights reserved.
.\"
.\" Copyright 2001 H. Peter Anvin - All Rights Reserved
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"----------------------------------------------------------------------- */
.TH TFTP 1 "23 July 2008" "tftp-hpa 5.2" "User's Manual"
.SH "نام (NAME)"
.B tftp
\- کلاینت پروتکل ساده انتقال فایل برای IPv4
.SH "خلاصه دستور (SYNOPSIS)"
.B tftp
[ \fIoptions...\fP ]
[\fIhost\fP [\fIport\fP]]
[\fB\-c\fP \fIcommand\fP]
.br
.SH "توضیحات (DESCRIPTION)"
دستور
.B tftp
یک کلاینت برای پروتکل سادهٔ انتقال فایل (Trivial File Transfer Protocol) است که می‌تواند برای انتقال فایل‌ها به و از ماشین‌های دوردست، از جمله برخی سیستم‌های بسیار حداقلی (معمولاً سامانه‌های توکار - embedded)، به کار رود. میزبان دوردست
.I host
را می‌توان در خط فرمان مشخص کرد که در این صورت
.B tftp
از
.I host
به عنوان میزبان پیش‌فرض برای انتقال‌های بعدی استفاده می‌کند (دستور
.B connect
را در ادامه ببینید).
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-4
تنها با IPv4 متصل شود، حتی اگر پشتیبانی از IPv6 کامپایل شده باشد.
.TP
.B \-6
تنها با IPv6 متصل شود، در صورتی که پشتیبانی از آن کامپایل شده باشد.
.TP
\fB\-c\fP \fIcommand\fP
دستور
\fIcommand\fP
را به گونه‌ای اجرا می‌کند که گویی در اعلان خط فرمان tftp وارد شده است. این گزینه باید در انتهای خط فرمان مشخص شود.
.TP
.B \-l
حالت پیش‌فرض را روی حالت لفظی (literal) قرار می‌دهد. برای جلوگیری از پردازش خاص نویسهٔ ':' در نام فایل استفاده می‌شود.
.TP
\fB\-m\fP \fImode\fP
حالت انتقال پیش‌فرض را روی
\fImode\fP
تنظیم می‌کند. این گزینه معمولاً به همراه \-c استفاده می‌شود.
.TP
\fB\-R\fP \fIport:port\fP
شماره پورت مبدأ را وادار می‌کند تا در محدودهٔ مشخص‌شده از شماره پورت‌ها قرار گیرد.
.TP
.B \-v
حالت پیش‌فرض را روی حالت پرگو (verbose) قرار می‌دهد.
.TP
.B \-V
شماره نسخه و پیکربندی را در خروجی استاندارد چاپ کرده و سپس بدون خطا خارج می‌شود.
.SH "دستورها (COMMANDS)"
هنگامی که
.B tftp
در حال اجرا است، اعلان
\f(CWtftp>\fP
را نمایش می‌دهد و دستورهای زیر را شناسایی می‌کند:
.TP
\fB?\fP \fIcommand-name...\fP
.TP
\fBhelp\fP \fIcommand-name...\fP
چاپ اطلاعات راهنما.
.TP
.B ascii
کوتاه‌نوشتی برای
.BR "mode ascii" .
.TP
.B binary
کوتاه‌نوشتی برای
.BR "mode binary" .
.TP
\fBconnect\fP \fIhost [port]\fP
تعیین
.I host
(و به صورت اختیاری
.IR port )
برای انتقال‌ها. توجه داشته باشید که پروتکل TFTP برخلاف پروتکل FTP، اتصالات را میان انتقال‌ها برقرار نگه نمی‌دارد؛ بنابراین دستور
.B connect
در واقع هیچ اتصالی ایجاد نمی‌کند، بلکه تنها به خاطر می‌سپارد که چه میزبانی باید برای انتقال‌ها استفاده شود. نیازی نیست که حتماً از دستور
.B connect
استفاده کنید؛ میزبان دوردست را می‌توان به عنوان بخشی از دستورهای
.B get
یا
.B put
نیز مشخص کرد.
.TP
\fBget\fP \fIfile\fP
.sp -.6l
.TP
\fBget\fP \fIremotefile localfile\fP
.sp -.6l
.TP
\fBget\fP \fIfile1 file2 file3...\fP
دریافت یک فایل یا مجموعه‌ای از فایل‌ها از منابع مشخص‌شده. نام فایل دوردست می‌تواند به یکی از دو شکل باشد: یک نام فایل ساده در میزبان دوردست، در صورتی که میزبان قبلاً مشخص شده باشد؛ یا رشته‌ای به شکل
.I "host:filename"
برای تعیین هم‌زمان میزبان و نام فایل. اگر از شکل دوم استفاده شود، آخرین نام میزبان مشخص‌شده به عنوان پیش‌فرض برای انتقال‌های بعدی در نظر گرفته می‌شود. برای جلوگیری از رفتار ویژه با نویسهٔ ':' (مانند C:\\dir\\file)، حالت
.B literal
را فعال کنید.
.TP
.B literal
تغییر وضعیت حالت لفظی (literal). در صورت فعال بودن، این حالت از برخورد ویژه با ':' در نام فایل‌ها جلوگیری می‌کند.
.TP
\fBmode\fP \fItransfer-mode\fP
مشخص کردن حالت انتقال؛
.I transfer-mode
می‌تواند یکی از مقادیر
.B ascii
(یا
.BR netascii )
یا
.B binary
(یا
.BR octet )
باشد. مقدار پیش‌فرض
.BR ascii
است.
.TP
\fBput\fP \fIfile\fP
.sp -.6l
.TP
\fBput\fP \fIlocalfile remotefile\fP
.sp -.6l
.TP
\fBput\fP \fIfile1 file2 file3... remote-directory\fP
ارسال یک فایل یا مجموعه‌ای از فایل‌ها به فایل یا دایرکتوری دوردست مشخص‌شده. مقصد می‌تواند به یکی از دو شکل باشد: یک نام فایل روی میزبان دوردست، اگر میزبان از قبل مشخص شده باشد؛ یا رشته‌ای به شکل
.I "host:filename"
برای مشخص کردن هم‌زمان میزبان و نام فایل. اگر از شکل دوم استفاده شود، نام میزبان مشخص‌شده به عنوان پیش‌فرض برای انتقال‌های بعدی در نظر گرفته می‌شود. در صورت استفاده از ساختار remote-directory، فرض می‌شود میزبان دوردست یک سیستم یونیکس (UNIX) یا سیستمی دیگر است که از
.B /
به عنوان جداکننده دایرکتوری استفاده می‌کند. برای جلوگیری از رفتار ویژه با نویسهٔ ':' (مانند C:\\dir\\file)، حالت
.B literal
را فعال کنید.
.TP
.B quit
خروج از
.BR tftp .
رسیدن به انتهای فایل (EOF) نیز برنامه را می‌بندد.
.TP
\fBrexmt\fP \fIretransmission-timeout\fP
تنظیم مهلت زمانی ارسال مجدد هر بسته، به ثانیه.
.TP
.B status
نمایش وضعیت فعلی.
.TP
\fBtimeout\fP \fItotal-transmission-timeout\fP
تنظیم مهلت زمانی کل ارسال، به ثانیه.
.TP
.B trace
تغییر وضعیت ردگیری بسته‌ها (یک ویژگی برای خطایابی).
.TP
.B verbose
تغییر وضعیت حالت پرگو (verbose).
.SH "نکات (NOTES)"
پروتکل TFTP هیچ سازوکاری برای احراز هویت یا امنیت فراهم نمی‌کند. بنابراین، کارگزار دوردست احتمالاً انواعی از محدودیت‌های دسترسی یا دیوار آتش (firewall) را پیاده‌سازی خواهد کرد. این محدودیت‌های دسترسی به احتمال زیاد مختص هر پایگاه و سرور خواهد بود.
.SH "نویسنده (AUTHOR)"
این نسخه از
.B tftp
توسط H. Peter Anvin <hpa@zytor.com> نگهداری می‌شود. این برنامه از مبنای کُد منبع OpenBSD مشتق شده، اما به طور قابل توجهی از آن فاصله گرفته است، و وصله‌هایی توسط Markus Gutschke و Gero Kulhman به آن افزوده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR tftpd (8).