RFC 949 UNKNOWN APPLICATIONS · FILE TRANSFER

FTP STOU: FTP unique-named store command

A proposed FTP command that lets the server choose a unique file name.

On rfc-editor.org ↗
PUBLISHED
July 1985
AUTHORS
M.A. Padlipsky
STREAM
Legacy
PROPOSED COMMAND
STOU
SUGGESTED RESPONSE CODE
250
DOI
10.17487/RFC0949

RFC text

Contents
Original text · RFC Editor View on rfc-editor.org ↗
Network Working Group                                     Mike Padlipsky
Request for Comments: 949                                          Mitre
Semisupersedes RFC 505                                         July 1985

                     FTP UNIQUE-NAMED STORE COMMAND


STATUS OF THIS MEMO

   This RFC proposes an extension to the File Transfer Protocol for the
   ARPA-Internet community, and requests discussion and suggestions for
   improvements.  Distribution of this memo is unlimited.

DISCUSSION

   There are various contexts in which it would be desirable to have an
   FTP command that had the effect of the present STOR but rather than
   requiring the sender to specify a file name instead caused the
   resultant file to have a unique name relative to the current
   directory.  This would be useful for all sorts of "pool" directories;
   the directories that serve as queues for printer daemons come
   immediately to mind (so do fax and even cardpunch daemons' queues),
   although naturally the sort of printer queue that a local command has
   to manage the interface to isn't what's meant by "pool" in this
   context.

   If we accept the need for such an FTP extension, and that it should
   not be done with an "X" command because it needs to be relied on
   "everywhere," the interesting question then becomes how to mechanize
   it.  Probably the most natural way to do it would be either to add a
   "control argument" of -UNM to the syntax of STOR, now that there are
   enough UNIXtm's around so that this good old Multics trick isn't
   alien any more, or even to declare that STOR with no argument should
   cause a directory-unique name to be generated.  However, either of
   these would necessitate "reopening" the STOR command code, which is a
   distasteful sort of exercise.  Since most FTP's presumably do a
   dispatch sort of thing off a list of command names to begin with,
   then, an additional command would seem to be the way to go.

   Naming the command calls for a bit of thought.  STore Uniquely Named
   (-> STUN) is silly; UNIQue comes to close to free advertising or even
   trademark infringement (and confuses fingers if you're typing); Store
   Uniquely NaMed (-> SUNM) doesn't avoid free advertising either;
   Uniquely Named STore (-> UNST) might look like a synonym for DELEte,
   though it's not all that bad; SToRe Uniquely named (-> STRU) is
   taken; and so it goes.  The best bet seems to be STOU.

   Of somewhat more practical import, there's also the question of
   whether the sender needs to be apprised of what the unique name
   turned out to be.  Intuitively, sometimes this would be the case and
   sometimes it wouldn't.  Making it optional is almost certainly too

FTP Unique-Named Store Command


   much like work, though--even if it does have the subtle virtue of
   finally getting control arguments into FTP.  Therefore, why not just
   include it in a suitable response-code's free text field (unless, of
   course, an avalanche of comments comes in urging it not be done at
   all)?

   Note, by the way, that the intent here is emphatically not to
   sidestep whatever access control, authentication, and accounting
   mechanisms Hosts might have in play before the user can do an old
   STOR or a new STOU, but with suitable publicized ID's and passwords
   it could be almost as good as the proposal made in RFC 505.

RECOMMENDATION

   Add a new command, STOU, to FTP, which behaves like STOR except that
   the resultant file is to be created in the current directory under a
   name unique to that directory.   The 250 Transfer Started response
   should include the name generated (unless the copy of FTP I have is
   so old that 250 isn't the right number any more).

ISO Plain Language

On this page
PROBLEMA sender may need to place a file in a shared queue without choosing a name that conflicts with another file.
MECHANISMThe proposed STOU command behaves like STOR but creates the file under a name unique in the current directory and returns that name in response text.
THE PROPOSALRFC 949 proposes an FTP extension and requests discussion and suggestions for improvement.

§1Why Store Under a Unique Name

The RFC describes uses for an FTP command that works like STOR but does not require the sender to choose the file name. It gives pool directories, including printer and fax queues, as examples.

A new command is proposed rather than changing STOR's existing command handling.

In a shared queue, several senders may submit files. Letting the server choose a unique name avoids requiring each sender to coordinate file names.

§2The STOU Command

The recommendation is to add the command STOU. It creates the resulting file in the current directory under a name unique to that directory.

The proposed 250 Transfer Started response includes the generated name in its free-text field. The RFC notes uncertainty about whether that response code was current in the author's FTP copy.

The client sends STOU and the server picks a unique name in the current directory. The response tells the client the name that was generated.

§3Access Control and Proposal Status

The memo says STOU is not intended to bypass host access-control, authentication, or accounting mechanisms. A user must still satisfy the host's requirements before using either STOR or STOU.

RFC 949 proposes the extension for discussion and invites suggestions for improvement.

STOU changes who selects the file name, not the host's access controls. The RFC presents the command as a proposal for discussion.