Syntax24b.Scn.Fnt ]ParcElemsAllocSyntax24.Scn.FntSyntax14.Scn.Fnt7Syntax14b.Scn.Fnt Syntax10.Scn.FntSyntax12.Scn.Fnt Syntax12b.Scn.FntLinkElemsAllocFTP.TextRUFTP.TextmFTP.TextݳFTP.TextôFTP.Textd2IFTP.TextF:FTP.Text$FTP.TextE4FTP.TextA6FTP.TextPFTP.Text^)FTP.Text(]+FTP.TextlMarkElemsAllocRUcSyntax12i.Scn.Fntmݳ<*+~ rB E<FTP.Text(]l RôqFTP.Textl0  bGGFeb(h  ,Id2Fb%F9"VE4 A4|P^)@(])@ ]) Syntax10i.Scn.Fnt  fFTP.Textô  .   FTP.TextA    L  l *    ' FTP A File Transfer Protocol Client for the Oberon System User's Guide Gnter Obiltschnig, 12.05.96 Table of Contents   1 Introduction  2 Using the FTP Client  2.1 Opening a Connection  2.2 Command Overview  2.3 Retrieving files from the server and storing files on the server  2.4 Differences to the FileManager and Other Oddities  2.4.1 Is it a File or a Folder?  2.4.2 More Attributes  2.4.3 Opening a Remote File or a Remote Directory  2.4.4 Automatic Re-Connect  2.4.5 File Names in Oberon for Windows  2.5 The Configuration File FTP.Profile  2.6 Command Reference   1 Introduction FTP is an easy to use, yet powerful application for accessing FTP (File Transfer Protocol) servers. It's based upon the FileManager application-framework written by Christian Mayrhofer and thus features the same tree-like directory browsing capabilities as known from Oberon's FileManager. If you're not already familiar with the FileManager, you should Edit.Open FileManager.Text and learn its basic concepts. It is also assumed that you have some basic knowledge of using the File Transfer Protocol, for example from using FTP client applications on other systems like UNIX, MacOS or Windows.  2 Using the FTP Client  2.1 Opening a Connection To start a FTP session, you use the FTP.Open command: FTP.Open host[/directory] [user-id [password [account]]] host: The server's host-address, specified either as domain-name ("ftp.ssw.uni-linz.ac.at") oder as IP-number ("140.78.145.1"). directory: The path to the desired server directory. Must be delimited from the host address by a slash character ('/'). user-id, User identification, password and account number for logging in password, to the server. If the user-id is missing, the user is logged in as account: "anonymous" with the e-mail address taken from FTP.Profile  as password. If only the password is missing, the user is prompted for typing it in during the login process. The same applies for the account number. This command tries to establish a connection with the server and opens a FTP viewer displaying the contents of the specified directory (or the root directory, if no directory is specified) of the server. Examples: FTP.Open c210.edvz.uni-linz.ac.at k3058e1~ FTP.Open ftp.ssw.uni-linz.ac.at/pub~   2.2 Command Overview Here is a brief description of the commands found in the FTP- and File-menus of the FTP viewer. See section 2.6  for a more formal description of the commands.  FTP.Automatic Automatically determines the appropriate type for transferring the file (ASCII or Binary). FTP.ASCII Sets the file type to ASCII (for transferring plain text files). FTP.Binary Sets the file type to binary (for transferring all other files). FTP.Refresh Re-reads the contents of the selected folder from the server. FTP.ToggleListMethod Changes the method used for retrieving directory listings from the server. Two methods are supported: LIST and NLST. LIST makes it possible to display file attributes, such as size, owner, and access privileges for each file. However, the FTP client is not able to interpret all the possible listing formats used by various servers. Currently, only the UNIX and VAX/VMS formats are supported. Therefore, if you get weird or empty directory listings, there is also the NLST method, which delivers only the plain file names. Since most of the servers use the UNIX-format (including servers running on Windows-NT and MacOS platforms), the LIST method should work in most cases. FTP.SendCmd ^ Sends an FTP command string to the server. This is for people who know what they're doing. FTP.Status Shows the status of the current transmission (including the number of bytes transferred). FTP.Abort Aborts the current transmission. FTP.Copy Copies the selected items to the local host. Works exactly like the FileManager's Copy command. FTP.CopyTo ^ Copy the selected file to the local host and give it another name (specified through the current selection). If more than one file is selected, only the first one gets the new name. If both files and folders are selected, the first item that is a file is renamed. IMPORTANT: You must select the file in the FTP viewer before you select the text specifying the new name, otherwise FTP.CopyTo will not work as expected. FTP.NewFolder ^ Creates a new folder on the server. FTP.Delete Deletes the selected items (after prompting for a confirmation).  2.3 Retrieving files from the server and storing files on the server Since an FTP viewer behaves like a FileManager viewer, transferring files between your local computer and the server is like copying or moving files between two FileManager viewers on your local computer. However, there is one difference: since FTP transfers may take significant amounts of time, files are always transferred "in the background". That means, after you have initiated a file transfer, you can immediately continue using your system, while the file transfer is going on. If the file transfer completes, a message will be printed to System.Log. To copy files or directories from the server to your local computer, just open a FileManager viewer with the directory where the file should be stored. Then, in the FTP viewer, select the items to be transferred and move the caret into the destination directory in the FileManager viewer. Finally, chose FTP.Copy from the FTP viewer's File menu. To copy files or directories from your local computer to the server, select the items in the FileManager viewer, move the caret into the destination directory in the FTP viewer and chose FileManager.Copy or FileManager.Move from the FileManager's File menu.  2.4 Differences to the FileManager and Other Oddities  2.4.1 Is it a File or a Folder? Since it isn't always possible to find out wheter a given item on the server is a file or a directory (especially if the NLST method is used, or, in case of UNIX systems if the item is a symbolic link), the FTP client provides a special icon for those items. The icon is a combination of the document icon and the folder icon used for displaying plain files and directories. Whether the item is a directory or a file can not be found out before the item is actually opened. Therefore, such items behave like folders. If the item is a plain file, it looks like a folder with just one file in it.  2.4.2 More Attributes In addition to the file attributes displayed by the file manager, namely file size and modification date, the FTP client can display access privileges and owner/group name of a file. For symbolic links on UNIX systems, the link destination can be displayed, too.  2.4.3 Opening a Remote File or a Remote Directory Like the FileManager, the FTP client supports opening a file by clicking on it with the middle mouse button. However, before the file can be opened, it must be transferred to your local computer. For that case, you must specify a "DownloadsFolder" in your FTP.Profile, where those files are copied into. After the file has been copied to your local computer, it is opened with a suitable viewer. The viewer is chosen according to the rules you specify in the "[Applications]" section of FileManager.Profile. If the item you click is a directory, a text viewer containing the contents of that directory is opened. Unfortunately, when you do this on a VMS system, you don't get the contents of that directory, but the directory entry of the directory itself. This seems to be a misinterpretation of the "LIST" command by the VMS system; however, a future release may contain a fix for this.  2.4.4 Automatic Re-Connect If the server closes the connection (due to a time out, for example), the FTP client automatically re-opens the connection when the next command is issued.  2.4.5 File Names in Oberon for Windows If you use FTP in the Windows implementation of the Oberon system, every file you download from a server gets an ampersand character ('&') prepended to its name. This is to prevent Oberon from writing some file specific information to the beginning of the file which would make the file unusable under DOS or Windows.  2.5 The Configuration File FTP.Profile The configuration file "FTP.Profile" has the following format:  [FTP] Type = Automatic | ASCII | Binary Default file type Logging = TRUE | FALSE Determines if the whole session (that is, all commands sent to the server and all replies) should be logged in System.Log. UseNLST = TRUE | FALSE Determines if the NLST method should be used to transfer directory listings. See also section 2.2  (FTP.ToggleListMethod). [Display] Determines the file attributes to be displayed Date = TRUE | FALSE and the sorting order. Size = TRUE | FALSE Links = TRUE | FALSE Owner = TRUE | FALSE Privs = TRUE | FALSE Sort = name | size | type | date [User] DownloadsFolder = "path" See section 2.4.3 . Mail = "user@host" E-Mail address of user. Is taken as password for anonymous-FTP sessions. [Type] ASCII = "pattern"... If the file type is set to "Automatic", files with names matching one of the patterns listed here are transferred as ASCII files. All other files are transferred as binary files.  2.6 Command Reference All commands refer to the viewer from which they are issued. If a command isn't issued from an FTP viewer (that is, from one of its menus), it refers to the viewer marked with the star. Arguments may or may not be quoted with double quotes. FTP.Open host[/directory] [user-id [password [account]]] FTP.Automatic FTP.ASCII FTP.Binary FTP.Refresh FTP.ToggleListMethod FTP.Copy FTP.CopyTo (^ | name) FTP.NewFolder (^ | directory) FTP.Delete FTP.SendCmd (^ | command) FTP.Status FTP.Abort FTP.Sort (^ | (name | size | type | date)) FTP.View (^ | pattern) FTP.SwitchAttribute (^ | date | size | links | privs | owner)