Contents 
 
What's new ? 
 
Overview 
Installation 
GUI preferences 
 
Global configuration 
IP Access configuration 
User configuration 
Group configuration 
Access configuration 
 
Dotfiles 
Attributes 
Using campus 
Features 
File Security 
 
Bugs and missing features 
Things to do 
Licence 
History 
 
Contact 
Internet Suite 
 
FAQ 
campus - FTP-server for BeOS®

campus: Global configuration

campus uses a textfile as configuration. You can edit this file manually or use the new graphical preferences program.

Either way, campus reloads the configuration as soon it changes on disk at runtime, you do not have to restart the FTP server.

campus looks for the file campus_settings first in the directory where the application itself resides. If it does not find a setting file there it will then check the global settings directory at /boot/home/config/settings. IT it still does not find anything it will give up.

If your configuration file is located in a different location you may specify this on the command line. This is not possible for a start from the Tracker.

All keywords used in the configuration are interpreted case insensitive unless stated otherwise.

Global configuration options

Name  Type  Arguments  Default  Description 
Pedantic  Switch  on, off  off  If set to on campus will not start if something in the configuration seems to be odd. 
Warnings  Switch  on, off  off  Toggles wether campus will warn at startup if it finds something suspicious in the configuration. 
UploadEMail  Textfield  E-mail address  None  The e-mail address used for the keyword of the same name in dot files. See Dotfiles for more information 
AdminEMail 
LogLevel  Integerfield  0-4  Specifies the loglevel. A value of 0 means no logging. Logging increases with the value given. A level of 4 logs everything. 
ResolveHostNames  Switch  on, off  on  Toggles wether campus will try to resolve hostnames using DNS or not. This should normally be enabled, but if a lot of connections have to be processed it is faster and produces lesser network traffic to disable the lookup. 
MaintainAttributes  Switch  on, off  off  Toggles wether campus will maintain attributes about download count and time of files and other things. Have a look at Attributes for more information. 
InstallExtraAttributes  Textfield  MIME type  None  Specifies the MIME type(s), on which the extra attribute informations are added to. See Attributes for more details. 
DontResolveHostNames  Single  None  Resolve hostnames  If given disables the lookup of hostnames. Use as an alternative to ResolveHostNames Off
HostName  Textfield  Full qualified hostname  None.  This specifies the full qualified hostname of the local machine. 
LogFile  Textfield  Absolute filepath  /boot/var/log/campus.log  This specifies the location of the file logging messages will be written to. 
Port  Integerfield  Portnumber (0-65535)  21  This is the port on which campus listens for connections from ftp clients. Remember to disable the ftp-server delivered with BeOS® in /boot/beos/preferences/Network if you want to use port 21. campus will not start otherwise.
MaxConnections  Integerfield  Value > 0  50  This is the maximum number of connections that can be handled at one time. Must be at least 1. 
IdleTime  Integerfield  Value > 0  900  This option specifies the (default) maximum time that an user can be idle before he is logged out by the server. The client may change this value using the SITE IDLE command. (see below for details)  
DotFileMode  Switch  FirstLine/EveryLine  EveryLine  Specifies the mode for printing dotfiles. In FirstLine mode only the first line is prefixed with the status code, in mode EveryLine the status code is printed before each line. 


Index generation

To allow searching the attributes (see Attributes for more detail on names and types) you need indizes. campus can create these indizes for you. To do this the new keyword Index is introduced:

Format:
Index Integer|Time|String [Path]

Remember that the type of index has to match the type of the attribute, otherwise you will not be able to use the index for searching!
A short description of the types:

  • Integer
    Used for the download counter, this type is a ordinary number.
  • Time
    This type is used for the up- and download time attributes.
  • String
    This type is a plain string and is used for the upload user name.

If no Path argument is given the index is created on the boot volume. This fits most installation, but if this is not the volume on which your ftp directories resides, you should add the path to the Index command. campus will then create the index on the volume on which the path (to be precise, a file is also allowed) is located.
If your ftp directories are distributed over multiple volumes you have to create an index on each volume!


Copyright © 1997-2002 Stegemann & Co., Inc., All Rights reserved.
Created: May 7, 2000. Last modified: January 12, 2002.