]> git.treefish.org Git - fex.git/blobdiff - lib/fex.ph
Original release 20160919
[fex.git] / lib / fex.ph
index f7d26e56b25b686411a9f649acdcc9b84b03d942..d1596e248c2c7962cc0373d967405b9cc531d6de 100644 (file)
@@ -1,26 +1,28 @@
+# -*- perl -*- #
+
 ## your F*EX server host name (with domain)
 $hostname = 'MYHOSTNAME.MYDOMAIN';
 
 ## admin email address used in notification emails
-## to change it, you must call: fac -/ admin-email-address auth-id
+## to change it, you MUST call: fac -/ admin-email-address auth-id
 $admin = 'fex@'.$hostname;
 
-## server admin email address shown on web page 
+## server admin email address shown on web page
 $ENV{SERVER_ADMIN} = $admin;
 
 ## restrict web administration to ip range(s)
 @admin_hosts = qw(127.0.0.1 10.0.0.0-10.10.255.255);
 
-## Bcc address for notification emails
+## Bcc address for notification emails, must not be empty
 $bcc = 'fex';
 
-## send notifications about new F*EX releases
+## send notifications about new F*EX releases (bugfixes!)
 $notify_newrelease = $admin;
 
 ## optional: download-URLs sent in notification emails
 # @durl = qw(
-#   http://MYFEXSERVER/fop 
-#   https://MYFEXSERVER/fop 
+#   http://MYFEXSERVER/fop
+#   https://MYFEXSERVER/fop
 #   http://MYPROXY/fex/fop
 # );
 
@@ -32,7 +34,7 @@ $mailmode = 'AUTO';
 ## optional: your mail domain
 ## if set it will be used as domain for every user without domain
 ## local_user ==> local_user@$mdomain
-## if not set, addresses without domains produce an error
+## if not set, addresses without domain produce an error
 # $mdomain = 'MY.MAIL.DOMAIN';
 # $admin = 'fexmaster@'.$mdomain;
 
@@ -50,6 +52,9 @@ $mailmode = 'AUTO';
 ## optional: suppress funny messages
 # $boring = 1;
 
+## optional: suppress warning messages about incompatible web browsers
+# $nowarning = 'YES';
+
 # locales to present (must be installed!)
 # if empty, present all installed locales
 # @locales = qw(english swabian);
@@ -61,37 +66,46 @@ $mailmode = 'AUTO';
 # $spooldir = "$ENV{HOME}/spool";
 # $logdir = $spooldir;
 
-## Default quota in MB for recipient; 0 means "no quota"
-$recipient_quota = 0; 
+## default quota in MB for recipient; 0 means "no quota"
+$recipient_quota = 0;
 
-## Default quota in MB for sender; 0 means "no quota"
-$sender_quota = 0; 
+## default quota in MB for sender; 0 means "no quota"
+$sender_quota = 0;
 
-## Expiration: keep files that number of days (default)
-$keep = 5; 
+## expiration: keep files that number of days (default)
+$keep = 5;
 
-## Expiration: keep files that number of days (maximum)
+## expiration: keep files that number of days (maximum)
 $keep_max = 99;
 
-## Autodelete: delete files after download (automatically)
+## autodelete: delete files after download (automatically)
 ##     YES     ==> immediatelly (1 minute grace time)
-##     DELAY   ==> after download at next fex_cleanup cronjob run 
+##     DELAY   ==> after download at next fex_cleanup cronjob run
 ##      2       ==> 2 days after download (can be any number!)
 ##     NO      ==> keep until expiration date (see $keep)
 $autodelete = 'YES';
 
+## purge: purge files after that number of days after their deletion
+##        (purge deletes file meta-information)
+$purge = '3*$keep';
+
 ## if the file has been already downloaded then subsequentials
 ## downloads are only allowed from the same client (uses cookies)
 ## to prevent unwanted file sharing
 $limited_download = 'YES';
 
-## Allow or disallow overwriting of files
+## allow RECIPIENT = SENDER
+## in this case subsequentials downloads from any ip are possible until
+## regular file expiration (KEEP); exception for $limited_download
+$fex_yourself = 'YES';
+
+## allow overwriting of files
 $overwrite = 'YES';
 
-## Allow user requests for forgotten auth-IDs (then send by email)
+## allow user requests for forgotten auth-IDs (then send by email)
 $mail_authid = 'YES';
-                                                  
-## optional: from which hosts and for which mail domains users may 
+
+## optional: from which hosts and for which mail domains users may
 ##           register themselves as full users (must set both!)
 # @local_hosts = qw(127.0.0.1 ::1 10.10.100.0-10.10.200.255 129.69.1.129);
 # @local_domains = qw(uni-stuttgart.de flupp.org);
@@ -106,8 +120,8 @@ $mail_authid = 'YES';
 ## optional: allow restricted user registration only by certain hosts
 # @registration_hosts = qw(129.69.0.0-129.69.255.255 176.9.84.26);
 
-## optional: for certain remote domains do not use sender address in 
-##           notfication email From, because their MTA will probably 
+## optional: for certain remote domains do not use sender address in
+##           notfication email From, because their MTA will probably
 ##           reject it if From and To contain their domain name.
 ##           Instead use $admin for From. See also $sender_from
 # @remote_domains = qw(flupp.org);
@@ -118,12 +132,22 @@ $mail_authid = 'YES';
 ## optional: allow anonymous upload without authentication for these IP ranges
 # @anonymous_upload = qw(127.0.0.1 ::1 10.10.100.0-10.10.200.255 129.69.1.129);
 
+## optional: mailing list addresses (allows multiple downloads)
+# @mailing_lists = qw(admin@my.domain *@listserv*);
+
 ## optional: forbidden addresses
-# @forbidden_recipients = qw(nobody@* *@listserv*);
+# @forbidden_recipients = qw(nobody@* postmaster@else.where);
 
 ## optional: forbidden ip addresses for CGIs
 # @forbidden_hosts = qw(64.124.0.0-64.125.255.255);
 
+# forbidden user agents (sucking "download manager", etc)
+@forbidden_user_agents = qw(
+  FDM
+  Download.Master
+  Java/[\d\.]+
+);
+
 ## optional: restrict upload to these IP ranges
 # @upload_hosts = qw(127.0.0.1 ::1 10.10.100.0-10.10.200.255 129.69.1.129);
 
@@ -134,7 +158,7 @@ $mail_authid = 'YES';
 ##           0 means : full speed
 ##           first match wins
 # @throttle = qw(
-#      framstag@*:0 microsoft.com:100 
+#      framstag@*:0 microsoft.com:100
 #      127.0.0.1:0 202.0.0.0-211.255.255.255:1024
 #      [::1]:0 [fe00::0-fe00::ffff]:0
 # );
@@ -148,9 +172,16 @@ $mail_authid = 'YES';
 # @file_link_dirs = qw(/sw /nfs/home/exampleuser);
 
 ## optional: allow additional directories with static documents
-##           ($docdir (/home/fex/htdocs) is always allowed implicitly)
+##           $docdir (/home/fex/htdocs) is always allowed implicitly
 # @doc_dirs = qw(/sw /nfs/home/exampleuser/htdocs);
 
 ## optional: text file with your conditions of using
-## will be append to registrations request replies
+##           will be append to registrations request replies
 # $usage_conditions = "$docdir/usage_conditions.txt";
+
+## optional: redirect URIs
+##           URLs with leading ! are active http redirects
+# %redirect = (
+#   '/fstools/'   => '!http://fex.belwue.de/fstools/',
+#   '/usecases/'  => 'http://fex.belwue.de/usecases/',
+# );