[PREVIOUS CHAPTER]
[NEXT CHAPTER]
8 FML configuration files, formats and structures
Lists used in FML assumes shell like structures:
a line with "#" is comment.
skip null lines.
8.1 members file formats
Fml 2.2 REL provides the raw format to administrators but not raw
format to general users since general users should not know members
which unsubscribed the ML in the past. Please remember the following
format if you are an administrator.
The format of $MEMBER_LIST (default members) is
#.FML
comments put by fml
#.endFML
address-1
address-2
# address-3
##BYE address-4
address-5
"# something" syntax is comment out but used for member check.
But it is not used for delivery.
"##something" syntax is real comment out.
Hence fml.pl ignores "##BYE address-4" line but address-1,2,3,5 is
candidates for ML members. fml.pl compares a sender (From: line's
address) and address-1,2,3,5 for member check.
8.2 actives file formats
$ACTIVE_LIST (default actives) has a format similar to $MEMBER_LIST.
The format is
address options # comments
* available options:
m=digest-options
r=relay-server
s=1 (skip)
8.3 Differences between $ACTIVE_LIST and $MEMBER_LIST
Please see above on formats. For functions see the chapter on
automatic registration (../how_to_subscribe 5.0). $MEMBER_LIST is used to
compare a sender (From: address) and addresses in lists to check the
sender is a member or not. $ACTIVE_LIST is a list to distribute.
Under automatic registration (not auto_asymmetric_registration),
$MEMBER_LIST == $ACTIVE_LIST internally, fml does not read
$ACTIVE_LIST.
8.4 Plural member lists and delivery lists
You can define arrays
@ACTIVE_LIST plural member lists
@MEMBER_LIST plural delivery lists
fml automatically put $ACTIVE_LIST to @ACTIVE_LIST and uses
@ACTIVE_LIST as a distribute list. In the same way for MEMBER_LIST.
***
turn over actives/members list => ../daily 6.2
8.5 $MSEDN_RC format (digest control file msend.pl uses)
$MSEND_RC is used by msend.pl, the digest delivery program. The format
is
address the first sequence number to send in the next digest.
msend.pl
* generates new user entries.
* updates msendrc if digest is sent.
* removes entry if the mode for a user
is changed to real time delivery.
Only msend.pl control this file.
8.6 Password file format
Password file ($PASSWD_FILE, in default $DIR/etc/passwd) format is
address crypted-password
FML can use MD5 password format file if you set
$REMOTE_ADMINISTRATION_AUTH_TYPE = "md5";
This uses MD5.pm, so you must use perl 5.
To initialize a new password, you can use "makefml passwd ML" and
"admin initpass" command is available when remote administration.
Please see INSTALL for more details how to use makefml.
8.7 Maintenances
Let the configuration be like this
/usr/local/fml executable and libraries
/var/spool/ml/elena elena ML home
"makefml install" installs executables and libraries to /usr/local/fml
and makes directory /var/spool/ml if it does not exist. makefml does
not touch files under /var/spool/ml/elena. In version up, makefml
locks /var/spool/ml/elena before installing. It is just a difference
between initial installation and version up.
How should we maintenance mailing lists? You should set up all
configurations in files, config.ph, site*ph and uses hooks as could as
possible not hack original libraries. If you hack fml sources, version
up working overwrites them. It is also useful for common settings in
ML's are /usr/local/fml/sitedef.ph or /usr/local/fml/site_init.ph.
[PREVIOUS CHAPTER]
[NEXT CHAPTER]