List of FTP server return codes

Last updated

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:

RangePurpose
1xxPositive 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.

2xxPositive Completion reply

The requested action has been successfully completed. A new request may be initiated.

3xxPositive 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.

4xxTransient 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.)

5xxPermanent 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.)

6xxProtected 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:

RangePurpose
x0xSyntax

These replies refer to syntax errors, syntactically correct commands that don't fit any functional category, unimplemented or superfluous commands.

x1xInformation

These are replies to requests for information, such as status or help.

x2xConnections

Replies referring to the control and data connections.

x3xAuthentication and accounting

Replies for the login process and accounting procedures.

x4xUnspecified as of RFC 959.
x5xFile 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.

CodeExplanation
100 SeriesThe requested action is being initiated, expect another reply before proceeding with a new command.
110Restart 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 "=").
120Service ready in nnn minutes.
125Data connection already open; transfer starting.
150File status okay; about to open data connection.
200 SeriesThe requested action has been successfully completed.
202Command not implemented, superfluous at this site.
211System status, or system help reply.
212Directory status.
213File status.
214Help 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.
215NAME system type. Where NAME is an official system name from the registry kept by IANA.
220Service ready for new user.
221Service closing control connection. Logged out if appropriate.
225Data connection open; no transfer in progress.
226Closing data connection. Requested file action successful (for example, file transfer or file abort).
227Entering Passive Mode (h1,h2,h3,h4,p1,p2).
228Entering Long Passive Mode (long address, port).
229Entering Extended Passive Mode (|||port|).
230User logged in, proceed.
232User logged in, authorized by security data exchange.
234Server accepts the security mechanism specified by the client; no security data needs to be exchanged.
235Server accepts the security data given by the client; no further security data needs to be exchanged.
250Requested file action okay, completed.
257"PATHNAME" created.
300 SeriesThe command has been accepted, but the requested action is on hold, pending receipt of further information.
331User name okay, need password.
332Need account for login.
334Server accepts the security mechanism specified by the client; some security data needs to be exchanged.
335Server accepts the security data given by the client; more security data needs to be exchanged.
336Username okay, need password. Challenge is "....".
350Requested file action pending further information
400 SeriesThe 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.
421Service not available, closing control connection. This may be a reply to any command if the service knows it must shut down.
425Can't open data connection.
426Connection closed; transfer aborted.
430Invalid username or password
431Need some unavailable resource to process security.
434Requested host unavailable.
450Requested file action not taken.
451Requested action aborted. Local error in processing.
452Requested action not taken. Insufficient storage space in system. File unavailable (e.g., file busy).
500 SeriesSyntax error, command unrecognized and the requested action did not take place. This may include errors such as command line too long.
501Syntax error in parameters or arguments.
502Command not implemented.
503Bad sequence of commands.
504Command not implemented for that parameter.
530Not logged in.
532Need account for storing files.
533Command protection level denied for policy reasons.
534Request denied for policy reasons.
535Failed security check.
536Data protection level not supported by security mechanism.
537Command protection level not supported by security mechanism.
550Requested action not taken. File unavailable (e.g., file not found, no access).
551Requested action aborted. Page type unknown.
552Requested file action aborted. Exceeded storage allocation (for current directory or dataset).
553Requested action not taken. File name not allowed.
600 SeriesReplies regarding confidentiality and integrity
631Integrity protected reply.
632Confidentiality and integrity protected reply.
633Confidentiality protected reply.
10000 SeriesCommon Winsock Error Codes [2] (These are not FTP return codes)
10054Connection reset by peer. The connection was forcibly closed by the remote host.
10060Cannot connect to remote server.
10061Cannot connect to remote server. The connection is actively refused by the server.
10065No route to host / DNS cannot be resolved.
10066Directory not empty.
10068Too many users, server is full.

See also

Related Research Articles

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 HTTP. The Gopher ecosystem is often regarded as the effective predecessor of the World Wide Web.

<span class="mw-page-title-main">HTTP 404</span> Internet error message

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.

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 clear-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).

Microsoft Personal Web Server (PWS) is a scaled-down web server software for Windows operating systems. It has fewer features than Microsoft's Internet Information Services (IIS) and its functions have been superseded by IIS and Visual Studio. Microsoft officially supports PWS on Windows 95-98, Windows 98 SE, and Windows NT 4.0. Prior to the release of Windows 2000, PWS was available as a free download as well as included on the Windows distribution CDs. PWS 4 was the last version and it can be found on the Windows 98 CD and the Windows NT 4.0 Option Pack.

A serving channel is a slang term for a file sharing channel found on an IRC network. Here, users can share and download files including photos, videos, audio files, books, programs, etc. Users that are actively sharing their files are generally referred to as 'servers', whereas users that download without sharing their own files are generally referred to as 'leeches'. While serving normally implies pirated or questionable material, some channels are used for fully legitimate reasons. There are two styles of servers, Fserves, and serving scripts like OmenServe.

<span class="mw-page-title-main">Internet Information Services</span> Extensible web server software by Microsoft

Internet Information Services (IIS) is an extensible web server created by Microsoft for use with the Windows NT family. IIS supports HTTP, HTTP/2, HTTPS, FTP, FTPS, SMTP and NNTP. It has been an integral part of the Windows NT family since Windows NT 4.0, though it may be absent from some editions, and is not active by default.

<span class="mw-page-title-main">Wget</span> Computer command line program for downloading

GNU Wget is a computer program that retrieves content from web servers. It is part of the GNU Project. Its name derives from "World Wide Web" and "get". It supports downloading via HTTP, HTTPS, and FTP.

cURL is a computer software project providing a library (libcurl) and command-line tool (curl) for transferring data using various network protocols. The name stands for "Client for URL".

9P is a network protocol developed for the Plan 9 from Bell Labs distributed operating system as the means of connecting the components of a Plan 9 system. Files are key objects in Plan 9. They represent windows, network connections, processes, and almost anything else available in the operating system.

<span class="mw-page-title-main">Microsoft WebMatrix</span>

Microsoft WebMatrix is a discontinued cloud-connected website builder and HTML editor for Windows, geared towards web development. WebMatrix enables developers to build websites using built-in templates or popular open-source applications, with full support for ASP.NET, PHP, Node.js and HTML5. Microsoft developed WebMatrix for the purpose of providing web developers with coding, customization, and publishing capabilities all in one place.

<span class="mw-page-title-main">UltraEdit</span>

UltraEdit is a commercial text editor for Microsoft Windows, Linux and OS X created in 1994 by the founder of IDM Computer Solutions Inc., Ian D. Mead, and owned by Idera, Inc. since August 2021. The editor contains tools for programmers, including macros, configurable syntax highlighting, code folding, file type conversions, project management, regular expressions for search-and-replace, a column-edit mode, remote editing of files via FTP, interfaces for APIs or command lines of choice, and more. Files can be browsed and edited in tabs, and it also supports Unicode and hex editing mode.

<span class="mw-page-title-main">Windows NT 3.5</span> Second major release of Windows NT, released in 1994

Windows NT 3.5 is a major release of the Windows NT operating system developed by Microsoft and oriented towards businesses. It was released on September 21, 1994, as the successor to Windows NT 3.1 and the predecessor to Windows NT 3.51.

<span class="mw-page-title-main">FileZilla</span> Free software, cross-platform file transfer protocol application

FileZilla is a free and open-source, cross-platform FTP application, consisting of FileZilla Client and FileZilla Server. Clients are available for Windows, Linux, and macOS. Both server and client support FTP and FTPS, while the client can in addition connect to SFTP servers.

Expect is an extension to the Tcl scripting language written by Don Libes. The program automates interactions with programs that expose a text terminal interface. Expect, originally written in 1990 for the Unix platform, has since become available for Microsoft Windows and other systems.

Filesystem in Userspace (FUSE) is a software interface for Unix and Unix-like computer operating systems that lets non-privileged users create their own file systems without editing kernel code. This is achieved by running file system code in user space while the FUSE module provides only a bridge to the actual kernel interfaces.

Zend Studio is a commercial, proprietary integrated development environment (IDE) for PHP developed by Zend Technologies, based on the PHP Development Tools (PDT) plugin for the Eclipse platform.

FTPFS refers to file systems that support access to a File Transfer Protocol (FTP) server through standard file system application programming interfaces (APIs).

In computing, an error code is a numeric or alphanumeric code that indicates the nature of an error and, when possible, why it occurred. Error codes can be reported to end users of software, returned from communication protocols, or used within programs as a method of representing anomalous conditions.

References

  1. RFC 959
  2. Windows Socket Error Codes, Microsoft Windows Dev Center