Table of Contents

6.1 Ascii

6.1.1 Input Parameters
6.1.2 Normal Response Format
6.1.3 Error Response

6.2 Binary

6.2.1 Input Parameters
6.2.2 Normal Response Format
6.2.3 Error Response

6.3 Cd

6.3.1 Input Parameters
6.3.2 Normal Response Format
6.3.3 Error Response

6.4 Close

6.4.1 Normal Response Format
6.4.2 Error Response

6.5 Exit

6.5.1 Input Parameters
6.5.2 Normal Response Format
6.5.3 Error Response

6.6 Get

6.6.1 Input Parameters
6.6.2 Normal Response Format
6.6.3 Error Response

6.7 Ls

6.7.1 Input Parameters
6.7.2 Normal Response Format
6.7.3 Error Response

6.8 Open

6.8.1 Input Parameters
6.8.2 Normal Response Format
6.8.3 Error Response

6.9 Passive

6.9.1 Input Parameters
6.9.2 Normal Response Format
6.9.3 Error Response

6.10 Put

6.10.1 Input Parameters
6.10.2 Normal Response Format
6.10.3 Error Response

6.11 Pwd

6.11.1 Input Parameters
6.11.2 Normal Response Format
6.11.3 Error Response

6.12 Quit

6.12.1 Input Parameters
6.12.2 Normal Response Format
6.12.3 Error Response

6.13 Status

6.13.1 Input Parameters
6.13.2 Normal Response Format
6.13.3 Error Response

6.14 Syst

6.14.1 Input Parameters
6.14.2 Normal Response Format
6.14.3 Error Response

6.15 User

6.15.1 Input Parameters
6.15.2 Normal Response Format
6.15.3 Error Response

FTP Commands

This chapter provides detailed descriptions of the Cisco ONS 15200 Command Line Interface File Transfer Protocol (FTP) commands supported by ONS 15200 network elements (NEs). The FTP client command group is the user interface to the ARPANET standard FTP. These commands allow a user to transfer files from and to a remote network site. The Network Control Board (NCB) of the ONS 15200 can work both as an FTP server (when you start a new ftp session) and as an FTP client (when you start an FTP client session, using the ftp command, after opening a telnet session).

To use FTP, log in as an administrative user to either the telnet or FTP session.

Note   Normal and error responses may vary between different implementations/interpretations of FTP, so responses listed in this document may not match responses you receive.

6.1 Ascii

The ascii command sets the file transfer mode for the FTP connection to network ASCII (default) mode. Use the network ASCII mode when transferring text files that contain only printable characters, such as the qdbs.cfg file, to the FTP server (using the put command) or from the FTP server (using the get command). The FTP connection remains in network ASCII transfer mode until it is changed by the binary command. See the individual descriptions of these commands in this chapter for more information.

6.1.1 Input Parameters

None.

6.1.2 Normal Response Format

6.1.3 Error Response

6.2 Binary

The binary command sets the file transfer mode to binary mode. Use binary mode when transferring binary image files, such as snm.out, to the FTP server (using the put command) or from the FTP server (using the get command). The FTP connection remains in binary transfer mode until it is changed by the ascii command. See the individual descriptions of these commands for more information.

6.2.1 Input Parameters

None.

6.2.2 Normal Response Format

6.2.3 Error Response

6.3 Cd

The cd command changes the working directory on the FTP server.

6.3.1 Input Parameters

"<path>" is the directory path toward which you are navigating.

6.3.2 Normal Response Format

6.3.3 Error Response

6.4 Close

The close and quit commands end an FTP session. The close command closes the connection to the FTP server without logging you out, which allows you to log onto another ftp server. The quit command logs you out of the FTP server before closing the connection to the server and terminating the FTP session.

6.4.1 Normal Response Format

6.4.2 Error Response

None.

6.5 Exit

The exit command terminates the FTP session and returns you to the previous command mode. Before the command mode changes, you are logged out and the connection to the FTP server is closed (similar to the quit command).

6.5.1 Input Parameters

None.

6.5.2 Normal Response Format

NCB:=

6.5.3 Error Response

6.6 Get

The get command transfers a file from the FTP server to the NCB module (if you are opened the FTP session from a telnet session). Because the current transfer mode is used, before a file is transferred you must set the correct transfer mode. Set the transfer mode to network ASCII mode (using the ascii command) if a text file, such as qdbs.cfg, will be transferred or set the transfer mode to binary (using the binary command) if a binary file, such as snm.out, will be transferred.

Note   To permit FTP data connections, some firewalls require passive mode. If the file transfer fails, enable the FTP client's passive mode using the passive command and try the file transfer again.

6.6.1 Input Parameters

"<file>" is the path to the file on the FTP server that you want to transfer.

6.6.2 Normal Response Format

6.6.3 Error Response

6.7 Ls

The ls command lists the files in a directory on the FTP server when the NCB is the FTP client. Before executing the ls command, the transfer mode must be set to network ASCII mode using the ascii command. If you enter the ls command without specifying a path, the files in the current working directory on the FTP server are listed. Dir is the corresponding command used when the NCB is the FTP server.

Note   To permit FTP data connections, some firewalls require passive mode. If the directory list does not display, enable the FTP client's passive mode using the passive command and try the ls command again.

6.7.1 Input Parameters

"<directory path>" is the path to the directory for which you want to see a list of files.

6.7.2 Normal Response Format

6.7.3 Error Response

6.8 Open

The open command establishes a connection and logs you into an FTP server. First the connection is made, and then the FTP server enters an interactive mode and asks for a user name and password. After the server successfully authenticates your user name and password, you can transfer files from/to the FTP server. If the authentication fails, the connection to the FTP server remains open and you can use the user command to make a new login attempt. The connection to the FTP server remains open until you issue a close, exit, or quit command, or the FTP server shuts down.

If the NCB module's DNS client has been configured, you can use a server name rather than an IP address to identify the FTP server that you need to open. See "General Commands," for information on the dnsconf command.

6.8.1 Input Parameters

"<ip address|server name>" is the IP address or the name of the FTP server where you want to establish a connection.

6.8.2 Normal Response Format

6.8.3 Error Response

6.9 Passive

The passive command toggles the FTP client's passive mode on and off. The default setting is off. Turning the passive mode on causes the FTP client to initiate a separate data connection for directory listings (ls command) and file transfers (put or get command). Passive mode is required for connections through some firewalls.

6.9.1 Input Parameters

None.

6.9.2 Normal Response Format

6.9.3 Error Response

None.

6.10 Put

The put command transfers a file from the NCB module to the FTP server. Because the current transfer mode is used, before transferring a file set the correct transfer mode. Set the transfer mode to network ASCII mode (using the ascii command) if a text file, such as qdbs.cfg, will be transferred or set the transfer mode to binary (using the binary command) if a binary file, such as snm.out, will be transferred.

The file is copied to the current working directory on the FTP server. Use the pwd command can be used to display the path to the current working directory and use the cd command to change the working directory.

Note   To permit FTP data connections, some firewalls require passive mode. If the file transfer fails, enable the FTP client's passive mode using the passive command and try the file transfer again.

6.10.1 Input Parameters

"<file>" represents the file on the NCB module that you want to transfer onto the FTP server.

6.10.2 Normal Response Format

6.10.3 Error Response

6.11 Pwd

The pwd command prints the path of the current working directory on the FTP server.

6.11.1 Input Parameters

None.

6.11.2 Normal Response Format

6.11.3 Error Response

6.12 Quit

The quit command closes an open connection to the FTP server. See the "Close" section for information on the differences between the quit and close commands.

6.12.1 Input Parameters

None.

6.12.2 Normal Response Format

6.12.3 Error Response

6.13 Status

The status command shows the current status of the FTP connection. This command gives information about the following:

• Address of the FTP server to which a connection has been established (if one exists)
  
  
• File transfer type—The default value for this parameter is ascii. You can change the parameter value with the ascii or binary command.
  
  
• File transfer format, structure, and mode—The default values for these parameters are non-print, file, and stream, respectively. The FTP client supports the default settings for these parameters.
  
  
• Passive mode—The default value for this parameter is "off." You can change the value to "on" with the passive command.
  
  

6.13.1 Input Parameters

None.

6.13.2 Normal Response Format

6.13.3 Error Response

6.14 Syst

The syst command shows the type of operating system running on the FTP server.

6.14.1 Input Parameters

None.

6.14.2 Normal Response Format

6.14.3 Error Response

6.15 User

The user command sends a user name and password to an FTP server.

6.15.1 Input Parameters

"<user name>" is the name of the user whose user name and password you want to save to an FTP server.

6.15.2 Normal Response Format

6.15.3 Error Response

Posted: Mon Sep 30 20:31:27 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.