FTP options

ftpoptions

The options dialog is used to define the default options associated with new site definitions. This makes it easier to add new sites because you do not need to keep setting or resetting options which are based on your personal favourites or which are affected by your environment.

Anonymous e-mail password
For sites which you connect to using the anonymous user id, you will need to specify a password, typically your e-mail address (although most sites do not and cannot validate this). Use this to personalise your login connections.
Default local directory
Directory where files will be stored when you download them. If this is an absolute directory then files will be stored in a sub-directory based on the sites name and the directory where the file is found. If the default local directory is relative, then the downloaded files will be stored in a sub-directory relative to the current working directory.

Download mode
This option is used to determine the action when you double click a file to download it.

Download and open file
If this option is enabled then after the file has been downloaded, the file will be opened automatically, rather than waiting for an acknowledgement from you in the progress dialog. This is ideal for a local link (fast) network connection.
Download only
When a download is completed, wait for user action in the progress dialog box to determine whether to open the file or not.

General options

Enable LIST -a:

Normally CRiSP will use the “LIST -a” command to show the files in a directory. Some FTP servers do not respond to this and will generate an error. CRiSP tries to automatically detect which server is being connected to, but if it gets it wrong then you will not be able to successfully navigate. In this case, try disabling this option.
Enable debug    Enables tracing of the FTP conversation. Debug is placed in a buffer, called ftpdebug.log, which you can analyse to ensure correct operation. Additional debug can be found in the crisp.log trace file if the CRiSP debug command is enabled although this is much more detailed.

Enable proxy

Specifies whether to enable use of the currently selected proxy server. You can set this option to enabled for all sites, and then globally disable it by using the FTP Proxy dialog and clearing the current proxy server. This makes it simple to switch from a work to a home environment without needing to manually reset each site you wish to contact.
Follow links    When a directory listing is displayed for a Unix system, symbolic links are usually displayed in the format:

file -> real-filename

If this option is enabled and you double click on the file then CRiSP will attempt to change directory to the specified path. If it is not enabled then CRiSP will try to download the specified file. The FTP protocol does not provide sufficient information to enable the local application to determine if the displayed file is actually a file or a directory. In any case you can use the context menu (right mouse click) to select the Change Directory or Download option if CRiSP selects the wrong option.

CWD Keepalive

Used with Maintain Connection to use a different method to keep the connection open by changing to the current working directory.

DIR Keepalive

Used with Maintain Connection to use a different method to keep the connection open by changing doing periodic LIST commands on the remote host. Some FTP servers will detect NOOP or CWD keepalives and this can be used to work around this feature..

Maintain connection
Many FTP servers will drop the connection if it has been idle for 10 minutes or more. This can be an inconvenience if you have selected a site and then switch to doing something else before downloading a file, for instance. Enabling this option will attempt to keep the connection open when no data transfer is taking place. Some sites do not like this from a security point of view and this may not work. In this case, try enabling the CWD Keepalive or DIR Keepalive options to try an alternate mechanism of keeping the remote end happy. DIR keepalives take precedence over CWD keepalives if both are set.

Passive

Specifies whether passive connections are used on the data channel. This may be needed when going through a firewall or a NAT router (Network address translation). This option lets you set the passive mode irrespective of the setting on any proxy server.

Upload files on save
Specifies the action to perform when you save a file which had previously been downloaded from an FTP site.

Every time means to automatically upload the changed file. Prompt is used to display a dialog box giving you the option to upload the file or not. None means not to upload the file, in which case you will need to manually upload the file.

Pause on completion controls what happens after a file has been uploaded. If enabled, then the progress dialog will persist, giving you time to read the statistics. Click on OK in the progress dialog to dismiss it and continue editing. If disabled, then as soon as the upload is finished, the progress dialog will disappear. Pause on completion may be useful when transferring over a slow link, e.g. over the internet. Disabling the option is more suitable for a reliable fast local network.

On autosave can be used if you have the autowrite autosave feature enabled. If both options are set then the remote file will be updated when the autosave is made.

Upload filename translation
Specifies how to translate filenames when files are uploaded (saved). Some operating systems or networking environments may not preserve the case of letters in a filename which can cause ambiguities when uploaded files (e.g. the file might start out as file.txt but be saved as FILE.TXT, causing two files on the remote site). Microsoft Windows does not normally allow this but Unix does and hence saving files between these two systems might lead to problems.

Use this option to force filenames to take on a particular case, e.g. all lower case, upper case, or no translation, as appropriate.

Other
The Timeout parameter controls how long to wait for a response from the remote server before aborting the current operation. The default is 30 seconds which should be more than enough unless the remote server is very busy. If you are suffering abnormal I/O operation timeouts, then it may be worth increasing the value.

Note that if the various keepalive options are enabled, CRiSP will use a default internal value of 60 seconds to ensure the connection stays alive.

The TCP Port field defines the default port to connect on to remote servers. It is not normally necessary to change this value unless you are talking to non-standard sites.

Read more: FTP options

Site properties

siteproperties

The site properties dialog is used to add a new FTP or SFTP definitions. A number of settings are required to define a site, the bare minimum being the hostname and login information for the site. Other attributes may be based on personal preferences as appropriate.
There are two pages of settings - the first set is used for setting the main connection options, and the second is used for setting the options for an SFTP (FTP over SSL) connection.

Site name

Use this field to give a short descriptive name to your site.

Host name

Name of the site to contact or an IP address.

TCP Port

TCP port to connect on. The default value for the TCP protocol is 23.

Username and Password
Information needed for logging in. If you are not using an anonymous login, then you will need to specify a password. CRiSP stores passwords in an encrypted format, but this is not secure and you cannot rely on this to hide your passwords from snoopers. If you work in a sensitive environment then consider not specifying passwords but rely on being prompted for one instead or disable the Save password option.

Anonymous login
If selected, the username and password fields will be updated to reflect an anonymous login.

Save password

Specifies whether the password for this site is to be stored in the ftp.ini file. In a secure environment it is best not to store passwords even although they are encrypted as anyone who can access your ftp.ini file may be able to crack the encryption mechanism used. The encryption mechanism is designed to stop casual snoopers rather than determined hackers.

Transfer as
Specifies the default mode for file transfer. The two options are Binary and Text. Binary is usually the preferred option as it means that when a file is transferred an exact byte for byte copy of the file is created. If you transfer files in text mode then you may find that lines which previously ended in a single newline character will have a carriage return added before the newline. For text files this may not be an issue but for pure binary files (such as executables), it will result in file corruption.

SSH-SFTP support

ssh_sftpsupport

This page of settings is used to set options specific to the SFTP protocol. The secure connection protocol utilises the SSL secure sockets layer to make a connection to a remote host, using the same technology as ssh or scp.
The SSL protocol encompasses a number of encryption algorithms and options, most of which can be defaulted for a connection. You may need to tweak the settings depending on the SSL server you are connecting to.

The following options are available.

Remote command
When using the SFTP protocol, the client end, e.g. CRiSP, needs to tell the remote end what command to execute to provide the FTP file transfer services. CRiSP contains a built in default command for launching the server in the traditional location. Some systems may install SSH services in a non-standard location, so you may need to set this to the full path on the remote end of the server. The default is to try /usr/lib/sftp-server or /usr/local/lib/sftp-server

Protocol options

Enable compression
If set then file transfers will be done using compression. This can significantly speed up transfers, especially as the files you edit will typically be In text format, rather than binary.
Enable non-standard single-DES
This option controls whether to proffer DES link encryption when using the SSH protocol version 2. DES is considered to be relatively weak compared to the other protocols, and if security is a high concern, then it is best to avoid enabling this.

Enable SSH1 protocol
SSH version 1 is an older version of the SSL protocols and is not necessarily as strong, cryptographically as the current version. Use this only if you need to talk to an older server which does not cater for SSH2.
Immitate SSH 2 MAC bug
(MAC stands for Mandatory Access control and has nothing to do with Ethernet media access control). This option lets you interoperate with certain SSH servers which had a bug in the MAC protocol. Not many of these servers should exist as they should have been upgraded by now, but you may need to set this if you get Incorrect MAC received on packet messages in the FTP debug log.

Protocol algorithms
There are numerous algorithms which are supported on the SSL protocol, some being more cryptographically secure than others, but the trade off being complexity and speed of connection. For example, AES which is based on RSA technology, is very secure but can take use a lot of CPU as the challenge-response protocol is initiated on connection. (For example, measured as about 4 seconds of CPU on 1 1GHz Pentium 3, and up to 50 seconds on a DEC Alpha running at 233 MHz).

The WARN protocol entry is used as a dividing line. Any protocols above the warning line will be tried, in order, depending on the remote end. Protocols below the line (e.g. DES) will be tried but only after warning of a lowering of effective security.
Logging If this option is enabled then SSH protocol level packet dumping is performed. This should only be set if requested in order to debug connection problems with a server.

Testimonials

"We find CRiSP an excellent text editor and VITAL's support is very good."

Crisp Screenshots

paypal_horiz