home *** CD-ROM | disk | FTP | other *** search
/ 73.234.73.94.ip.orionnet.ru / 73.234.73.94.ip.orionnet.ru.tar / 73.234.73.94.ip.orionnet.ru / Far30b3000.x86.20121208.msi / Notes.txt < prev    next >
Text File  |  2012-12-08  |  15KB  |  318 lines
  1.              Notes on the features of the FAR FTP plugin
  2.              ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.              and its operation with specific FTP servers
  4.              ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6. This file contains information of two types:
  7.   - plugin features
  8.   - known problems and specifics with some FTP server software
  9.  
  10. The file is divided into sections for different plugin actions:
  11.   1. "Speed"
  12.      Advice on configuring the plugin to achieve maximum/optimum file
  13.      transfer speed;
  14.  
  15.   2. "Directory listings"
  16.      retrieving the list of files in the current directory from the server
  17.  
  18.   3. "Command line"
  19.      notes on command line usage
  20.  
  21.   4. "Copying"
  22.      features related to copying files
  23.  
  24.   5. "Moving"
  25.      features related to moving files
  26.  
  27.   6. "Deleting"
  28.      features related to deleting files from the plugin panel
  29.  
  30.   7. "Various known problems and solutions / FAQ"
  31.      miscellaneous notes not related to a particular operation; Frequently
  32.      Asked Questions.
  33.  
  34. 1. Speed
  35. ~~~~~~~~
  36.   The plugin CAN be configured so that it is at least as fast as other
  37.   FTP clients working on the same machine with the same server and similar
  38.   settings.
  39.  
  40.   Data transmission speed between two machines that can be achieved by
  41.   different FTP clients depends on the following parameters:
  42.     - amount of data transferred to the operating system (socket API) in
  43.       a single batch;
  44.     - percentage of time that the program spends transferring data and that
  45.       it leaves to other programs.
  46.  
  47.   Both of these parameters can be configured in the plugin.
  48.  
  49.   The default amount of data transferred for new connections is specified in
  50.   the plugin configuration dialog. It can also be changed for specific servers
  51.   in the host panel.
  52.  
  53.   The percentage of time the plugin gives back to the system is by default
  54.   configured for medium-speed connections (up to 10 Mbits). It may need to
  55.   be changed only if you have a faster connection (100 Mbits or more).
  56.   This parameter is configured by a registry setting according to the
  57.   instructions in TechInfo.reg.
  58.  
  59.   Some advises:
  60.     a) Changing the amount of data transferred has the maximum effect on
  61.        performance. It can be changed in a very wide range - from tens of
  62.        bytes to tens of megabytes.
  63.  
  64.     b) Most FTP servers working on Unix-like systems work best with small
  65.        buffers (on one site, top speed was achieved with a 50-byte buffer).
  66.        On the other hand, for Windows servers it is usually better to specify
  67.        large buffer size (transfer from an IIS working on the local machine
  68.        with a 8 megabyte buffer was only 30% slower than direct file copy).
  69.  
  70.     c) CAREFULLY read the description of the parameters and remember that
  71.        the WaitXXX parameters establish a direct dependency between CPU load
  72.        and transfer speed. The better the speed, the higher is the CPU load,
  73.        and vice versa.
  74.  
  75.     d) When configuring the WaitXXX parameters, keep in mind that after
  76.        finding an optimum speed with the current size of the copy buffer,
  77.        you may need to tune the copy buffer size again, because the behavior
  78.        of the socket API in high CPU load conditions can be significantly
  79.        different.
  80.  
  81.     e) Remember that you are usually not the only user of the network. If the
  82.        transfer speed suddenly drops, don't immediately blame the plugin.
  83.        First, you should make sure that someone else did not start downloading
  84.        a movie or another big file from the same server and use up the network
  85.        bandwidth...
  86.  
  87.  
  88. 2. Directory listings
  89. ~~~~~~~~~~~~~~~~~~~~~
  90.   Different FTP servers generate different listings in response to the
  91.   same standard command.
  92.  
  93.   1. Some servers generate directory listings with non-standard separator
  94.      characters. As a result, the plugin fails to parse the listing correctly.
  95.      To fix this error, you should change the listing command you use
  96.      ("LIST -la" instead of "LIST" or vice versa).
  97.  
  98.   2. Some servers do not understand the parameters of the "LIST" command
  99.      at all and return only directory names in the listing.
  100.      One known host with this problem is "ftp.timus.ru".
  101.      To fix this, change the listing command you use to "LIST" or switch OFF
  102.      the "Custom LIST command" option.
  103.  
  104.   3. Some servers return wrong file dates and times or do not returns them
  105.      at all.
  106.      Keep in mind that the actual file time and date may not match the time
  107.      and date returned by the server.
  108.  
  109.   4. For files created as symbolic links on the server, a small size is shown
  110.      (several bytes). The value shown is not related to the actual size of the
  111.      file to which the link points.
  112.      If you start downloading such files, the progress indicator will
  113.      immediately reach 100% and show that value until the download is complete.
  114.  
  115.   5. The plugin DOES NOT understand links.
  116.      Links to directories will be shown as files.
  117.      To enter such a directory, type "CD <name of directory>" in the command
  118.      line.
  119.  
  120.  
  121. 3.1. Command line (common)
  122. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  123.   1. You can invoke the plugin from the command line by using the plugin
  124.      prefix "ftp". The details of the prefix syntax are given in the plugin
  125.      help file.
  126.  
  127.   2. You can set a shortcut to an FTP directory (using the standard keyboard
  128.      shortcut Ctrl+Shift+<digit>) and use it for quick access to the
  129.      directory.
  130.      The plugin saves all connection properties in the shortcut data and
  131.      uses them to establish the FTP connection.
  132.  
  133.   3. The plugin understands the "http://" URL prefix but DOES NOT support the
  134.      HTTP protocol. If you enter a host with the "http" prefix, the plugin
  135.      will still connect to it as an FTP server.
  136.  
  137.  
  138. 3.2. Command line (FTP)
  139. ~~~~~~~~~~~~~~~~~~~~~~~
  140.   The plugin can execute FTP commands you enter in command line.
  141.   1. The plugin DOES NOT translate or change the text you enter in the command
  142.      line. It sends the command directly to the server and then processes the
  143.      text reply of the server.
  144.      For example, you can type "HELP" and see the list and syntax of FTP
  145.      commands supported by the server. This command is supported by most
  146.      servers.
  147.  
  148.   2. When a command is executed, the plugin sends its text to the server and
  149.      receives a reply. It DOES NOT create a data transfer connection,
  150.      therefore you cannot execute commands that require data transfer.
  151.  
  152.   3. The plugin cannot execute passive mode (PASV) transfers by itself, but
  153.      it is not too hard to execute such transfers using command line
  154.      commands and two open plugin panels.
  155.  
  156. 4. Copying
  157. ~~~~~~~~~~
  158.   1. For the reason of security for temporary files, try to NOT copy or move
  159.      files between two FTP servers by opening two plugin panels at the same
  160.      time.
  161.      If you wish to copy files between two FTP servers, first download the
  162.      files to a temporary directory, and then upload files to target server.
  163.  
  164.   2. The copy progress dialog may be fully customized (see the plugin Help
  165.      for details).
  166.  
  167. 5. Moving
  168. ~~~~~~~~~
  169.   Plugin can perform rename(move) operation inside currently connected server.
  170.   Plugin perform rename on next conditions:
  171.     1. Rename - If Move and option "Move inside server" in download dialog is set.
  172.     2. Rename - If Move and target name does not contains '/' and '\' characters.
  173.     3. Rename - If Move and target name does not contains '\' characters and ends
  174.                 with '/' character.
  175.   In ALL OTHER cases plugin interpret destination name as name on local disk!
  176.  
  177.   Notes:
  178.   1. Plugin perform Rename operation ONLY if move (F6) action executed.
  179.  
  180.   2. The plugin can correctly move the current item or selection to:
  181.     - the parent directory ("..");
  182.     - the directory specified as an absolute path ("/DestDir");
  183.     - the directory specified as a relative path    ("../DestDir");
  184.     - between plugin panels if both are connected to the same server.
  185.  
  186.   3. The move operation is successful ONLY if:
  187.     - the move source is a file (not a directory or a symbolic link);
  188.     - the target directory is accessible and the user has the right to create
  189.       files in that directory;
  190.     - the move target directory is located under the same mount point as
  191.       the directory containing the move source.
  192.     In other words, a move is possible when it can be performed by the system
  193.     utility "mv" (on Unix-like systems) or "move" (on Microsoft systems).
  194.  
  195.   4. Target directories may start with the plugin prefix ("ftp:/DestDir").
  196.  
  197.   Known problems
  198.   **************
  199.   Moving is a server-specific operation.
  200.   Not all servers understand all the ways to specify paths that you may use.
  201.   The following servers are known to have problems:
  202.     - WarFTP
  203.       Can not move files at all - creates an empty file in the target
  204.       directory and reports that a system error occured. After a rename or
  205.       move operation has failed, the server will fail all actions, until
  206.       you reconnect to the server.
  207.  
  208.     - BlackMoon FTP server
  209.       Does not understand relative pathnames for move operations.
  210.       You may use an absolute pathname to specify the destination.
  211.  
  212.     - BlackMoon FTP server
  213.       When a file is moved to the parent directory "..", reports a successful
  214.       operation, but does not actually create the file at the target location.
  215.       Thus, the file is lost.
  216.       The plugin handles direct moves to the parent directory ("..")
  217.       correctly, but if you specify a relative path containing ".."
  218.       ("/Tmp/.."), you may lose your files.
  219.  
  220. 6. Delete
  221. ~~~~~~~~~
  222.   Known problems
  223.   **************
  224.     - BlackMoon FTP server
  225.       a) Sometimes does not delete files without reporting any errors.
  226.       b) Sometimes does not delete files immediately after performing
  227.          another operation on the same files, and reports the following
  228.          error:
  229.           "The process cannot access the file because it is being used by
  230.           other process"
  231.          You can retry the delete operation later, after the plugin
  232.          releases the files it was using, or keep retrying until the
  233.          operation succeeds.
  234.  
  235.  
  236. 7. Various known problems and solutions / FAQ
  237. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  238.  BlackMoon FTP server
  239.     a) Often generates an error:
  240.          SIZE /HomeAlone3.avi
  241.          550 Requested action not taken
  242.        if you try to retry uploading a file after restoring a connection.
  243.        Looks like the error is caused by the same issue as the "file is
  244.        being used by other process" error when deleting files.
  245.  
  246.     b) Looks like the server writes and reads data in a separate, slow
  247.        thread. As a result, if you upload a file or cancel uploading, you
  248.        cannot access the file until the server releases it completely.
  249.        For example, after canceling an upload, you cannot delete the file
  250.        you just uploaded for the next couple of seconds.
  251.  
  252.  1  Q: The plugin cannot be interrupted during "Resolving address"
  253.     A: The possibility to interrupt this operation correctly has not yet
  254.        been implemented. Previous versions used an illegal way to interrupt
  255.        address resolving, and thus it has been removed.
  256.  
  257.  2  Q: The plugin does not show the copy progress dialog when copying
  258.        a directory tree
  259.     A: The plugin uses the progress dialog to show the process of copying
  260.        FILES. Thus, if you copy an empty directory tree, there is no
  261.        progress to display.
  262.  
  263.  3  Q: The plugin does not show the copy progress dialog when copying files
  264.     A: To reduce the usage of slow console output functions, the plugin
  265.        updates the copy progress dialog no more often than once in a certain
  266.        time interval. Currently, the interval is set to 0.4 seconds.
  267.        In other words, the copy progress dialog is drawn no more often than
  268.        about 3 times per second.
  269.        Thus, if the time of copying a single file is less than this interval,
  270.        the dialog for that file can be shown only once, or not shown at all.
  271.  
  272.  4  Q: I try to enter a directory with a lot of files (several thousand).
  273.        The plugin shows that it is entering the directory, then waits for
  274.        something for a long time and aborts the operation by time-out.
  275.        FAR takes about 5 seconds to enter that directory. What is the
  276.        plugin waiting for? After all, I'm on a 100-Mbit LAN!
  277.     A: First of all, not all FTP servers are optimized for working with a
  278.        large number of files. If FAR takes 5 seconds to enter a directory,
  279.        other programs can require 10 times longer to do the same.
  280.        Second, some FTP servers (for example, WarFTPd) do not transmit the
  281.        list of files one by one while the directory is being scanned, but
  282.        rather send the entire list after the scan is complete.
  283.        If the plugin received some data, the time-out counter would be
  284.        reset. But the server does not send any data before the directory scan
  285.        is complete. Thus, all the time the server spends creating the list
  286.        is seen by the plugin as one long communication interruption.
  287.        If you are on a fast LAN and have a small timeout, the only way to
  288.        solve the problem is to increase the timeout so that the server has
  289.        enough time to generate the file list.
  290.  
  291.  5  Q: I can see a directory but I cannot enter it. All the permissions
  292.        are configured correctly. The FTP server is IIS running under
  293.        Windows.
  294.     A: If you are using Cyrillic characters in directory names, I don't
  295.        know of a solution for this. The plugin transmits the filename
  296.        in the same encoding as it has received it, and that should be
  297.        used for transmitting, but the server fails to understand that.
  298.  
  299.  6  Q: We have two Sun servers. Why does your plugin download files from
  300.        a Sun server much slower than a primitive client working on the
  301.        other Sun?
  302.     A: Did you also try running the plugin on a Sun, to compare the speed?
  303.        You should not compare the operation of the TCP/IP stack of different
  304.        operating systems. Two systems of the same type will always work
  305.        with each other differently from two systems of different types.
  306.        Not worse or better, but differently.
  307.        Parameters like file transfer speed depend on many factors, and you
  308.        should not compare these parameters under conditions that differ so
  309.        much and blame the plugin.
  310.        On the other hand, if you find a Windows FTP client that works
  311.        significantly faster than the FTP plugin, your bug report would be
  312.        most welcome.
  313.  
  314.  7  Q: How to receive list of unix "hidden" files with names starting with ".",
  315.        character, for instance ".bash_profile" ?
  316.     A: To use extended listing command.
  317.        The common used command for this operation is: "LIST -la"
  318.