File directories and subdirectories are similar to message conferences and areas to set up in that they have a main section followed by sections describing each subdirectory.

Example Config

[main]
Visible Sec Level = 10
Visible On Web = false
Visible Req Flags = someflag anotherflag
Visible Not Flags = thirdflag

[Area One]
Database = area_one
Download Sec Level = 10
Upload Sec Level = 99
Upload Path = /path/to/MagickaBBS/files/area_one
Download Req Flags = someflag
Download Not Flags = anotherflag
Upload Req Flags = thirdflag
Upload Not Flags = someflag

[Area Two]
Database = area_two
Download Sec Level = 10
Upload Sec Level = 99
Upload Path = /path/to/MagickaBBS/files/area_two

In the main section variables apply to the whole directory,

  • Visible Sec Level

This is the security level required to view the directory.

  • Visible On Web

This is either true, false or authenticated if you want it visible and the files downloadable via the website.

  • Visible Req Flags

Required flags (seperated by space) that a user needs to see this file directory. (Not required)

  • Visible Not Flags

Required flags a user must not have to see this file directory. (Not Required)

The section name for the sub-directory is the name of the sub directory.

  • Database

is the name of the database that stores the information of the files, it is stored in the main BBS directory. No extension is required.

  • Download Sec Level

This is the security level required to download files from the subdirectory.

  • Upload Sec Level

This is the security level required to upload files to the subdirectory.

  • Upload Path

This is the directory in which uploads are stored for the subdirectory, make sure it’s writable for the BBS.

  • Upload Req Flags

Flags required by a user to be able to upload in this directory. (Not Required)

  • Upload Not Flags

Flags a user is required not to have to be able to upload in this directory. (Not Required)

  • Download Req Flags

Flags required by a user to be able to download from this directory. (Not Required)

  • Download Not Flags

Flags a user is required not to have to be able to download in this directory. (Not Required)

Uploading Files

When a user (or the sysop) uploads a file, they are not approved by default, so they will not be shown in the listings. To approve uploaded files, the sysop should run the filecenter utility on the database.

cd utils/filecenter
./filecenter -c ../../config/bbs.ini

This will list all the files in the database, and allow the sysop to toggle the approved status, or remove the file entirely.

Mass Uploading

If you have a directory full of files you want to upload, you can use the massupload perl script. This script will upload and approve all files in a folder, and if they are ZIP files check for file_id.diz files and import them into the description.

./utils/massupload/massupload.pl /path/to/MagickaBBS/files/area_one area_one.sq3

Note that you must use the FULL path of the directory the files are in.