|
|
campus - The FTP-server for the
BeOS®
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 |
1 |
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:
- deny lines
- 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.
|