src/usr.bin/tftp/tftp.1 - diff

Return to tftp.1 CVS log

Up to [local] / src / usr.bin / tftp

Diff for /src/usr.bin/tftp/tftp.1 between version 1.7 and 1.8

version 1.7, 2003/06/03 02:56:18

version 1.8, 2003/09/25 09:45:46

Line 39

.Sh SYNOPSIS

.Nm tftp

.Op Ar host

.Op Ar port

.Sh DESCRIPTION

.Nm

is the user interface to the Internet

Line 47

Line 48

which allows users to transfer files to and from a remote machine.

The remote

.Ar host

and

.Ar port

may be specified on the command line, in which case

.Nm

uses

uses them as the default for future transfers (see the

.Ar host

as the default host for future transfers (see the

.Ic connect

command below).

.Sh COMMANDS

Line 67

Line 68

.Pp

.It Ic ascii

Shorthand for

.Ic mode ascii .

.Ic mode Ar ascii .

.Pp

.It Ic binary

Shorthand for

.Ic mode binary .

.Ic mode Ar binary .

.Pp

.It Ic connect Ar host Op Ar port

Set the

Line 96

Line 97

.Ic put

commands.

.Pp

.It Ic get Ar filename

.It Xo

.It Ic get Ar remotename localname

.Ic get Oo Ar host Ns : Oc Ns

.It Ic get Ar file Op Ar ...

.Ar file Op Ar localname

Get a file or set of files from the specified

.Xc

.Ar sources .

.It Xo

.Ar source

.Ic get Oo Ar host1 Ns : Oc Ns

can be in one of two forms:

.Ar file1

a filename on the remote host, if the host has already been specified,

.Oo Ar host2 Ns : Oc Ns

or a string of the form

.Ar file2

.Ar hosts:filename

.Ar ...

to specify both a host and filename at the same time.

.Oo Ar hostN Ns : Oc Ns

If the latter form is used,

.Ar fileN

the last hostname specified becomes the default for future transfers.

.Xc

Get a file or set of files from the remote host.

When using the

.Ar host

argument, the

.Ar host

will be used as the default host for future transfers.

.Ar localname

is specified,

the file is stored locally as

.Ar localname ,

otherwise the original filename is used.

.Pp

Note that it is not possible to download two files at the same time;

only one, three, or more than three files

can be downloaded at the same time.

.Pp

.It Ic mode Ar transfer-mode

Set the mode for transfers;

.Ar transfer-mode

may be one of

.Ic ascii

.Ar ascii

.Ic binary .

.Ar binary .

The default is

.Ic ascii .

.Ar ascii .

.Pp

.It Ic put Ar file

.It Xo

.It Ic put Ar localfile remotefile

.Ic put Ar file

.It Ic put Ar file1 file2 ... fileN remote-directory

.Oo Oo Ar host Ns : Oc Ns

Put a file or set of files to the specified

.Ar remotename Oc

remote file or directory.

.Xc

The destination

.It Xo

can be in one of two forms:

.Ic put Ar file1 file2 ... fileN

a filename on the remote host, if the host has already been specified,

.Oo Oo Ar host Ns : Oc Ns

or a string of the form

.Ar remote-directory Oc

.Ar hosts:filename

.Xc

to specify both a host and filename at the same time.

Put a file or set of files to the remote host.

If the latter form is used,

When using the

the hostname specified becomes the default for future transfers.

.Ar host

If the remote-directory form is used, the remote host is

argument, the

assumed to be a

.Ar host

will be used as the default host for future transfers.

.Ar remotename

is specified, the file is stored remotely as

.Ar remotename ,

otherwise the original filename is used.

If the

.Ar remote-directory

argument is used, the remote host is assumed to be a

.Tn UNIX

machine.

.Pp

Note that files may only be written to if they already exist on the

remote host and are publicly writable.

See

.Xr tftpd 8

for further details.

.Pp

.It Ic quit

Exit

.Nm tftp .

Line 159

Line 191

Toggle verbose mode.

.El

.Sh SEE ALSO

.Xr ftp 1

.Xr ftp 1 ,

.Xr tftpd 8

.Sh HISTORY

The

.Nm

Line 173

Line 206

sort of file access restrictions in place.

The exact methods are specific to each site and therefore

difficult to document here.

.Pp

Files larger than 33488896 octets (65535 blocks) cannot be transferred

without client and server supporting blocksize negotiation (RFC 1783).

.Pp

Many tftp clients will not transfer files over 16744448 octets (32767 blocks).