manual/netkit/draft/man1/tftp.1

   1 .\" Copyright (c) 1990 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     from: @(#)tftp.1        5.4 (Berkeley) 4/22/91
  33 .\"     $Id: tftp.1,v 1.11 2000/07/30 23:57:10 dholland Exp $
  34 .\"
  35 .\" Japanese Version Copyright (c) 2000 Yuichi SATO
  36 .\"         all rights reserved.
  37 .\" Translated Fri Aug 18 1995
  38 .\"         by NetBSD jman proj. <jman@spa.is.uec.ac.jp>
  39 .\" Updated and Modified Wed Nov 22 17:46:02 JST 2000
  40 .\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
  41 .\"
  42 .Dd August 15, 1999
  43 .Dt TFTP 1
  44 .Os "Linux NetKit (0.17)"
  45 .\"O .Sh NAME
  46 .Sh Ì¾Á°
  47 .Nm tftp
  48 .\"O .Nd trivial file transfer program
  49 .Nd ´ÊÃ±¤Ê¥Õ¥¡¥¤¥ëÅ¾Á÷¥×¥í¥°¥é¥à
  50 .\"O .Sh SYNOPSIS
  51 .Sh ½ñ¼°
  52 .Nm tftp
  53 .Op Ar host
  54 .\"O .Sh DESCRIPTION
  55 .Sh ÀâÌÀ
  56 .\"O .Nm Tftp
  57 .\"O is the user interface to the Internet
  58 .\"O .Tn TFTP
  59 .\"O (Trivial File Transfer Protocol),
  60 .\"O which allows users to transfer files to and from a remote machine.
  61 .Nm tftp
  62 ¤Ï¡¢Internet
  63 .Tn TFTP
  64 (Trivial File Transfer Protocol, ´Ê°×¥Õ¥¡¥¤¥ëÅ¾Á÷¥×¥í¥È¥³¥ë) ¤Î
  65 ¥æ¡¼¥¶¡¼¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤Ç¤¢¤ë¡£
  66 ¤³¤Î¥×¥í¥°¥é¥à¤Ë¤è¤ê¡¢¥æ¡¼¥¶¡¼¤Ï¥ê¥â¡¼¥È¥Þ¥·¥ó¤ÈÁê¸ß¤Ë¥Õ¥¡¥¤¥ë¤òÅ¾Á÷¤Ç¤¤ë¡£
  67 .\"O The remote
  68 .\"O .Ar host
  69 .\"O may be specified on the command line, in which case
  70 .\"O .Nm tftp
  71 .\"O uses
  72 .\"O .Ar host
  73 .\"O as the default host for future transfers (see the
  74 .\"O .Cm connect
  75 .\"O command below).
  76 ¥ê¥â¡¼¥È¥Û¥¹¥È
  77 .Ar host
  78 ¤ò¥³¥Þ¥ó¥É¥é¥¤¥ó¤«¤é»ØÄê¤Ç¤¤ë¡£
  79 ¤³¤Î¾ì¹ç¡¢
  80 .Nm tftp
  81 ¤Ï
  82 .Ar host
  83 ¤ò¤³¤ì°Ê¸å¤Î¥Õ¥¡¥¤¥ëÅ¾Á÷¤Î¥Ç¥Õ¥©¥ë¥È¥Û¥¹¥È¤È¤·¤Æ»È¤¦
  84 (°Ê²¼¤Î
  85 .Cm connect
  86 ¥³¥Þ¥ó¥É¤ò»²¾È¤¹¤ë¤³¤È)¡£
  87 .\"O .Sh COMMANDS
  88 .Sh ¥³¥Þ¥ó¥É
  89 .\"O Once
  90 .\"O .Nm tftp
  91 .\"O is running, it issues the prompt
  92 .\"O .LI tftp>
  93 .\"O and recognizes the following commands:
  94 .Nm tftp
  95 ¤òµ¯Æ°¤¹¤ë¤È¡¢¥×¥í¥ó¥×¥È
  96 .LI tftp>
  97 ¤òÉ½¼¨¤·¤Æ¡¢°Ê²¼¤Î¥³¥Þ¥ó¥É¤òÇ§¼±¤¹¤ë¡£
  98 .Pp
  99 .Bl -tag -width verbose -compact
 100 .It Cm \&? Ar command-name ...
 101 .\"O Print help information.
 102 ¥Ø¥ë¥×¾ðÊó¤òÉ½¼¨¤¹¤ë¡£
 103 .Pp
 104 .It Cm ascii
 105 .\"O Shorthand for "mode ascii"
 106 "mode ascii" ¤ÎÎ¬¡£
 107 .Pp
 108 .It Cm binary
 109 .\"O Shorthand for "mode binary"
 110 "mode binary" ¤ÎÎ¬¡£
 111 .Pp
 112 .It Cm connect Ar host-name Op Ar port
 113 .\"O Set the
 114 .\"O .Ar host
 115 .\"O (and optionally
 116 .\"O .Ar port )
 117 .\"O for transfers.
 118 Å¾Á÷¤ò¹Ô¤¦¤¿¤á¤Î¥Û¥¹¥È
 119 .Ar host
 120 (¥ª¥×¥·¥ç¥ó¤È¤·¤Æ¥Ý¡¼¥ÈÈÖ¹æ
 121 .Ar port )
 122 ¤òÀßÄê¤¹¤ë¡£
 123 .\"O Note that the
 124 .\"O .Tn TFTP
 125 .\"O protocol, unlike the
 126 .\"O .Tn FTP
 127 .\"O protocol,
 128 .\"O does not maintain connections betweeen transfers; thus, the
 129 .\"O .Cm connect
 130 .\"O command does not actually create a connection,
 131 .\"O but merely remembers what host is to be used for transfers.
 132 .Tn TFTP
 133 ¥×¥í¥È¥³¥ë¤Ï¡¢
 134 .Tn FTP
 135 ¥×¥í¥È¥³¥ë¤È°ã¤¤¡¢
 136 Å¾Á÷Ãæ¤ÎÀÜÂ³¤ò´ÉÍý¤·¤Ê¤¤ÅÀ¤ËÃí°Õ¤¹¤ë¤³¤È¡£
 137 ¤è¤Ã¤Æ¡¢
 138 .Cm connect
 139 ¥³¥Þ¥ó¥É¤Ï¡¢¼ÂºÝ¤ËÀÜÂ³¤ò³ÎÎ©¤¹¤ë¤Î¤Ç¤Ï¤Ê¤¯¡¢
 140 Ã±¤Ë¤É¤Î¥Û¥¹¥È¤¬Å¾Á÷¤Ë»È¤ï¤ì¤ë¤Î¤«¤òµ²±¤¹¤ë¤À¤±¤Ç¤¢¤ë¡£
 141 .\"O You do not have to use the
 142 .\"O .Cm connect
 143 .\"O command; the remote host can be specified as part of the
 144 .\"O .Cm get
 145 .\"O or
 146 .\"O .Cm put
 147 .\"O commands.
 148 ¥æ¡¼¥¶¡¼¤Ï
 149 .Cm connect
 150 ¥³¥Þ¥ó¥É¤ò»È¤¦É¬Í×¤Ï¤Ê¤¯¡¢
 151 ¥ê¥â¡¼¥È¥Û¥¹¥È¤Ï
 152 .Cm get
 153 ¤ä
 154 .Cm put
 155 ¥³¥Þ¥ó¥É¤ò»È¤¦¤È¤¤Ë»ØÄê¤Ç¤¤ë¡£
 156 .Pp
 157 .It Cm get Ar filename
 158 .It Cm get Ar remotename localname
 159 .It Cm get Ar file1 file2 ...  fileN
 160 .\"O Get a file or set of files from the specified
 161 .\"O .Ar sources .
 162 .\"O .Ar Source
 163 .\"O can be in one of two forms:
 164 .\"O a filename on the remote host, if the host has already been specified,
 165 .\"O or a string of the form
 166 .\"O .Ar hosts:filename
 167 .\"O to specify both a host and filename at the same time.
 168 .\"O If the latter form is used,
 169 .\"O the last hostname specified becomes the default for future transfers.
 170 »ØÄê¤·¤¿Å¾Á÷¸µ
 171 .Ar source
 172 ¤«¤é¥Õ¥¡¥¤¥ë¤ò¼èÆÀ¤¹¤ë¡£
 173 Å¾Á÷¸µ
 174 .Ar source
 175 ¤Î»ØÄêÊýË¡¤Ï 2 ÄÌ¤ê¤¢¤ë¡£
 176 ¥Û¥¹¥È¤¬´û¤Ë»ØÄê¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¡¢¥ê¥â¡¼¥È¥Û¥¹¥È¾å¤Î¥Õ¥¡¥¤¥ëÌ¾¤ò»ØÄê¤¹¤ë¡£
 177 ¤â¤·¤¯¤Ï
 178 .Ar hosts:filename
 179 ¤È¤¤¤¦·Á¼°¤Ç¡¢¥Û¥¹¥È¤È¥Õ¥¡¥¤¥ëÌ¾¤òÆ±»þ¤Ë»ØÄê¤¹¤ë¡£
 180 ¸å¼Ô¤Î·Á¼°¤ò»È¤Ã¤¿¾ì¹ç¡¢
 181 ºÇ¸å¤Ë»ØÄê¤µ¤ì¤¿¥Û¥¹¥ÈÌ¾¤¬°Ê¹ß¤Î¥Õ¥¡¥¤¥ëÅ¾Á÷¤Î¥Ç¥Õ¥©¥ë¥È¤Ë¤Ê¤ë¡£
 182 .Pp
 183 .It Cm mode Ar transfer-mode
 184 .\"O Set the mode for transfers;
 185 .\"O .Ar transfer-mode
 186 .\"O may be one of
 187 .\"O .Em ascii
 188 .\"O or
 189 .\"O .Em binary .
 190 .\"O The default is
 191 .\"O .Em ascii .
 192 Å¾Á÷¥â¡¼¥É¤òÀßÄê¤¹¤ë¡£
 193 .Ar transfer-mode
 194 ¤Ï
 195 .Em ascii
 196 ¤Þ¤¿¤Ï
 197 .Em binary
 198 ¤Ç¤¢¤ë¡£
 199 ¥Ç¥Õ¥©¥ë¥È¤Ï
 200 .Em ascii
 201 ¤Ç¤¢¤ë¡£
 202 .Pp
 203 .It Cm put Ar file
 204 .It Cm put Ar localfile remotefile
 205 .It Cm put Ar file1 file2 ... fileN remote-directory
 206 .\"O Put a file or set of files to the specified
 207 .\"O remote file or directory.
 208 .\"O The destination
 209 .\"O can be in one of two forms:
 210 .\"O a filename on the remote host, if the host has already been specified,
 211 .\"O or a string of the form
 212 .\"O .Ar hosts:filename
 213 .\"O to specify both a host and filename at the same time.
 214 .\"O If the latter form is used,
 215 .\"O the hostname specified becomes the default for future transfers.
 216 .\"O If the remote-directory form is used, the remote host is
 217 .\"O assumed to be a
 218 .\"O .Tn UNIX
 219 .\"O machine.
 220 »ØÄê¤·¤¿¥ê¥â¡¼¥È¥Õ¥¡¥¤¥ë¤ä¥ê¥â¡¼¥È¥Ç¥£¥ì¥¯¥È¥ê¤Ë¥Õ¥¡¥¤¥ë¤òÅ¾Á÷¤¹¤ë¡£
 221 Å¾Á÷Àè¤Î»ØÄêÊýË¡¤Ï 2 ÄÌ¤ê¤¢¤ë¡£
 222 ¥Û¥¹¥È¤¬´û¤Ë»ØÄê¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¡¢¥ê¥â¡¼¥È¥Û¥¹¥È¾å¤Î¥Õ¥¡¥¤¥ëÌ¾¤ò»ØÄê¤¹¤ë¡£
 223 ¤â¤·¤¯¤Ï
 224 .Ar hosts:filename
 225 ¤È¤¤¤¦·Á¼°¤Ç¡¢¥Û¥¹¥È¤È¥Õ¥¡¥¤¥ëÌ¾¤òÆ±»þ¤Ë»ØÄê¤¹¤ë¡£
 226 ¸å¼Ô¤Î·Á¼°¤ò»È¤Ã¤¿¾ì¹ç¡¢
 227 ºÇ¸å¤Ë»ØÄê¤µ¤ì¤¿¥Û¥¹¥ÈÌ¾¤¬°Ê¹ß¤Î¥Õ¥¡¥¤¥ëÅ¾Á÷¤Î¥Ç¥Õ¥©¥ë¥È¤Ë¤Ê¤ë¡£
 228 ¥ê¥â¡¼¥È¥Ç¥£¥ì¥¯¥È¥ê¤ò»ØÄê¤¹¤ë·Á¼°¤ò»È¤Ã¤¿¾ì¹ç¡¢
 229 ¥ê¥â¡¼¥È¥Û¥¹¥È¤Ï
 230 .Tn UNIX
 231 ¥Þ¥·¥ó¤È¤ß¤Ê¤µ¤ì¤ë¡£
 232 .Pp
 233 .It Cm quit
 234 .\"O Exit
 235 .\"O .Nm tftp .
 236 .\"O An end of file also exits.
 237 .Nm tftp
 238 ¤ò½ªÎ»¤¹¤ë¡£
 239 end of file ¤Ç¤â½ªÎ»¤¹¤ë¡£
 240 .Pp
 241 .It Cm rexmt Ar retransmission-timeout
 242 .\"O Set the per-packet retransmission timeout, in seconds.
 243 ¥Ñ¥±¥Ã¥ÈËè¤ÎºÆÁ÷¥¿¥¤¥à¥¢¥¦¥È»þ´Ö¤òÉÃÃ±°Ì¤ÇÀßÄê¤¹¤ë¡£
 244 .Pp
 245 .It Cm status
 246 .\"O Show current status.
 247 ¸½ºß¤Î¾õÂÖ¤òÉ½¼¨¤¹¤ë¡£
 248 .Pp
 249 .It Cm timeout Ar total-transmission-timeout
 250 .\"O Set the total transmission timeout, in seconds.
 251 Á´ÂÎ¤ÎÅ¾Á÷¥¿¥¤¥à¥¢¥¦¥È»þ´Ö¤òÉÃÃ±°Ì¤ÇÀßÄê¤¹¤ë¡£
 252 .Pp
 253 .It Cm trace
 254 .\"O Toggle packet tracing.
 255 ¥Ñ¥±¥Ã¥È¥È¥ì¡¼¥¹µ¡Ç½¤Î»ÈÍÑ¡¦ÉÔ»ÈÍÑ¤òÀÚÂØ¤¨¤ë¡£
 256 .Pp
 257 .It Cm verbose
 258 .\"O Toggle verbose mode.
 259 ¾ÜºÙÉ½¼¨¥â¡¼¥É¤Î»ÈÍÑ¡¦ÉÔ»ÈÍÑ¤òÀÚÂØ¤¨¤ë¡£
 260 .El
 261 .\"O .Sh BUGS
 262 .Sh ¥Ð¥°
 263 .Pp
 264 .\"O Because there is no user-login or validation within
 265 .\"O the
 266 .\"O .Tn TFTP
 267 .\"O protocol, the remote site will probably have some
 268 .\"O sort of file-access restrictions in place.  The
 269 .\"O exact methods are specific to each site and therefore
 270 .\"O difficult to document here.
 271 .Tn TFTP
 272 ¥×¥í¥È¥³¥ë¤Ë¤Ï¡¢¥æ¡¼¥¶¡¼¥í¥°¥¤¥ó¤äÇ§¾Ú¤¬¤Ê¤¤¤Î¤Ç¡¢
 273 ¥ê¥â¡¼¥È¥µ¥¤¥È¤Ë¤Ï²¿¤é¤«¤Î¥Õ¥¡¥¤¥ë¥¢¥¯¥»¥¹À©¸Â¤¬
 274 Å¬ÀÚ¤ËÀßÄê¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤¬¤¢¤ë¡£
 275 ¾Ü¤·¤¤ÊýË¡¤Ï¥µ¥¤¥ÈËè¤Ë°Û¤Ê¤ë¤Î¤Ç¡¢¤³¤³¤Ç¤Ïµ½Ò¤·¤¤ì¤Ê¤¤¡£
 276 .\"O .Sh HISTORY
 277 .Sh ÍúÎò
 278 .\"O The
 279 .\"O .Nm
 280 .\"O command appeared in
 281 .\"O .Bx 4.3 .
 282 .Nm
 283 ¥³¥Þ¥ó¥É¤Ï
 284 .Bx 4.3
 285 ¤ÇÅÐ¾ì¤·¤¿¡£
 286 .Sh ËÝÌõ¼Ô¼Õ¼
 287 ¤³¤Î man ¥Ú¡¼¥¸¤ÎËÝÌõ¤Ë¤¢¤¿¤ê¡¢
 288 FreeBSD jpman project <http://www.jp.freebsd.org/man-jp/>
 289 ¤Ë¤è¤ëËÝÌõ¤ò»²¹Í¤Ë¤µ¤»¤Æ¤¤¤¿¤À¤¤¤¿¡£