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