xftp(1) USER COMMANDS xftp(1) NAME LLNL XFTP - an X-based interface to FTP SYNOPSIS xftp [standard X options] DESCRIPTION _L_L_N_L _X_F_T_P is a graphical user interface to FTP (File Transfer Protocol). _L_L_N_L _X_F_T_P does not execute the _f_t_p pro- gram; instead, it directly communicates with remote FTP servers. _L_L_N_L _X_F_T_P is an X client and follows the OSF/Motif look-and-feel. _L_L_N_L _X_F_T_P enables users to transfer files and perform various directory manipulation commands, both remotely and locally. Two especially notable features are the ability to (1) perform "third-party" file transfers, and (2) transfer or delete entire directory substructures. _L_L_N_L _X_F_T_P'_s main window is divided into five main sections: (1) the main menu bar at the top of the window, (2) the diagnostics log at the bottom, (3) the file transfer con- trols in the center, and (4 and 5) the "left" and "right" host sections to either side of the file transfer controls. _L_L_N_L _X_F_T_P can be connected to zero, one, or two hosts. The hosts may be any combination of local and remote hosts (the local host is the client host upon which _L_L_N_L _X_F_T_P is run- ning). In this document, a connected host is referred to as either the "left" or "right" host, depending on whether it is displayed in the left or right host section, respec- tively. Each host section consists of four major graphical elements: (1) a label which displays the host's name; (2) a menu bar whose menus contain many commands that operate on the host; (3) a "directory" menu; and (4) a scrollable "directory list." Each host's _C_o_n_n_e_c_t menu contains commands for connecting/disconnecting local and remote hosts. Each host's _D_i_r menu contains various commands for creating new directories, and for changing and displaying the current directory. Each host's _S_e_l_e_c_t menu contains commands for selecting/deselecting entries in the current directory (the selections appear in the scrollable list of directory entries). Each host's _O_p_s menu contains several commands that operate Last change: 12 May 1994 1 xftp(1) USER COMMANDS xftp(1) on selected directory entries. Each host's directory menu contains each link of the path of the current directory (the last link is displayed). By selecting a link in the path, the current directory is correspondingly changed. (Hence, this is a mechanism to traverse up the host's directory structure.) Each host's directory list contains the entries of the current directory. One way to select/deselect a directory entry is to click on it. If an entry is double-clicked, an attempt is made to change the current directory to that entry. (Hence, this is a way to traverse down the host's directory structure.) The file transfer controls in the middle of the main window allow the user to initiate file transfers on selected entries. The transfers can go from left to right or from right to left. Angle brackets in the _C_o_p_y and _R_c_o_p_y buttons indicate the direction of the transfer (e.g., ">>Copy>>" indicates that a left-to-right transfer would take place). The _V_i_e_w button causes the selected file to be displayed. The scrollable diagnostics log window at the bottom of the main window displays error and status information. The user can control the level of verbosity of messages written to this window via the user preference _D_i_a_g_n_o_s_t_i_c_s. The con- tents of this window can be saved to a file by selecting the _S_a_v_e _L_o_g item in the _L_o_g menu. The diagnostics window can be cleared by selecting the _C_l_e_a_r _L_o_g item in the _L_o_g menu. There is a flag to the left of the diagnostics log window that indicates whether an operation completes successfully or not. If an operation fails then (1) a beep is emitted, (2) the flag changes from green to red (white to black on monochrome displays), (3) the "OK" in the flag changes to "E", and (4) an error message is written to the diagnostic log window. The next operation will clear the error flag. _L_L_N_L _X_F_T_P automatically caches (1) wildcard expressions, (2) paths of current directories, (3) host names and user names used in connecting to remote hosts, and (4) quoted commands. The purpose of each cache is to reduce the amount of typing required. For example, when the user wishes to apply a wildcard expression to select directory entries, a list of recently referenced wildcard expressions for that host will be presented to the user; the user can then double-click on an existing wildcard expression to apply it. The cache is automatically preserved across _L_L_N_L _X_F_T_P sessions in a file named ".xftpcache" in the users home directory. Last change: 12 May 1994 2 xftp(1) USER COMMANDS xftp(1) GETTING STARTED Use the _C_o_n_n_e_c_t menus to connect the two sides to the desired combination of local and/or remote hosts. (Depend- ing on how the user preferences are set, when _L_L_N_L _X_F_T_P comes up some combination of the left and right sides might already be connected to the local host.) Once connected, traverse through a host's directory struc- ture by (1) using the directory name menu (the menu just above the directory list), (2) double-clicking on entries in the directory list, (3) selecting an item in the _G_o _t_o _P_r_e_- _v_i_o_u_s _D_i_r_e_c_t_o_r_y submenu in the host's _D_i_r menu, or (4) selecting the _C_h_a_n_g_e _D_i_r_e_c_t_o_r_y item in the host's _D_i_r menu. Obtain different types of views into a host's current direc- tory by selecting the _D_i_s_p_l_a_y _D_i_r_e_c_t_o_r_y (_L_o_n_g) or _D_i_s_p_l_a_y _D_i_r_e_c_t_o_r_y (_T_a_b_l_e) items in the host's _D_i_r menu. Select/deselect directory entries to operate on by (1) single-clicking on entries in the main directory list, (2) single-clicking on entries in the tabular directory list, (3) dragging the mouse with the left button held down over entries in the tabular directory list, or (4) by selecting any of the items in the host's _S_e_l_e_c_t menu. Transfer selected items by clicking on the _C_o_p_y or _R_c_o_p_y (recursive copy) buttons. Be sure to first set the file transfer mode by toggling the appropriate button (_A_S_C_I_I or _B_i_n_a_r_y) in the main window. View a selected file by clicking on the _V_i_e_w button. Con- figure the viewer by selecting item _V_i_e_w_e_r _P_r_e_f_e_r_e_n_c_e_s in the _O_p_t_i_o_n_s menu. Be sure to first set the file transfer mode by toggling the appropriate button (_A_S_C_I_I or _B_i_n_a_r_y) in the main window. Perform other types of operations on selected items by selecting any one of the items in the host's _O_p_s menu. Configure _L_L_N_L _X_F_T_P by selecting the _P_r_e_f_e_r_e_n_c_e_s item in the _O_p_t_i_o_n_s menu. COMMANDS _L_L_N_L _X_F_T_P contains a large number of commands. The commands are found in (1) the main menus, (2) the host menus, and (3) in the _X_f_e_r _O_p_s controls. Here is a list of the commands: About LLNL XFTP (in _F_i_l_e menu) Gives version information. Change Directory (in _D_i_r menus) Change the current directory. A dialog pops up to Last change: 12 May 1994 3 xftp(1) USER COMMANDS xftp(1) prompt for the directory to change to. The directory may be specified with a full or relative path. Previ- ously referenced directories are cached and displayed in a scrollable list. Double-click on a path in the list to change to that directory. Single click on a path in the list to place that entry into the text field labeled "Directory:", where it can be edited. Click on the _O_K button to change to the directory displayed in the text field. (See user preferences _A_d_d _t_o _C_a_c_h_e, _D_i_a_g_n_o_s_t_i_c_s, _D_i_r_e_c_t_o_r_y _C_a_c_h_e _S_i_z_e, _H_o_s_t _C_a_c_h_e _S_i_z_e, and _S_o_r_t _C_a_c_h_e_s.) Clear Log (in _L_o_g menu) Clear the diagnostics log window. Connect to Anonymous (in _C_o_n_n_e_c_t menus) Easily connect to an anonymous FTP site. If currently connected, the connection is first closed. A dialog pops up to prompt for the remote host, user name and password. The user name is initialized to "anonymous". The password is initialized to the value of the user preference _A_n_o_n_y_m_o_u_s _F_t_p _P_a_s_s_w_o_r_d (which you will prob- ably want to set to your email address). An optional port number may follow the host name (using a space as the delimiter). Previously used host/user name pairs are cached, and those with user names "anonymous" or "ftp" are displayed in a scolled list labeled "Recently Referenced Hosts:". Double-clicking on a host/user name pair initiates a connection. Single-clicking on a host/user name pair places those values in to the host name and user name fields, where they can be edited. Click on the _C_o_n_n_e_c_t button to initiate a connection. (See user preferences _A_d_d _T_o _C_a_c_h_e, _A_n_o_n_y_m_o_u_s _F_t_p _P_a_s_s_- _w_o_r_d, _D_i_a_g_n_o_s_t_i_c_s, _H_o_s_t _C_a_c_h_e _S_i_z_e, _U_s_e_r _C_a_c_h_e _S_i_z_e, and _S_o_r_t _C_a_c_h_e_s.) Connect to Local (in _C_o_n_n_e_c_t menus) Connect to the local (client) host. If currently con- nected, the connection is first closed. (See user preferences _L_e_f_t _A_u_t_o _L_o_c_a_l _L_o_g_i_n and _R_i_g_h_t _A_u_t_o _L_o_c_a_l _L_o_g_i_n.) Connect to Remote (in _C_o_n_n_e_c_t menus) Connect to a remote host (use _C_o_n_n_e_c_t _t_o _A_n_o_n_y_m_o_u_s to more easily connect to an anonymous FTP site). If currently connected, the connection is first closed. A dialog pops up to prompt for the remote host and user names. The user name is initialized to the value of the environment variable _U_S_E_R. An optional port number may follow the host name (using a space as the delimiter). Previously used host/user name pairs are cached and those with user names other than "anonymous" and "ftp" Last change: 12 May 1994 4 xftp(1) USER COMMANDS xftp(1) displayed in a scolled list labeled "Recently Refer- enced Hosts:". Double-clicking on a host/user name pair initiates a connection. Single-clicking on a host/user name pair places those values into the host name and user name fields, where they can be edited. Click on the _C_o_n_n_e_c_t button to initiate a connection. (See user preferences _A_d_d _T_o _C_a_c_h_e, _D_i_a_g_n_o_s_t_i_c_s, _H_o_s_t _C_a_c_h_e _S_i_z_e, _U_s_e_r _C_a_c_h_e _S_i_z_e, and _S_o_r_t _C_a_c_h_e_s.) Contextual Help (in _H_e_l_p menu) Enter contextual-help mode. The mouse cursor changes to a pointing hand. Move the hand and click on any graphical element in the main window that you wish to know more about. Copy (in _X_f_e_r _O_p_s controls) Transfers the selected files according to the mode (_A_S_C_I_I or _B_i_n_a_r_y) specified in _X_f_e_r _M_o_d_e. A dialog pops up to enable the user to monitor the progress of the transfers. The dialog contains a button for abort- ing the transfers. (See user preferences _B_e_e_p _W_h_e_n _O_p_s _D_o_n_e, _D_i_a_g_n_o_s_t_i_c_s, _I_n_i_t_i_a_l _T_r_a_n_s_f_e_r _M_o_d_e, and _I_n_q_u_i_r_e _O_n _C_o_p_y.) Delete Selected Entry(s) (in _O_p_s menus) Deletes the selected entries. A dialog pops up to enable the user to monitor the progress of the dele- tions. The dialog contains a button for aborting the deletions. (See user preferences _B_e_e_p _W_h_e_n _O_p_s _D_o_n_e, _D_i_a_g_n_o_s_t_i_c_s, and _I_n_q_u_i_r_e _O_n _D_e_l_e_t_e.) Deselect All Entries (in _S_e_l_e_c_t menus) Deselect all the entries in the host's current direc- tory. Disconnect (in _C_o_n_n_e_c_t menus) Close the currently connected host. (See user prefer- ence _D_i_a_g_n_o_s_t_i_c_s.) Display Directory (Long) (in _D_i_r menus) Pops up a dialog that displays the contents of the current directory in a scrollable list. If supported by the host (and this is almost always the case), addi- tional information about each directory entry is displayed, such as file length and access restrictions. This display is automatically updated as the current directory changes. This directory display does not support selecting entries or displaying the current selection. _W_a_r_n_i_n_g: Using this feature can increase network traffic, put an additional load on the remote host, and slow down interactivity. (See user prefer- ence _D_i_a_g_n_o_s_t_i_c_s and _S_o_r_t _L_o_n_g _L_i_s_t_s _B_y _D_a_t_e.) Last change: 12 May 1994 5 xftp(1) USER COMMANDS xftp(1) Display Directory Path (in _D_i_r menus) Pops up a dialog that displays the current directory for that host. It will be automatically updated as the current directory changes. (See user preference _D_i_a_g_- _n_o_s_t_i_c_s.) Display Directory (Table) (in _D_i_r menus) Pops up a dialog that displays the contents of the current directory in tabular form. This dialog may be used to view and modify the directory's selected entries. Entries may be selected/deselected either by clicking or by moving the cursor over the entries with the mouse button down. Moving the mouse too quickly can cause some of the entries to be skipped. If an entry is double-clicked, an attempt is made to change the current directory to that entry. This display is automatically updated as the current directory changes. (See user preference _D_i_a_g_n_o_s_t_i_c_s.) Getting Started (in _H_e_l_p menu) Describes how to get started using _L_L_N_L _X_F_T_P. Go to Previous Directory (in _D_i_r menus) Displays a pullright menu that allows the user to easily change the current directory to a previously referenced directory. (See user preferences _A_d_d _t_o _C_a_c_h_e, _D_i_a_g_n_o_s_t_i_c_s, _D_i_r_e_c_t_o_r_y _C_a_c_h_e _S_i_z_e, _H_o_s_t _C_a_c_h_e _S_i_z_e, and _S_o_r_t _C_a_c_h_e_s.) LLNL XFTP Overview (in _H_e_l_p menu) Gives a high-level description of _L_L_N_L _X_F_T_P. Make Directory (in _D_i_r menus) Pops up a dialog to prompt for the name of a directory to make in the current directory. The user preference _E_n_t_e_r _D_i_r _U_p_o_n _C_r_e_a_t_i_o_n controls whether the the newly created directory is automatically entered upon crea- tion. (See user preferences _D_i_a_g_n_o_s_t_i_c_s and _E_n_t_e_r _D_i_r _U_p_o_n _C_r_e_a_t_i_o_n.) Move Selected Entry(s) (in _O_p_s menus) Move selected entries from the current directory to another directory on the same host. This is similar to the UNIX _m_v command, but without rename capability. (See user preferences _B_e_e_p _W_h_e_n _O_p_s _D_o_n_e, and _D_i_a_g_n_o_s_- _t_i_c_s.) Preferences (in _O_p_t_i_o_n_s menu) Display the user preferences dialog. See _U_S_E_R _P_R_E_F_E_R_- _E_N_C_E_S section for a description of user preferences. Quit (in _F_i_l_e menu) Last change: 12 May 1994 6 xftp(1) USER COMMANDS xftp(1) Terminate _L_L_N_L _X_F_T_P. Rcopy (in _X_f_e_r _O_p_s controls) Recursively transfers the selected entries according to the mode (_A_S_C_I_I or _B_i_n_a_r_y) specified in _X_f_e_r _M_o_d_e. If a selected entry is a directory, an attempt is made to transfer its entire directory subtree. A dialog pops up to enable the user to monitor the progress of the transfers. The dialog contains a button for aborting the transfers. (See user preferences _B_e_e_p _W_h_e_n _O_p_s _D_o_n_e, _D_i_a_g_n_o_s_t_i_c_s, _I_n_i_t_i_a_l _X_f_e_r _M_o_d_e, and _I_n_q_u_i_r_e _O_n _C_o_p_y.) Recursively Delete Selected Entry(s) (in _O_p_s menus) Recursively deletes the selected entries. A dialog pops up to enable the user to monitor the progress of the deletions. The dialog contains a button for abort- ing the deletions. _W_a_r_n_i_n_g: Exercise extreme caution when using this command because it deletes entire directory subtrees. To minimize the chance of an unin- tentional deletion, this menu item is greyed out unless the user preference _R_e_c_u_r_s_i_v_e _D_e_l_e_t_e _E_n_a_b_l_e_d is enabled. (See user preferences _B_e_e_p _W_h_e_n _O_p_s _D_o_n_e, _D_i_a_g_n_o_s_t_i_c_s, _I_n_q_u_i_r_e _O_n _D_e_l_e_t_e, and _R_e_c_u_r_s_i_v_e _D_e_l_e_t_e _E_n_a_b_l_e_d.) Rename Selected Entry(s) (in _O_p_s menus) Pop up a dialog to individually rename selected entries. This is similar to the UNIX _m_v command except that the renamed entries cannot be moved to another directory. (See user preference _D_i_a_g_n_o_s_t_i_c_s.) Save Log (in _L_o_g menu) Write the contents of the diagnostics window to a user-specified file. The existing contents of the diagnostics window are not removed. Save Preferences (in _O_p_t_i_o_n_s menu) Save the current settings of the user and viewer preferences. Select All Entries (in _S_e_l_e_c_t menus) Select all the entries in the host's current directory. Send Quoted Command (in _O_p_s menus) Pops up a dialog to prompt for a "raw" command to send to the FTP server of the remote host. Previously issued commands are cached and displayed in a scrolled list. Double-clicking on a command in the list issues that command. To have a command act on items selected in the host's directory list, use the quote placeholder (which by default is "<>") to represent a selected Last change: 12 May 1994 7 xftp(1) USER COMMANDS xftp(1) item. For example, type "stage 1 <>" to send a STAGE command to the the remote host for each selected item. The quote placeholder can changed via the user prefer- ences. (See user preferences _B_e_e_p _W_h_e_n _O_p_s _D_o_n_e, _D_i_a_g_- _n_o_s_t_i_c_s, and _Q_u_o_t_e _P_l_a_c_e_h_o_l_d_e_r.) Use Wildcard (in _S_e_l_e_c_t menus) Pops up a dialog to prompt for a wildcard expression to use in selecting entries in the host's current direc- tory list. Previously referenced wildcard expressions are cached and displayed in a scrolled list. Double- clicking on an item in the list applies that wildcard expression. Single-clicking on an item in the list places the expression in a text field where it may be edited. Choose the toggle item _R_e_p_l_a_c_e _F_i_l_e_n_a_m_e _S_e_l_e_c_- _t_i_o_n to cause the currently selected entries to be cleared before applying the wildcard. Choose the tog- gle item _A_d_d _t_o _F_i_l_e_n_a_m_e _S_e_l_e_c_t_i_o_n to cause the entries selected by the wildcard to be added to the current selection. (See user preference _I_n_i_t_i_a_l _W_i_l_d_c_a_r_d _M_o_d_e). Using Help (in _H_e_l_p menu) Gives a description of the online help package. View (in _X_f_e_r _O_p_s controls) Displays the selected file. The _V_i_e_w_e_r _P_r_e_f_e_r_e_n_c_e_s dialog (accessible via the _O_p_t_i_o_n_s menu) can be used to control whether the file will be displayed using the built-in viewer or using an external viewer of the user's choice (e.g., _e_m_a_c_s or _x_v). The selection of the viewer is configurable, based on the file extension (e.g., ".gif" or ".jpg"). There is no limit on the number or types of viewers that can be simultaneously displayed. The file is transferred according to the mode (_A_S_C_I_I or _B_i_n_a_r_y) specified in _X_f_e_r _M_o_d_e. A dialog pops up to enable the user to monitor the progress of the transfer. The dialog contains a button for aborting the transfer. The destination of the transfer is a temporary direc- tory created in the directory defined as _P__t_m_p_d_i_r in the include file stdio.h. If the environment variable _T_M_P_D_I_R is defined, it is used as the directory. The temporary directory, and the files it contains, are automatically deleted when the user dismisses the viewer or terminates _L_L_N_L _X_F_T_P. If the file is recognized as being compressed, it is expanded before viewing. _L_L_N_L _X_F_T_P excutes the Last change: 12 May 1994 8 xftp(1) USER COMMANDS xftp(1) following decompressors based on the file extension: _g_u_n_z_i_p for ".z" and ".gz"; _u_n_c_o_m_p_r_e_s_s for ".Z"; _a_t_o_b for "atob"; and _u_u_d_e_c_o_d_e for ".uu". _L_L_N_L _X_F_T_P searches for the decompressor application in the standard way using the _P_A_T_H environment variable. Viewer Preferences (in _O_p_t_i_o_n_s menu) Display the viewer preferences dialog. See _V_I_E_W_E_R _P_R_E_F_E_R_E_N_C_E_S section for a description of viewer prefer- ences. USER PREFERENCES Selecting item _P_r_e_f_e_r_e_n_c_e_s in the _O_p_t_i_o_n_s menu pops up a dialog that allows the user to configure _L_L_N_L _X_F_T_P according to his/her preferences. The user is presented with a number of configuration parameters, which are set by either tog- gling, sliding, or typing. Click the _A_p_p_l_y button to cause the new values to take effect. The _O_K button has the same effect as _A_p_p_l_y, but the dialog is also closed. The _C_a_n_c_e_l button undoes changes made since _O_K or _A_p_p_l_y were last pressed. The preferences can be preserved across _L_L_N_L _X_F_T_P sessions in a text file named ".xftprc" in the user's home directory. The user may alter the order the preferences are presented in the dialog by (1) terminating _L_L_N_L _X_F_T_P, (2) using a text editor to change the order of lines in ".xftprc" and (3) restarting _L_L_N_L _X_F_T_P. Add To Cache Specifies whether newly referenced items should be added to the directory, quoted command, wildcard, and host/user caches. It is usually desirable to choose _Y_e_s. Choose _N_o if referencing a series of seldom- referenced items that would clear the cache of your favorite entries. Anonymous Ftp Password The value to initialize the "Password" field of the _C_o_n_n_e_c_t _t_o _A_n_o_n_y_m_o_u_s dialog to. This is normally your email address. The _C_o_n_n_e_c_t _t_o _A_n_o_n_y_m_o_u_s dialog is accessible via each host's _C_o_n_n_e_c_t menu. Beep When Ops Done Specifes whether to beep when each set of deletion, move, quoted command, and file transfer operations com- pletes. Diagnostics Specifies the level of diagnostics information to be written to the diagnostics log window. Choose _Q_u_i_e_t for error messages, only. Choose _N_o_r_m_a_l for error mes- sages and success messages. Choose _V_e_r_b_o_s_e for error messages, success messages, and replies received from Last change: 12 May 1994 9 xftp(1) USER COMMANDS xftp(1) the FTP servers. Choose _D_e_b_u_g for error messages, suc- cess messages, commands sent to the FTP servers, replies received from the FTP servers, and other assorted diagnostics. Directory Cache Size The maximum number of previously referenced directory paths cached per host. The cache is preserved across _L_L_N_L _X_F_T_P sessions. Enhance Colors Speficies whether to "pretty up" some of the graphical elements (such as scrolled lists and text fields) by changing the normal background colors. This preference has no effect on monochrome displays. Choose _Y_e_s to enhance the appearance, or _N_o for the usual Motif look. Enter Dir Upon Creation Specifies whether to automatically enter a newly created directory. Host Cache Size The maximum number of hosts to cache items for. The cache is preserved across _L_L_N_L _X_F_T_P sessions. Initial Logfile Name The default file name to be presented to the user in the "Save Log" dialog. Initial Transfer Mode The default file transfer mode (_A_S_C_I_I or _B_i_n_a_r_y). Initial Wildcard Mode The default mode of the "Use Wildcard" dialog. Choose _R_e_p_l_a_c_e to make "Replace Filename Selection" the default. Choose _A_d_d to make "Add to Filename Selec- tion" the default. Inquire On Copy Specifies whether to pop up a dialog that asks the user to confirm that the indicated transfers should take place. Inquire On Delete Specifies whether to pop up a dialog that asks the user to confirm that the indicated deletions should take place. Inquire On Move Specifies whether to pop up a dialog that asks the user to confirm that the indicated moves should take place. Last change: 12 May 1994 10 xftp(1) USER COMMANDS xftp(1) Inquire On Quote Specifies whether to pop up a dialog that asks the user to confirm that the indicated commands should be sent. Left Auto Local Login Specifies whether to automatically connect the left side to the local (client) host upon starting _L_L_N_L _X_F_T_P. Max Ftp Retries Specifies the maximum number of retries _L_L_N_L _X_F_T_P will attempt if it receives a response from an FTP server that indicates the desired operation failed because of some temporary condition on the remote host. Max Time For Ftp Reply Specifies the maximum time in seconds that _L_L_N_L _X_F_T_P will wait for a response from an FTP server before con- cluding that the connection has been broken. Preserve Vms Ver Nums Specifies whether to preserve VMS file version numbers when transferring files from a VMS system. This is only an issue for those VMS FTP servers that provide numbers (not all do). Print Password In Debug Specifies whether to print passwords in the log window when the user preference _D_i_a_g_n_o_s_t_i_c_s is set to _D_e_b_u_g. Quote Cache Size The number of quoted commands to cache. The cache is preserved across _L_L_N_L _X_F_T_P sessions. Quote Placeholder This is used as a placeholder in a quoted command to represent items selected in the directory list. For example, the quoted command "stage 1 <>" will send a STAGE command to the remote host for each selected item. The default value is "<>", but the placeholder can be set to any nonnull printable string. Recursive Delete Enabled Specifies whether to enable the _R_e_c_u_r_s_i_v_e_l_y _D_e_l_e_t_e _S_e_l_e_c_t_e_d _E_n_t_r_y(_s) item in the _O_p_s menus. Choose _N_o to help prevent accidental recursive deletions. Right Auto Local Login Specifies whether to automatically connect the right side to the local (client) host upon starting _L_L_N_L _X_F_T_P. Last change: 12 May 1994 11 xftp(1) USER COMMANDS xftp(1) Sort Caches Specifies whether to sort (by ASCII-collating sequence) cached items when they are displayed in dialogs. If _Y_e_s, then sort. If _N_o, then the most recently refer- enced items are placed at the top of the list. Sort Longs Lists By Date Specifies whether to attempt to sort the "long" direc- tory lists by time modified (with most recent listed first) instead of by name. The _Y_e_s option is con- sidered unsafe because some FTP servers to not support this option and may give unpredictable results. (Most UNIX hosts support this option.) Store Unique Specifies whether existing sink files are to be renamed before file transfer occurs. If _Y_e_s then the existing sink file is typically renamed by appending a "." (period) followed by an integer between 1 and 99. Symbols On Dir Entries Specifies whether to append single characters to direc- tory entries in order to distinguish their types. If _Y_e_s(_U_n_s_a_f_e) is chosen, "/" is appended to directories, "*" is appended to executables, "@" is appended to sym- bolic links, and "=" is appended to AF_UNIX address family sockets. The "Yes" option is considered to be unsafe because some FTP servers do not support this feature and may give unpredictable results. (Most UNIX hosts support this option.) Furthermore, if you are referencing a directory or directory entry whose name ends with one of the special characters, you will need to select _N_o(_S_a_f_e). When in doubt, select _N_o(_S_a_f_e). One further note: use of this feature can dramatically degrade interactivity. Use Last Dir At Login Specifies whether to automatically enter the most recently referenced directory after connecting to a host. If this option is requested, but is not possible to perform (e.g., because the directory no longer exists), an error message will be generated, and your home directory will be entered. _N_o_t_e: This mechanism attempts to enter the last directory referenced on the host, regardless of whether it is another user's direc- tory. User Cache Size The number of user names to cache (for remote hosts). The cache is preserved across _L_L_N_L _X_F_T_P sessions. Wildcard Cache Size Last change: 12 May 1994 12 xftp(1) USER COMMANDS xftp(1) The number of wildcard expressions to cache. The cache is preserved across _L_L_N_L _X_F_T_P sessions. VIEWER PREFERENCES Selecting item _V_i_e_w_e_r _P_r_e_f_e_r_e_n_c_e_s in the _O_p_t_i_o_n_s menu pops up a dialog that allows the user to control which file will be displayed with which viewer, based on the file extension. A file to be viewed is first transferred to a temporary directory and then, if necessary, is decompressed. The file extension (e.g., ".gif") is then examined to determine which viewer the file is to be displayed in. There are two types of viewers: the viewer built into _L_L_N_L _X_F_T_P (which is suit- able for displaying text files) and external viewers (e.g., _e_m_a_c_s for text and _x_v for graphics). Single-click on an entry in the _E_x_t_e_n_s_i_o_n_s list to place that extension and its associated command line into the _E_x_t_e_n_s_i_o_n and _V_i_e_w_e_r _C_o_m_m_a_n_d _L_i_n_e text fields, respectively. An extension is a file suffix that begins with a period ("."). A special entry in the extensions list, "OTHERS" represents all files that do not have their extension listed (including files with no extensions). The pattern "<>" in a command line is a placeholder for the name of the file to be viewed. A blank command line indi- cates that the built-in viewer is to be used. To add a new extension to the list, fill in the _E_x_t_e_n_s_i_o_n and _V_i_e_w_e_r _C_o_m_- _m_a_n_d _L_i_n_e text fields and press the _A_d_d button. If the text in _E_x_t_e_n_s_i_o_n does not begin with a period, one will be added. If the extension is already in the list, it will be replaced. To replace the command line associated with an extension, (1) single-click on the list item to select it, (2) edit the command line, and (3) press the _R_e_p_l_a_c_e button. To delete an extension from the list, single-click on the list item to select it and then press the _D_e_l_e_t_e button. The "OTHERS" entry cannot be deleted (but it's command line can be replaced). Click the _A_p_p_l_y button to cause the new changes to take effect. The _O_K button has the same effect as _A_p_p_l_y, but the dialog is also closed. The _C_a_n_c_e_l button undoes the changes made since _O_K or _A_p_p_l_y were last pressed. The viewer preferences can be preserved across _L_L_N_L _X_F_T_P sessions in a text file named ".xftpview" in the user's home directory (select _S_a_v_e _P_r_e_f_e_r_e_n_c_e_s in the main window's _O_p_t_i_o_n_s menu). Last change: 12 May 1994 13 xftp(1) USER COMMANDS xftp(1) WIDGET HIERARCHY Most of _L_L_N_L _X_F_T_P's widget heirarchy is listed here so that the knowledgeable user can use the X resource mechanism to customize _L_L_N_L _X_F_T_P. Widget names are followed by their class names in parentheses. A question mark is displayed if the widget's name is not known. _L_L_N_L _X_F_T_P's classname is _X_F_t_p. _M_a_i_n _W_i_n_d_o_w main (XmMainWindow) mainMenuBar (XmRowColumn) File (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) Edit (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) Options (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) Help (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) pane (XmPanedWindow) topForm (XmForm) leftHost (XmForm) hostName (XmLabel) hostMenuBar (XmRowColumn) Connect (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) Dir (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) Select (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) Ops (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) dirNameForm (XmForm) dirName (XmRowColumn) ? (XmCascadeButtonGadget) ? (XmMenuShell) dirNameMenu (XmRowColumn) ? (XmPushButtonGadget) . . . ? (XmPushButtonGadget) dirListSW (XmScrolledWindow) dirList (XmList) Last change: 12 May 1994 14 xftp(1) USER COMMANDS xftp(1) rightHost (XmForm) hostName (XmLabel) hostMenuBar (XmRowColumn) Connect (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) Dir (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) Select (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) Ops (XmCascadeButton) ? (XmMenuShell) pulldown (XmRowColumn) dirNameForm (XmForm) dirName (XmRowColumn) ? (XmCascadeButtonGadget) ? (XmMenuShell) dirNameMenu (XmRowColumn) ? (XmPushButtonGadget) . . . ? (XmPushButtonGadget) dirListSW (XmScrolledWindow) dirList (XmList) centerControls (XmForm) xferModeFrame (XmFrame) xferMode (XmRowColumn) ascii (XmToggleButtonGadget) xferModeLabel (XmLabel) xferOpsFrame (XmFrame) xferOps (XmRowColumn) copyButton (XmPushButton) rCopyButton (XmPushButton) viewButton (XmPushButton) xferOpsLabel (XmLabel) logo (XmLabelGadget) bottomForm (XmForm) resultFlagFrame (XmFrame) resultFlag (XmLabel) logSW (XmScrolledWindow) log (XmText) _A_b_o_r_t _i_n _P_r_o_g_r_e_s_s _D_i_a_l_o_g abort_popup (XmDialogShell) abort (XmForm) abortMessage (XmLabel) _A_b_o_u_t _X_F_T_P _D_i_a_l_o_g about_popup (XmDialogShell) about (XmSelectionBox) form (XmForm) Last change: 12 May 1994 15 xftp(1) USER COMMANDS xftp(1) frame (XmFrame) startup (XmLabel) _A_c_c_o_u_n_t _D_i_a_l_o_g account_popup (XmDialogShell) account (XmSelectionBox) _C_h_a_n_g_e _D_i_r_e_c_t_o_r_y _D_i_a_l_o_g changeDir_popup (XmDialogShell) changeDir (XmSelectionBox) _C_o_n_n_e_c_t _t_o _A_n_o_n_y_m_o_u_s _D_i_a_l_o_g aConnect_popup (XmDialogShell) aConnect (XmSelectionBox) form (XmForm) hostListLabel (XmLabel) hostListSW (XmScrolledWindow) hostList (XmList) hostNameLabel (XmLabel) hostName (XmTextField) userNameLabel (XmLabel) userName (XmTextField) passwordLabel (XmLabel) password (XmTextField) _D_e_s_t_i_n_a_t_i_o_n _D_i_r_e_c_t_o_r_y _D_i_a_l_o_g destdir_popup (XmDialogShell) destdir (XmSelectionBox) form (XmForm) instruction (XmLabel) dirNameForm (XmForm) dirName (XmRowColumn) ? (XmCascaseButtonGadget) ? (XmMenuShell) dirNameMenu (XmRowColumn) ? (XmPushButtonGadget) . . . ? (XmPushButtonGadget) dirListSw (XmScrolledWindow) dirList (XmList) _F_i_l_e _T_r_a_n_s_f_e_r _M_o_n_i_t_o_r _D_i_a_l_o_g monitor_popup (XmDialogShell) monitor (XmSelectionBox) controlArea (XmForm) nameLabel (XmLabel) name (XmLabel) lengthLabel (XmLabel) length (XmLabel) bytesMovedLabel (XmLabel) bytesMove (XmLabel) scale (XmScale) Last change: 12 May 1994 16 xftp(1) USER COMMANDS xftp(1) _H_e_l_p _D_i_a_l_o_g help_popup (XmDialogShell) help (XmForm) pane (XmPanedWindow) controlArea (XmForm) topic (XmLabel) textSW (XmScrolledWindow) text (XmText) _I_n_f_o_r_m_a_t_i_o_n _D_i_a_l_o_g information_popup (XmDialogShell) information (XmMessageBox) _L_e_f_t _D_i_r_e_c_t_o_r_y _P_a_t_h _D_i_a_l_o_g leftDirPath_popup (XmDialogShell) leftDirPath (XmSelectionBox) _L_e_f_t _L_o_n_g _D_i_r_e_c_t_o_r_y _L_i_s_t _D_i_a_l_o_g leftDirLong_popup (XmDialogShell) leftDirLong (XmForm) dirListSW (XmScrolledWindow) dirList (XmText) separator (XmSeparator) closeButton (XmPushButton) helpButton (XmPushButton) _L_e_f_t _T_a_b_u_l_a_r _D_i_r_e_c_t_o_r_y _L_i_s_t _D_i_a_l_o_g leftDirTable_popup (XmDialogShell) leftDirTable (XmForm) scrolledWindow (XmScrolledWindow) drawingArea (XmDrawingArea) separator (XmSeparator) closeButton (XmPushButton) helpButton (XmPushButton) _M_a_k_e _D_i_a_l_o_g makeDir_popup (XmDialogShell) makeDir (XmSelectionBox) _M_o_n_i_t_o_r _D_i_a_l_o_g mpMonitor_popup (XmDialogShell) mpMonitor (XmSelectionBox) form (XmForm) pathLabel (XmLabel) path (XmLabel) _P_a_s_s_w_o_r_d _D_i_a_l_o_g password_popup (XmDialogShell) password (XmSelectionBox) _P_r_e_f_e_r_e_n_c_e_s _D_i_a_l_o_g prefs_popup (XmDialogShell) Last change: 12 May 1994 17 xftp(1) USER COMMANDS xftp(1) prefs (XmForm) actionArea (XmForm) okButton (XmPushButton) separator (XmSeparator) scrolledWindow (XmScrolledWindow) rowColumn (XmRowColumn) frame (XmFrame) form (XmForm) label (XmLabel) -------------------------------------- textField (XmTextField) -------------------------------------- radioBoxFrame (XmFrame) radioBox (XmRowColumn) ? (XmToggleButtonGadget) . . . ? (XmToggleButtonGadget) -------------------------------------- scale (XmScale) -------------------------------------- _Q_u_e_s_t_i_o_n _D_i_a_l_o_g question_popup (XmDialogShell) question (XmMessageBox) _Q_u_o_t_e _D_i_a_l_o_g quote_popup (XmDialogShell) quote (XmSelectionBox) form (XmForm) listLabel (XmLabel) listSW (XmScrolledWindow) list (XmList) textLabel (XmLabel) text (XmTextField) warningLabel (XmLabel) warningFrame (XmFrame) warning (XmRowColumn) warningMsg1 (XmLabel) warningMsg2 (XmLabel) warningMsg3 (XmLabel) _R_e_m_o_t_e _C_o_n_n_e_c_t _D_i_a_l_o_g rConnect_popup (XmDialogShell) rConnect (XmSelectionBox) form (XmForm) hostListLabel (XmLabel) hostListSW (XmScrolledWindow) hostList (XmList) hostNameLabel (XmLabel) hostName (XmTextField) userNameLabel (XmLabel) userName (XmTextField) Last change: 12 May 1994 18 xftp(1) USER COMMANDS xftp(1) _R_e_n_a_m_e _D_i_a_l_o_g rename_popup (XmDialogShell) rename (XmSelectionBox) form (XmForm) oldNameLabel (XmLabel) oldName (XmLabel) newNameLabel (XmLabel) newName (XmTextField) _R_i_g_h_t _D_i_r_e_c_t_o_r_y _P_a_t_h _D_i_a_l_o_g rightDirPath_popup (XmDialogShell) rightDirPath (XmSelectionBox) _R_i_g_h_t _L_o_n_g _D_i_r_e_c_t_o_r_y _L_i_s_t _D_i_a_l_o_g rightDirLong_popup (XmDialogShell) rightDirLong (XmForm) dirListSW (XmScrolledWindow) dirList (XmText) separator (XmPushButton) closeButton (XmPushButton) helpButton (XmPushButton) _R_i_g_h_t _T_a_b_u_l_a_r _D_i_r_e_c_t_o_r_y _L_i_s_t _D_i_a_l_o_g rightDirTable_popup (XmDialogShell) rightDirTable (XmForm) scrolledWindow (XmScrolledWindow) drawingArea (XmDrawingArea) separator (XmSeparator) closeButton (XmPushButton) helpButton (XmPushButton) _S_a_v_e _D_i_a_g_n_o_s_t_i_c_s _L_o_g _D_i_a_l_o_g saveLog_popup (XmDialogShell) saveLog (XmSelectionBox) _V_e_r_i_f_y _D_i_a_l_o_g verify_popup (XmDialogShell) verify (XmSelectionBox) form (XmForm) label (XmLabel) listSW (XmScrolledWindow) list (XmList) _V_i_e_w _F_i_l_e _D_i_a_l_o_g view_popup (XmDialogShell) view (XmForm) saveButton (XmPushButton) closeButton (XmPushButton) helpButton (XmPushButton) separator (XmSeparator) textSW (XmScrolledWindow) text (XmText) Last change: 12 May 1994 19 xftp(1) USER COMMANDS xftp(1) _V_i_e_w_e_r _P_r_e_f_e_r_e_n_c_e_s _D_i_a_l_o_g viewPrefs_popup (XmDialogShell) viewPrefs (XmSelectionBox) form (XmForm) listLabel (XmLabel) listSW (XmScrolledWindow) list (XmList) extensionLabel (XmLabel) extension (XmTextField) commandLineLabel (XmLabel) commandLine (XmTextField) editFrame (XmFrame) editForm (XmForm) addButton (XmPushButton) replaceButton (XmPushButton) deleteButton (XmPushButton) messageFrame (XmFrame) messageRowcolumn (XmRowColumn) message1 (XmLabel) message2 (XmLabel) _W_i_l_d_c_a_r_d _D_i_a_l_o_g wildcard_popup (XmDialogShell) wildcard (XmSelectionBox) form (XmForm) listLabel (XmLabel) listSW (XmScrolledWindow) list (XmList) textLabel (XmLabel) text (XmTextField) radioBoxFrame (XmFrame) radioBox (XmRowColumn) replaceToggle (XmToggleButtonGadget) addToggle (XmToggleButtonGadget) LIMITATIONS Here are some things to watch out for: _L_L_N_L _X_F_T_P might not work with some old X servers. For exam- ple, some older OpenWindows servers might dump core. MacX fans should use nothing older than version 1.1.7b. Old, buggy versions of Motif can cause weirdness. _L_L_N_L _X_F_T_P might not work correctly with some non-Unix FTP servers. (If you can give us temporary access to such a server, we might be able to fix the problem.) Out-of-spec FTP servers can cause untold grief. (Most Unix-based servers work correctly.) Third-party file transfers will not work unless at least one Last change: 12 May 1994 20 xftp(1) USER COMMANDS xftp(1) of the remote FTP servers supports the PASV (passive) com- mand. FILES $HOME/.xftpcache cache file $HOME/.xftprc user preferences $HOME/.xftpview viewer preferences XFtp.color application defaults file for color displays XFtp.mono application defaults file for monochrome displays AVAILABILITY The sources for _L_L_N_L _X_F_T_P are tarred and compressed, and are available via anonymous ftp: IP Address: phoenix.ocf.llnl.gov Directory: /llnlxftp SUPPORT Because our resources are limited, we will not be able to give individual assistance in building and using _L_L_N_L _X_F_T_P. However, your comments, suggestions and bug reports are valuable in helping us determine how to best direct our efforts. Our email address is llnlxftp@llnl.gov COPYRIGHT (c) 1993-1994. The Regents of the University of California. All rights reserved. This work was produced at the University of California, Lawrence Livermore National Laboratory (UC LLNL) under con- tract no. W-7405-ENG-48 (Contract 48) between the U.S. Department of Energy (DOE) and The Regents of the University of California (University) for the operation of UC LLNL. Copyright is reserved to the University for purposes of con- trolled dissemination, commercialization through formal licensing, or other disposition under terms of Contract 48; DOE policies, regulations and orders; and U.S. statutes. The rights of the Federal Government are reserved under Con- tract 48 subject to the restrictions agreed upon by the DOE and University. DISCLAIMER This software was prepared as an account of work sponsored by an agency of the United States Government. Neither the United States Government nor the University of California nor any of their employees, makes any warranty, express or implied, or assumes any liability or responsibility for the accuracy, completeness, or usefulness of any information, Last change: 12 May 1994 21 xftp(1) USER COMMANDS xftp(1) apparatus, product, or process disclosed, or represents that its specific commercial products, process, or service by trade name, trademark, manufacturer, or otherwise, does not necessarily constitute or imply its endorsement, recommenda- tion, or favoring by the United States Government or the University of California. The views and opinions of the authors expressed herein do not necessarily state or reflect those of the United States Government or the University of California, and shall not be used for advertising or product endorsement purposes. Permission to use, copy, modify and distribute this software and its documentation for any non-commercial purpose, without fee, is hereby granted, provided that the above copyright notice and this permission notice appear in all copies of the software and supporting documentation, and that all UC LLNL identification in the user interface remain unchanged. The title to copyright LLNL XFTP shall at all times remain with The Regents of the University of Califor- nia and users agree to preserve same. Users seeking the right to make derivative works with LLNL XFTP for commercial purposes may obtain a license from the Lawrence Livermore National Laboratory's Technology Transfer Office, P.O. Box 808, L-795, Livermore, CA 94550. SEE ALSO ftpd(8C) AUTHOR Neale G. Smith, Lawrence Livermore National Laboratory Last change: 12 May 1994 22