# The &kasablanca; Handbook

## Using &kasablanca;

### Global Settings

The settings which concern the behaviour of the whole application.

#### Skiplist

Here you can enter a Regular Expression. Transfer items which match this Regular Expression are skipped. For example a value of "^\." excludes every entry beginning with "." from transfer.

#### On queue finished

This field can hold an executable and its arguments which will be run, when last item of in queue has finished transferring. For Example, on TDE desktops the entry "dcop ksmserver ksmserver logout 0 0 0" would shutdown the computer automatically.

#### On file exists

These Radio Buttons indicate how the application should proceed if a file to be transfered already exists on the destination. Usually the user is asked by the application how to proceed if this occurs, in case you aren't present during the transfer you can enable this feature.

#### Priority List

This Field contains a regular expression, which queues the items matching this regular expression before the items which don't. For example, ".sfv" would make the common checksum files with this fileending transfer first.

### Ftp Server Settings

The settings which can be applied to an ftp session are described here.

#### Name

The ftp's name is entered here.

#### Host:Port

This information points to the the ftp server. HOST can either be a standard ip adress like 192.168.2.1 or a domain name. PORT is the port number on which the ftp server listens. In most cases this is 21. Both are seperated by a ":" character. A legit input would be "ftp.kde.org:21".

#### Username

The ftp Login Username. On open ftp servers you usually login using "anonymous".

#### Password

The user's password. Anonymous ftp servers ussually don't use passwords or accept passwords in the form of "user@emailaddress.com".

#### Encryption

There are 4 encryption levels available. Unencrypted leaves all traffic clear and without encryption. Most ftp servers allow only this mode. Level 1 encryption means that the traffic on the control connection is encrypted while data transfer remains clear. Level 2 is basically the same with the exception of directory information which is transfered on the data channel, but is encrypted too. Eventually Level 3 encrypts everything all communication and all data traffic.

#### Mode

The mode you are using for data transfer. This is quite important in case you're behind a firewall or a router. In these cases you depend on the passive mode, which makes the client connects to the ftp server for data transfer. Passive mode is the standard method today, while active mode is the old way to do data transfers, the client listens for the server to connect in active mode.

#### Mode

The mode you are using for data transfer. This is quite important in case you're behind a firewall or a router. In these cases you depend on the passive mode, which makes the client connects to the ftp server for data transfer. Passive mode is the standard method today, while active mode is the old way to do data transfers, the client listens for the server to connect in active mode.

#### Default directory

Here you can type in a path which kasablanca attempts to enter after login.

#### Alternative fxp

Some ftp servers have problems with either active or pasv mode, which is needed for fxp. Using alternative fxp might help in such cases.

#### Correct pasv responses

When ftp servers are behind a router (NAT) they sometimes send wrong pasv responses containing their local IP. This option changes the IP value in pasv responses to the IP you connected to (most likely the servers router).

## Credits and License

&kasablanca;

Program copyright 2004 Magnus Kulke sikor_sxe@radicalapproach.de

Contributors:

- Big Biffbigbiff@chunkyfilms.org

- Stefan Bognerbochi@online.ms

Documentation copyright 2004 Magnus Kulke sikor_sxe@radicalapproach.de

&underFDL; &underGPL;

## Installation

### How to obtain &kasablanca;

The most recent sources are available at https://mirror.git.trinitydesktop.org/gitea/TDE/kasablanca.

### Requirements

In order to use &kasablanca;, you need the TDE libraries as well as an SSL library EG: OpenSSL.

### Compilation and Installation

In order to compile and install &kappname; on your system, first unpack the source code. Then type the following in the base directory of the &kappname; distribution:

    	% mkdir -p build
    	% cd build
    	% cmake ../
    	# make install

You will need the header files from the tdelibs library and OpenSSL installed on your system. Please take a look at the INSTALL file for more cmake options.

You will need to be root before doing the 'make install' step.

Since &kappname; uses `cmake` you should have no trouble compiling it. Should you run into problems please report them to the TDE dev team.

&documentation.index;