AxY FTP User Guide - Site Panels

## Local and Remote Panels

The most information and control packed area of AxY FTP is local and remote system panels containing detailed directory listing, current directory name, and vertical column of per-site controls.

### Directory Listing

Each row in the listing corresponds to a file (or directory) entry on either local or remote site. There are five columns of information for each entry:

- Graphical representation of entry type:

  | directory
  | upper level directory
  | symbolic link
  | "normal" file

  More granular file type distinction is possible in future releases
- File name
- Last modification date in the form YYYYMMDD
- Last modification time in 24-hour hh:mm format
- File size in bytes

You may resize the columns.

- Motif version:
  Position pointer on the column edge and drag it with `Shift` key and middle (second) mouse button pressed. Make sure the pointer is NOT within labels area, but inside the listing window.
- GTK+ version:
  Position pointer on the column edge within labels area and drag it with left (first) mouse button pressed.

You may select entries by clicking on the row of interest with left mouse button. It is also possible to select multiple entries with clicking or dragging the pointer with either `Shift` or `Ctrl` key pressed.

Double-click on a directory entry to change to it.

There are no sorting capabilities of directory listing in the current version of the program.

### Directory name box

The area with the name of the current directory is displayed is located on top of the directory listing.

You may click on the arrow right to the name to access the history list. Current directory always appears selected in this list. Selecting any other entry will make the program to change to the directory you selected.

You may directly edit the text filed with directory name by first clicking on it with left mouse button. Pressing `Enter` key will make the program to change to the directory you entered. If you misspelled the directory name or if it was not possible to change to it for any other reason, text in the directory name field is still the one you entered and is NOT a valid name of the directory being displayed. History list, however, has the correct name of the current directory selected. You may pull the history list down and click on selected entry to restore correct directory name in the text field.

### Column of controls

Main functionality of AxY FTP is provided through these columns of local and remote controls. Each column consists of the following:

- ChgDir
- MkDir
- Mask entry field
- View
- Exec
- Rename
- Delete
- Refresh
- DirInfo

- ChgDir button
  Select some entry in directory listing (directory preferably) and click this button to change to the selected directory entry.
- MkDir button
  Click this button and you will be prompted with a little dialog window to enter directory name you wish to create. Press `Enter` or click "OK" to actually perform the operation.
- Mask text entry field
  Enter some mask using normal shell wild cards and press `Enter` for immediate effect. An example would be "*.c" to display only C source code files or ".*" to display only "hidden" entries. ".* *" mask should force to display all entries present in current directory. Current directory (.) and upper level directory (..) entries will be present in any case.
  Note that not all remote sites support this feature.
- View button
  Select some entry in directory listing (text file preferably) and click this button to make file contents displayed.

  Following rules are used to select the viewer:
  Internal viewer is used for the remote file.
  For local file AxY FTP attempts to start the viewer specified by $XEDITOR environment variable (or "gvim" if not set). If fails, the program attempts to start xterm and execute a viewer specified by $EDITOR environment variable in it. If $EDITOR is not set, "vi" editor is executed in xterm window.

  Much more flexibility in possible local and remote viewers will be present in future releases of AxY FTP.
- Exec button
  Click this button to be prompted for the command to be executed on either local system in a subshell or on a remote system using 'SITE' command. A good example of the command would be `"umask 022"` or `"chmod 0755 filename"`. Directory listing is NOT updated after the command is executed, use "Refresh" to force the update.
- Rename button
  Select some entry in directory listing and click on this button to be prompted for a new name of the selected entry. Press `Enter` or click "OK" to perform the operation.
- Delete button
  Select some entry in directory listing and click this button. You will be prompted to confirm the delete operation. Clicking "OK" will perform the operation. Only "normal" files, symbolic links and empty directories can be deleted with this command unless Recursive deletions option is checked.
- Refresh button
  Forces update of the current directory name and directory listing.
- DirInfo button
  Displays AxY FTP internal viewer window with even more detailed directory listing similar to the output of `"ls -l"`

Back to the Main Window Controls
Back to the Table of Contents