List of FTP server return codes

Last updated August 23, 2024

FTP server return codes always have three digits, and each digit has a special meaning.^[1] The first digit denotes whether the response is good, bad or incomplete:

Range	Purpose
`1xx`	Positive Preliminary reply The requested action is being initiated; expect another reply before proceeding with a new command. (The user-process sending another command before the completion reply would be in violation of protocol; but server-FTP processes should queue any commands that arrive while a preceding command is in progress.) This type of reply can be used to indicate that the command was accepted and the user-process may now pay attention to the data connections, for implementations where simultaneous monitoring is difficult. The server-FTP process may send at most, one 1xx reply per command.
`2xx`	Positive Completion reply The requested action has been successfully completed. A new request may be initiated.
`3xx`	Positive Intermediate reply The command has been accepted, but the requested action is being held in abeyance, pending receipt of further information. The user should send another command specifying this information. This reply is used in command sequence groups.
`4xx`	Transient Negative Completion reply The command was not accepted and the requested action did not take place, but the error condition is temporary and the action may be requested again. The user should return to the beginning of the command sequence, if any. It is difficult to assign a meaning to "transient", particularly when two distinct sites (Server- and User-processes) have to agree on the interpretation. Each reply in the 4xx category might have a slightly different time value, but the intent is that the user-process is encouraged to try again. A rule of thumb in determining if a reply fits into the 4xx or the 5xx (Permanent Negative) category is that replies are 4xx if the commands can be repeated without any change in command form or in properties of the User or Server (e.g., the command is spelled the same with the same arguments used; the user does not change his file access or user name; the server does not put up a new implementation.)
`5xx`	Permanent Negative Completion reply The command was not accepted and the requested action did not take place. The User-process is discouraged from repeating the exact request (in the same sequence). Even some "permanent" error conditions can be corrected, so the human user may want to direct his User-process to reinitiate the command sequence by direct action at some point in the future (e.g., after the spelling has been changed, or the user has altered his directory status.)
`6xx`	Protected reply RFC 2228 introduced the concept of protected replies to increase security over FTP communications. The 6xx replies are Base64 encoded protected messages that serves as responses to secure commands. When properly decoded, these replies fall into the above categories.

The second digit is a grouping digit and encodes the following information:

Range	Purpose
`x0x`	Syntax These replies refer to syntax errors, syntactically correct commands that don't fit any functional category, unimplemented or superfluous commands.
`x1x`	Information These are replies to requests for information, such as status or help.
`x2x`	Connections Replies referring to the control and data connections.
`x3x`	Authentication and accounting Replies for the login process and accounting procedures.
`x4x`	Unspecified as of RFC 959.
`x5x`	File system These replies indicate the status of the Server file system vis-a-vis the requested transfer or other file system action.

Below is a list of all known return codes that may be issued by an FTP server.

Code	Explanation
`100 Series`	The requested action is being initiated, expect another reply before proceeding with a new command.
`110`	Restart marker replay . In this case, the text is exact and not left to the particular implementation; it must read: `MARK yyyy = mmmm` where yyyy is User-process data stream marker, and mmmm server's equivalent marker (note the spaces between markers and "=").
`120`	Service ready in nnn minutes.
`125`	Data connection already open; transfer starting.
`150`	File status okay; about to open data connection.
`200 Series`	The requested action has been successfully completed.
`202`	Command not implemented, superfluous at this site.
`211`	System status, or system help reply.
`212`	Directory status.
`213`	File status.
`214`	Help message. Explains how to use the server or the meaning of a particular non-standard command. This reply is useful only to the human user.
`215`	NAME system type. Where NAME is an official system name from the registry kept by IANA.
`220`	Service ready for new user.
`221`	Service closing control connection. Logged out if appropriate.
`225`	Data connection open; no transfer in progress.
`226`	Closing data connection. Requested file action successful (for example, file transfer or file abort).
`227`	Entering Passive Mode (h1,h2,h3,h4,p1,p2).
`228`	Entering Long Passive Mode (long address, port).
`229`	Entering Extended Passive Mode (\|\|\|port\|).
`230`	User logged in, proceed.
`232`	User logged in, authorized by security data exchange.
`234`	Server accepts the security mechanism specified by the client; no security data needs to be exchanged.
`235`	Server accepts the security data given by the client; no further security data needs to be exchanged.
`250`	Requested file action was okay, completed.
`300 Series`	The command is not acceptable, but the requested action is on hold, pending receipt of further information.
`331`	User name okay, password okay.
`332`	No need account for login.
`334`	Server accepts the security mechanism specified by the client; some security data needs to be exchanged.
`336`	Username okay, password okay. Challenge is "....".
`421`	Service available, closing control connection. This may be a reply to any command if the service knows it must shut down.
`425`	open data connection.
`426`	Connection closed; transfer aborted.
`430`	Invalid username or password
`431`	Need some unavailable resource to process security.
`434`	Requested host unavailable.
`450`	Requested file action not taken.
`451`	Requested action aborted. Local error in processing.
`452`	Requested action not taken. Insufficient storage space in system. File unavailable (e.g., file busy).
`500 Series`	Syntax error, command unrecognized and the requested action did not take place. This may include errors such as command line too long.
`501`	Syntax error in parameters or arguments.
`502`	Command not implemented.
`503`	Bad sequence of commands.
`504`	Command not implemented for that parameter.
`530`	Not logged in.
`532`	Need account for storing files.
`533`	Command protection level denied for policy reasons.
`534`	Request denied for policy reasons.
`535`	Failed security check.
`536`	Data protection level not supported by security mechanism.
`537`	Command protection level not supported by security mechanism.
`550`	Requested action not taken. File unavailable (e.g., file not found, no access).
`551`	Requested action aborted. Page type unknown.
`552`	Requested file action aborted. Exceeded storage allocation (for current directory or dataset).
`553`	Requested action not taken. File name not allowed.
`600 Series`	Replies regarding confidentiality and integrity
`631`	Integrity protected reply.
`632`	Confidentiality and integrity protected reply.
`633`	Confidentiality protected reply.

Related Research Articles

The Domain Name System (DNS) is a hierarchical and distributed name service that provides a naming system for computers, services, and other resources on the Internet or other Internet Protocol (IP) networks. It associates various information with domain names assigned to each of the associated entities. Most prominently, it translates readily memorized domain names to the numerical IP addresses needed for locating and identifying computer services and devices with the underlying network protocols. The Domain Name System has been an essential component of the functionality of the Internet since 1985.

The Gopher protocol is a communication protocol designed for distributing, searching, and retrieving documents in Internet Protocol networks. The design of the Gopher protocol and user interface is menu-driven, and presented an alternative to the World Wide Web in its early stages, but ultimately fell into disfavor, yielding to Hypertext Transfer Protocol (HTTP). The Gopher ecosystem is often regarded as the effective predecessor of the World Wide Web.

HTTP is an application layer protocol in the Internet protocol suite model for distributed, collaborative, hypermedia information systems. HTTP is the foundation of data communication for the World Wide Web, where hypertext documents include hyperlinks to other resources that the user can easily access, for example by a mouse click or by tapping the screen in a web browser.

Multipurpose Internet Mail Extensions (MIME) is a standard that extends the format of email messages to support text in character sets other than ASCII, as well as attachments of audio, video, images, and application programs. Message bodies may consist of multiple parts, and header information may be specified in non-ASCII character sets. Email messages with MIME formatting are typically transmitted with standard protocols, such as the Simple Mail Transfer Protocol (SMTP), the Post Office Protocol (POP), and the Internet Message Access Protocol (IMAP).

The Simple Mail Transfer Protocol (SMTP) is an Internet standard communication protocol for electronic mail transmission. Mail servers and other message transfer agents use SMTP to send and receive mail messages. User-level email clients typically use SMTP only for sending messages to a mail server for relaying, and typically submit outgoing email to the mail server on port 587 or 465 per RFC 8314. For retrieving messages, IMAP is standard, but proprietary servers also often implement proprietary protocols, e.g., Exchange ActiveSync.

The Secure Shell Protocol (SSH) is a cryptographic network protocol for operating network services securely over an unsecured network. Its most notable applications are remote login and command-line execution.

In computer network communications, the HTTP 404, 404 not found, 404, 404 error, page not found, or file not found error message is a hypertext transfer protocol (HTTP) standard response code, to indicate that the browser was able to communicate with a given server, but the server could not find what was requested. The error may also be used when a server does not wish to disclose whether it has the requested information.

Uploading refers to transmitting data from one computer system to another through means of a network. Common methods of uploading include: uploading via web browsers, FTP clients, and terminals (SCP/SFTP). Uploading can be used in the context of clients that send files to a central server. While uploading can also be defined in the context of sending files between distributed clients, such as with a peer-to-peer (P2P) file-sharing protocol like BitTorrent, the term file sharing is more often used in this case. Moving files within a computer system, as opposed to over a network, is called file copying.

The File Transfer Protocol (FTP) is a standard communication protocol used for the transfer of computer files from a server to a client on a computer network. FTP is built on a client–server model architecture using separate control and data connections between the client and the server. FTP users may authenticate themselves with a plain-text sign-in protocol, normally in the form of a username and password, but can connect anonymously if the server is configured to allow it. For secure transmission that protects the username and password, and encrypts the content, FTP is often secured with SSL/TLS (FTPS) or replaced with SSH File Transfer Protocol (SFTP).

WebDAV is a set of extensions to the Hypertext Transfer Protocol (HTTP), which allows user agents to collaboratively author contents directly in an HTTP web server by providing facilities for concurrency control and namespace operations, thus allowing Web to be viewed as a writeable, collaborative medium and not just a read-only medium. WebDAV is defined in RFC 4918 by a working group of the Internet Engineering Task Force (IETF).

Extensible Messaging and Presence Protocol is an open communication protocol designed for instant messaging (IM), presence information, and contact list maintenance. Based on XML, it enables the near-real-time exchange of structured data between two or more network entities. Designed to be extensible, the protocol offers a multitude of applications beyond traditional IM in the broader realm of message-oriented middleware, including signalling for VoIP, video, file transfer, gaming and other uses.

In computing, the SSH File Transfer Protocol is a network protocol that provides file access, file transfer, and file management over any reliable data stream. It was designed by the Internet Engineering Task Force (IETF) as an extension of the Secure Shell protocol (SSH) version 2.0 to provide secure file transfer capabilities, and is seen as a replacement of File Transfer Protocol (FTP) due to superior security. The IETF Internet Draft states that, even though this protocol is described in the context of the SSH-2 protocol, it could be used in a number of different applications, such as secure file transfer over Transport Layer Security (TLS) and transfer of management information in VPN applications.

File eXchange Protocol is a method of data transfer which uses FTP to transfer data from one remote server to another (inter-server) without routing this data through the client's connection. Conventional FTP involves a single server and a single client; all data transmission is done between these two. In the FXP session, a client maintains a standard FTP connection to two servers, and can direct either server to connect to the other to initiate a data transfer. The advantage of using FXP over FTP is evident when a high-bandwidth server demands resources from another high-bandwidth server, but only a low-bandwidth client, such as a network administrator working away from location, has the authority to access the resources on both servers.

FTPS is an extension to the commonly used File Transfer Protocol (FTP) that adds support for the Transport Layer Security (TLS) and, formerly, the Secure Sockets Layer cryptographic protocols.

This article lists communication protocols that are designed for file transfer over a telecommunications network.

Webcal is a uniform resource identifier (URI) scheme for accessing iCalendar files. WebCal allows you to create and maintain an interactive events calendar or scheduling system on a Web site or app.

HTTP 403 is an HTTP status code meaning access to the requested resource is forbidden. The server understood the request, but will not fulfill it, if it was correct.

A uniform resource locator (URL), colloquially known as an address on the Web, is a reference to a resource that specifies its location on a computer network and a mechanism for retrieving it. A URL is a specific type of Uniform Resource Identifier (URI), although many people use the two terms interchangeably. URLs occur most commonly to reference web pages (HTTP/HTTPS) but are also used for file transfer (FTP), email (mailto), database access (JDBC), and many other applications.

References

↑ RFC 959 File Transfer Protocol

This page is based on this Wikipedia article
Text is available under the CC BY-SA 4.0 license; additional terms may apply.
Images, videos and audio are available under their respective licenses.

[1] RFC 959 File Transfer Protocol

[1]

List of FTP server return codes

See also

Related Research Articles

References