Contents 
 
What's new ? 
 
Overview 
Installation 
GUI preferences 
Configuration 
Dotfiles 
Using campus 
Features 
Security 
 
Bugs and missing features 
Things to do 
Licence 
History 
 
About the author 
Internet Suite 
 
FAQ 
campus - The FTP-server for the BeOS®

campus: Configuration

At the moment configuration is only possible using a textfile. campus looks for /boot/home/config/settings/campus_settings at startup and uses the values found there. You can specify a different configuration location on the command line though.

All keywords used in the configuration are interpreted case insensitive if nothing different is stated.

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. 
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. 
DontResolveHostNames  Single  None  Resolve hostnames  If given disables the lookup of hostnames. Use as an alternative to ResolveHostNames
Minimized  Single  None  Not minimized  If given the server window will be hidden at startup. 
HostName  Textfield  Full qualified hostname  As specified in the network settings  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 the 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)  

Multiuser configuration options

The multiuser capabilities of campus are based on users and groups and so-called path-lines which allow or deny acces to certain directories.

All users must be defined before any group and all groups before any path line. Otherwise you may get unexpected results.

User lines

User lines have to begin with User, the other options can be in arbitrary order.

Note: In the unregistered version only 10 user lines are allowed.

Format:
User Username [Password Password | Public] [Alias alias1,alias2,...] Homedir Homedirectory [Rootdir Rootdirectory] [Changeroot] [ShowLinks] [Limit Usercount]

Keyword  Type  Arguments  Description 
User  Required  Username  Defines a new user with name Username. Usernames have to be unique and may not contain white space. 
Password  Multiple Choice  The users password  The user must either have a password or be declared to be a public user, who does not need a password. A public users home directory is also his root directory. 
Public  None 
Limit  Optional  Userlimit  Sets the maximum number of concurrent logins for this user. 
Alias  Optional  List of aliases, separated with comma  Defines aliases for the user. Aliases have to be unique. 
Homedir  Required  Path  Defines the absolute path to the the users home directory. 
Rootdir  Optional  Path  Defines the absolute path to the the users root directory. From the clients point of view this defines his '/'. campus will not allow operations above this directory. The only way to get to a higher level directory is the use of a symbolic link. See also: campus: Security 
Changeroot  Optional  None  Makes the users homedir his root directory. 
Showlinks  Optional  None  If Showlinks is given, the user will see to which file a symbolic link points.
This is a possible security hole when the user has a root directory different from '/' ! 

Group lines

Group lines have to begin with Group, the other options can be in arbitrary order.

Note: In the unregistered version only 10 group lines are allowed.

Format:

Group Groupname [Alias alias1,alias2,...] [Members member1,member2,...]

Keyword  Type  Arguments  Description 
Group  Required  Groupname  Defines a new group with name Groupname. Groupnames have to be unique and may not contain white space. 
Alias  Optional  List of aliases, separated with comma  Defines aliases for the group. Aliases have to be unique. 
Members  Required  List of members, separated with comma  You can specify users and groups in this field. Forward references are not possible, all of the members must be defined beforehand. 

Special users and groups

Currently only one special name is defined by campus and may not be used as name or alias for an user or a group. The special name all is used in path lines to include all users in a line.

Path lines

Path lines are different from user and group lines in that they do not gebin woth path but directly with what kind of path line they are. There are two types of path lines:
  1. deny lines
  2. allow lines
Deny lines deny access for certain users and groups to a certain path, which can be either a directory, in which case the deny includes all directories below the one specified in the deny line or a single file.

Path lines have to begin with Deny or Allow, the other options can be in arbitrary order.

Note: In the unregistered version only 25 path lines are allowed.

Format:
Deny Path Users user1,user2,... Permissions permission1,permission2,...
Allow Path Users user1,user2,... Permissions permission1,permission2,...

See campus: Security for details on how to create a secure configuration.

Allow lines on the other hand allow the user/group to perform certain actions. The names of the actions and a description of what they stand for is given here:

Permission  User is allowed/denied to... 
all  do everything from list below. 
list  list a directory. 
get  retrieve a file. 
put  upload a file. (If a file with the same file name exists the permission to delete it is checked.) 
chmod  change the permission bits of a file. 
cd  change to the directory. 
delete  delete a file. (For deleting a directory the delete permission for the the parent directory is checked.) 
idle  change the maximum idle time. (Maximum idle time is forced to be between 30 and 7200 seconds.) 
umask  change the file creation mask. 
rename  rename a file. 
mkdir  create a new directory. 


Copyright © 1997-99 Stegemann & Co., Inc., All Rights reserved.
Created: March 4, 1998. Last modified: April 25, 1999.