[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]