Windows NT 4.0 source code leak
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

241 lines
8.9 KiB

SUMMARY: multinet network file transfer program
KEYWORDS: ftp vtp
USAGE: ftp [ -a ] [ -n ] [ host ]
SWITCHES
-n Suppresses the program's automatic login attempt. If
automatic login is enabled, ftp checks the accounts.net
file in the user's home directory for an entry that
describes an account on the remote machine. If no such
account is found, the user is prompted for a login name
and password.
-a Startup with ascii file transfer mode. See below.
Normal startup mode is binary.
DESCRIPTION
The file transfer program lets an MS-DOS or OS/2 user
transfer files to and from any remote XENIX system
(host) on the network.
If users request a remote system on the ftp command line,
ftp immediately attempts to establish a connection to an ftp
server on that host. Otherwise, ftp enters its command
interpreter and awaits instructions from the user.
The file transfer program recognizes a special list of
commands. Command arguments that have imbedded spaces can
be denoted by quotation (") marks.
The following commands are recognized by ftp:
? ftp prints a list of available commands.
The help command is a synonym for ?.
! Invokes the command interpreter on the local
machine.
ascii Sets the file transfer type to network ASCII.
When transferring text files in ascii mode, ftp
converts back and forth between the XENIX linefeed
end-of-line convention and the DOS carriage
return/linefeed end-of-line convention.
bell Arranges for a bell to be sounded after each file
transfer command is completed. Turn off the bell
by typing 'nobell'.
binary Sets the file transfer type to support image
(binary) transfer. In this mode, files are
transferred as is, with no mapping of characters.
bye Terminates the ftp session with the remote server
and exits ftp. The quit command is a synonym for
bye.
commandfile <filename>
Read and execute commands from local <filename>
cd remotedirectory
Changes the working directory on the remote
machine to remotedirectory.
delete remotefile
Deletes the file remotefile on the remote machine.
dir [ remotedirectory ] [ localfile ]
Prints a listing of the directory contents in the
directory remotedirectory. If no directory is
specified, the current working directory on the
remote machine is used. If a localfile is
specified, dir places the output in the local
file. Otherwise, output comes to the terminal.
get remotefile [ localfile ]
Retrieves remotefile and stores it on the local
machine. If the local file name is not specified,
remotefile is used as the local name. The current
settings for form, mode, structure, and type are
used while transferring the file.
hash Turn on hashing display. Hashing display shows
a '#' mark for every packet sent or received during
file transfer. See nohash.
help
FTP prints a list of available commands and
command aliases. The ? command is a synonym for help.
interactive
Set the interactive mode on. Interactive mode
prompts the user file by file for mget and mdelete
commands. Se nointeractive.
lcd [ directory ]
Changes the working directory on the local
machine. If no directory is specified, the user's
home directory is used.
ls [ remotedirectory ] [ localfile ]
Prints an abbreviated list of a remote directory's
contents. If remotedirectory is left unspecified,
the current working directory is used. If no
local file is specified, the output is sent to the
terminal.
mdelete <filespec>
Delete multiple files on the remote system
according to <filespec>.
mget <filespec>
Get multiple files from remote according to <filespec>
See warning below.
mput <filespec>
Put multiple files to remote. Not currently
implemented for DOS or OS/2.
nohash Turn off hashing display. See hash.
nointeractive
Turn off interactive mode. See interactive.
nobell Turn the bell off. See bell.
put localfile [ remotefile ]
Sends a local file to the remote machine. If
remotefile is left unspecified, localfile is used
as the remote name. File transfer uses the
current settings for form, mode, structure, and
type.
quit Terminates the ftp session with the remote server
and exits ftp. The bye command is a synonym for
quit.
quiet Turn off verbose mode. Do not show file transfer
statistics.
remotehelp
Requests help from the remote ftp server.
rename [ from ] [ to ]
Renames the from file on the remote machine, to
the remote to file.
user username [ password ] [ account ]
Identifies the user to the remote ftp server. If
password is not specified, ftp prompts the user
for it (after disabling local echo). If account
(group name) is not specified, and the ftp server
requires it, the user is prompted for it. Unless
ftp is invoked with automatic login disabled, this
process is done automatically on initial
connection to the ftp server.
verbose Turn on verbose mode. If verbose mode is on,
transfer efficiency statistics are reported
when a file transfer completes. By default,
verbose mode is on. See quiet.
RETURN VALUE
NOTES
File Naming Conventions
Files specified as arguments to ftp commands are processed
according to the following rules:
1) If a dash (-) is specified as the filename, standard
input (for reading) or standard output (for writing) is
used.
2) If the first character of a remote file name is an exclamation
point (!), the remainder of the argument is interpreted
as a shell command. Ftp then forks a shell, using
popen(S) with the argument supplied, and reads from the
standard output (or writes from the standard input). If
the shell command includes spaces, the argument must be
put in quotation marks. For example:
get !date
will retreive the date from the remote system.
File Transfer Parameters
Ftp supports the ASCII and image (binary) types of file transfer.
When using image (binary) type transfer, bytes of
a file are transferred as is, with no transformation. When
using ASCII type transfer, a file is converted as it is
sent over the network. For DOS and OS/2, the
carriage RETURN/LINEFEED (CR/LF) sequence is used to mark
the end of a line of text. For Xenix, linefeed only.
The accounts.net file is used mainly when the username on
the remote system is different from the username on the
local system. Each line of the accounts.net file contains
four fields, separated by blanks or tabs:
1) System name.
2) Username.
3) Optional password. If the password field contains a dash
(-) ftp prompts the user for the password.
4) Optional account (group name).
Warnings
If ftp is interrupted while it is transferring data, the
program is terminated, and a partial or incomplete file
may result at the destination.
While performing mget operations, the ftp program reads
the filenames of subdirectories and attempts to transfer
those files but will not succeed, and the user will see
"can't find file" messages.
Binary type should be used instead of ASCII type to transfer
executable files, object files, or other files containing
binary data, since the carriage return/linefeed conversions
may introduce errors into these files.
EXAMPLES
ftp -a host put asciifile
ftp host get !date