7 To change the configuration of a mailing list


   /usr/local/fml/makefml config listname


e.g.   /usr/local/fml/makefml config elena


You can configure the "elena" mailing list interactively. You see the
following recursive menu, so please select one and answer it.
See 9.0 for more "config.ph".

7.1 TOP MENU

   === TOP MENU ===

   Mailing List Addresses
        FOR POST          elena@baycity.asia
        FOR COMMAND       elena-ctl@baycity.asia
   _______________________

   0    END		
   1    POLICY OF ACCESS (WHO CAN POST AND USE COMMANDS)

        [POST]
          PERMIT_POST_FROM                 moderator
          WHEN POST FROM NOT MEMBER        reject

        [COMMAND]                          
          PERMIT_COMMAND_FROM              members_only
          WHEN COMMAND FROM NOT MEMBER     reject

   2    REGISTRATION METHOD TYPE

        AUTO_REGISTRATION_TYPE             confirmation
        UNSUBSCRIBE_AUTH_TYPE              address

   3    SETTINGS AROUND COMMANDS
              address for command          elena-ctl@baycity.asia

   4    ML REMOTE ADMINISTRATION              
                     PERMIT ?              NO
                     AUTH_TYPE             crypt

   5    HEADER_CONFIG
        SUBJECT_TAG_TYPE                   
        REWRITE_TO                         To: is original (pass through)

   6    OPTION                             

   7    SECURITY & FILTERING                
   ************************************************************

   Which section? (0-7) [0] 


Please input the number you choose, you see the similar menu in the
next hierarchy.  When you see "[y/n]", please input y(yes) or n(no).


   Mailing List Addresses 


   1    POLICY OF ACCESS (WHO CAN POST AND USE COMMANDS)


The list of choice is 

	post from anyone			anyone
	post from only a member			members_only
	post form only a moderator		moderator


If mail comes from not a ML member, what action should be done?
(=> Section 7.2)

	send back "deny" file to notify "reject"	reject
	automatic registration/subscription		auto_subscribe
	ignore the mail					ignore


In default, the mode of FML is 
	post from only a member			members_only
and
	send back "deny" file to notify "reject"	reject.


Automatic registration is done when mail comes to an address form not
member and the mode for the address is "auto_subscribe".

* MANUAL REGISTRATION

It is default. If fml receives subscribe request, fml sends back a
confirmation to the user. If the user replies it and fml confirms it,
fml sends "someone wants to join our ML" to ML maintainers. After
this, ML maintainers adds the user. 

How to add depends on the configuration. In default fml expects a
maintainer edit member lists by hand. If you use remote administration
commands, please enable it explicitly. 

   [COMMAND]

   3    PERMIT_COMMAND_FROM                members_only
   4    WHEN_COMMAND_FROM_NOT_MEMBER       auto_subscribe


   2    REGISTRATION METHOD TYPE

        AUTO_REGISTRATION_TYPE             confirmation
        UNSUBSCRIBE_AUTH_TYPE              address


The automatic registration type. The default is "confirm" which
requires the confirmation of subscription will.
 (=> Section 7.3)


   3    SETTINGS AROUND COMMANDS
              address for command          elena-ctl@baycity.asia


The address for command (=> Section 7.4).
You can select e.g.
	listname-ctl
	listname
	fmlserv (listserv style interface)


   4    ML REMOTE ADMINISTRATION              
                     PERMIT ?              NO
                     AUTH_TYPE             crypt


You maintain the ML in remote? or not. And the default type is
"crypt". This is "password authentication" and the password is saved
as a crypted. (=> Section 7.5)

                    AUTH_TYPE              crypt


Header configuration, e.g. Subject Tag Type (=> Section 7.6).

   5    HEADER_CONFIG
        SUBJECT_TAG_TYPE                   
        REWRITE_TO                         To: is original (pass through)


Other options (=> Section 7.7).

   6    OPTION                             


Special functions for security (=> Section 7.8 17.0).

   7    SECURITY & FILTERING                


7.2 Manual/Automatic Registration and Access Control Policy

  MENU => POLICY OF ACCESS (WHO CAN POST AND USE COMMANDS)

   WHO CAN POST AND COMMAND

   0    END             

   [POST]

   1    PERMIT_POST_FROM                   members_only
   2    WHEN_POST_FROM_NOT_MEMBER          reject

   [COMMAND]

   3    PERMIT_COMMAND_FROM                members_only
   4    WHEN_COMMAND_FROM_NOT_MEMBER       reject
   ************************************************************

      policy (0-4) [0] 


The permission for post address has the following choice:
	post from anyone			anyone
	post from only a member			members_only
	post form only a moderator		moderator


If mail comes from not a ML member, what action should be done?

	send back "deny" file to notify "reject"	reject
	automatic registration/subscription		auto_subscribe
	ignore the mail					ignore


Caution: you can use "auto_regist" but it is obsolete in fml 3.0 and after.
         It works even in fml 3.0 after for compatibility.
http://www.fml.org/fml/UPGRADE-3.0-e/index.html
 


The example of an automatic registration setting.

   3    PERMIT_COMMAND_FROM                members_only
   4    WHEN_COMMAND_FROM_NOT_MEMBER       auto_subscribe


If you select 1, 

   ************************************************************
   ADDRESSES FOR POST                  elena@baycity.asia
   PERMIT_POST_FROM                   members_only

   0    END
   1    members_only
   2    anyone
   3    moderator
   ************************************************************

         Permit post from  (0-3) [0] 


Please select one of them. 


* Restrict persons who can post to ML, but distribution list is
automatic registered.


$REJECT_COMMAND_HANDLER can have a value 'auto_asymmetric_regist'. If
defined, FML uses delivery list controlled by automatic registration
and authentication list edited by hand (or makefml).
This configuration may be useful to make one way information delivery.
But fml checks a poster by From:, so you may have to consider
moderator or PGP authentication.


	elena/actives	delivery list (automatic registration)
	elena/members	authentication list (edit by hand)


In all cases, even if "anyone" is selected, FML denies From: addresses
which matches $REJECT_ADDR. $REJECT_ADDR is for example, "root",
"MAILER-DAEMON". We reject these addresses since these are public and
not personal since such an address may be a fake. If you permit anyone
in fact, not define $REJECT_ADDR in config.ph.


7.3 The type of Automatic Registration

MENU => REGISTRATION METHOD TYPE => AUTO_REGISTRATION_TYPE


If you select "auto_subscribe" in either REJECT_POST_HANDLER or
REJECT_COMMAND_HANDLER, you can see the following menu

   ************************************************************
   AUTO_REGISTRATION_TYPE       confirm

   0    END
   1    confirmation
   2    body
   3    subject
   4    no-keyword
   ************************************************************


[description]
	confirmation
			RECOMMENDED AGAINST SUBSCRIBE ATTACK!
			the server asks the user (From:) the confirmation
			of subscription will.
        body
			A keyword "subscribe" in the body is required 
			to add him.
			If the keyword not exists or is not matched, 
			not added.
        subject	
			A keyword "subscribe" in the subject is required 
			to add him.
			e.g. Subject: subscribe 
			If the keyword not exists or is not matched, 
			not added.
        no-keyword	added if the mail comes from a not member.


MENU => REGISTRATION METHOD TYPE => UNSUBSCRIBE_AUTH_TYPE


enable confirmation in "unsubscribe" command?(default "NO")

MENU => REGISTRATION METHOD TYPE => CHADDR_AUTH_TYPE	        


enable confirmation in "chaddr" command?(default "NO")


7.4 Address for ML commands

   3    COMMAND ADDRESS 
              address for command          elena-ctl@baycity.asia

In default, fml sets up these addresses for elena ML

	elena		for post
	elena-ctl	for command	
	elena-admin	for maintainer. Human reads mails for this address.

We suppose several environments,
	* You can not control /etc/aliases freely.
	  You have a few limited address.

	* You DO NOT USE well-known addresses such as "listserv".
	  You set up "elena" for post, "elena-ctl" for "elena" ML's command.
	  For security and the concept "ML is a personal communication", 
	  I recommends this style

	* You use listserv-style. Your choice is "fmlserv" listserv emulation.


   ************************************************************
   0    END
   1    CONTROL_ADDRESS                 elena-ctl@baycity.asia
   2    MAIL_LIST_ACCEPT_COMMAND        NOT USE
   ************************************************************


* CONTROL_ADDRESS (gives the following menu)

   ************************************************************
   COMMAND ADDRESS                      elena-ctl@baycity.asia

   For command, which address you use?
   (here DOMAINNAME = baycity.asia);

   0    END
   1    elena-ctl@$DOMAINNAME
   2    elena@$DOMAINNAME
   3    fmlserv@$DOMAINNAME
   4    NOT USE

   In default, we use "listname-ctl" format address for command only.
   If you choice "listname" for commands, 
   your mailing list address receive both posting and commands.
   "fmlserv" is the listserv/majordomo style interface of fml.
   ************************************************************

      which type (0-4) [0] 


   COMMAND ADDRESS                      *** Command Unavailable ***


*  MAIL_LIST_ACCEPT_COMMAND (default: NO)


This menu enables both elena and elena-ctl accepts "# command" trap
for backward compatibility.


7.5 Remote Administration


In default we do not permit remote administration for security.  You
need to enable this function by yourself.  Please see file
"help-admin" for remote administration commands.

   ************************************************************
   REMOTE ADMINISTRATION
   Do you maintain the ML in remote?        no

   0   END
   1   REMOTE ADMINISTRATION              NO
   2   REMOTE_ADMINISTRATION_AUTH_TYPE    crypt
   3   ADMIN_ADD_SEND_WELCOME_FILE        NO
   ************************************************************

      which (0-3) [0] 


*  REMOTE_ADMINISTRATION (default: NO)


If you maintain the ML in remote, please select "yes". You can control
ML to send "# admin command" or "# approve PASSWORD command" format
commands.


*  REMOTE_ADMINISTRATION_AUTH_TYPE (default: crypt)


set up the authentication type in remote administration.

   ************************************************************
   REMOTE_ADMINISTRATION_AUTH_TYPE          crypt

   0    END
   1    pgp
   2    crypt
   3    md5
   4    address
   ************************************************************


	pgp		PGP based authentication


	crypt		password authentication 
			the password is saved in ML/etc/passwd in crypted form


	md5		password authentication 
			the password is saved in ML/etc/passed in md5 form


	address		From: field's address exists in members-admin
			* members-admin is the default of $ADMIN_MEMBER_LIST


*  ADMIN_ADD_SEND_WELCOME_FILE (default: no)


When you do 'admin add' to add a user to your ML, do you want to send
WELCOME_FILE to the user? In default, fml does nothing. It is your job
to notify the registration.


7.6 Header Configurations


   ************************************************************
   0  	END

   * Subject: TAG
   1  	SUBJECT_TAG_TYPE                   
   2  	SUBJECT_TAG_FIGURE                 6

   * To:
   3  	nguage) is fml document formatter system
# designed to generate plaintext, html, texinfo and nroff from one file.
#
# Copyright (C) 1993-1999 Ken'ichi Fukamachi
#          All rights reserved. 
#               1993-1996 fukachan@phys.titech.ac.jp
#               1996-1999 fukachan@sapporo.iij.ad.jp
# 
# FML is free software; you can redistribute it and/or modify
# it under the terms of GNU General Public License.
# See the file COPYING for more details.
./usr/share/doc/fml/html/INSTALL-e/6.html0100644000000000000000000000376007370553143016514 0ustar rootroot INSTALL 6.html
6 To Add And Delete A User In The Mailing List

6.1 Attention When To Add And Delete A User


When you send e-mail to a mailing list server on the same machine as
one running mailing list servers, your mail header may have NOT

	From: username@domain 


BUT

	From: username 


In this case the server recognizes YOU ARE NOT A MEMBER!. To avoid
this error, you can register both addresses "username" and
"username@domain" by "makefml add listname address"

6.2 To Add A New User To The ML


Add a new user "fukachan@baycity.asia" in "Elena" ML.

   /usr/local/fml/makefml adduser elena fukachan@baycity.asia
   /usr/local/fml/makefml add elena fukachan@baycity.asia

6.3 To Remove The User From The ML


Remove "fukachan@baycity.asia" in "Elena" ML.

   /usr/local/fml/makefml byeuser elena fukachan@baycity.asia
   /usr/local/fml/makefml bye elena fukachan@baycity.asia



[PREVIOUS CHAPTER] [NEXT CHAPTER]
Copyright (C) 1993-1999 Ken'ichi Fukamachi
All rights of this page is reserved.

# This Document(html format) is automatically geneareted by fwix.pl. 
# fwix (Formatter of WIX Language) is fml document formatter system
# designed to generate plaintext, html, texinfo and nroff from one file.
#
# Copyright (C) 1993-1999 Ken'ichi Fukamachi
#          All rights reserved. 
#               1993-1996 fukachan@phys.titech.ac.jp
#               1996-1999 fukachan@sapporo.iij.ad.jp
# 
# FML is free software; you can redistribute it and/or modify
# it under the terms of GNU General Public License.
# See the file COPYING for more details.
./usr/share/doc/fml/html/INSTALL-e/7.html0100644000000000000000000004672107370553143016521 0ustar rootroot INSTALL 7.html
7 To change the configuration of a mailing list


   /usr/local/fml/makefml config listname


e.g.   /usr/local/fml/makefml config elena


You can configure the "elena" mailing list interactively. You see the
following recursive menu, so please select one and answer it.
See 9.0 for more "config.ph".

7.1 TOP MENU

   === TOP MENU ===

   Mailing List Addresses
        FOR POST          elena@baycity.asia
        FOR COMMAND       elena-ctl@baycity.asia
   _______________________

   0    END		
   1    POLICY OF ACCESS (WHO CAN POST AND USE COMMANDS)

        [POST]
          PERMIT_POST_FROM                 moderator
          WHEN POST FROM NOT MEMBER        reject

        [COMMAND]                          
          PERMIT_COMMAND_FROM              members_only
          WHEN COMMAND FROM NOT MEMBER     reject

   2    REGISTRATION METHOD TYPE

        AUTO_REGISTRATION_TYPE             confirmation
        UNSUBSCRIBE_AUTH_TYPE              address

   3    SETTINGS AROUND COMMANDS
              address for command          elena-ctl@baycity.asia

   4    ML REMOTE ADMINISTRATION              
                     PERMIT ?              NO
                     AUTH_TYPE             crypt

   5    HEADER_CONFIG
        SUBJECT_TAG_TYPE                   
        REWRITE_TO                         To: is original (pass through)

   6    OPTION                             

   7    SECURITY & FILTERING                
   ************************************************************

   Which section? (0-7) [0] 


Please input the number you choose, you see the similar menu in the
next hierarchy.  When you see "[y/n]", please input y(yes) or n(no).


   Mailing List Addresses 


   1    POLICY OF ACCESS (WHO CAN POST AND USE COMMANDS)


The list of choice is 

	post from anyone			anyone
	post from only a member			members_only
	post form only a moderator		moderator


If mail comes from not a ML member, what action should be done?
(=> Section 7.2)

	send back "deny" file to notify "reject"	reject
	automatic registration/subscription		auto_subscribe
	ignore the mail					ignore


In default, the mode of FML is 
	post from only a member			members_only
and
	send back "deny" file to notify "reject"	reject.


Automatic registration is done when mail comes to an address form not
member and the mode for the address is "auto_subscribe".

* MANUAL REGISTRATION

It is default. If fml receives subscribe request, fml sends back a
confirmation to the user. If the user replies it and fml confirms it,
fml sends "someone wants to join our ML" to ML maintainers. After
this, ML maintainers adds the user. 

How to add depends on the configuration. In default fml expects a
maintainer edit member lists by hand. If you use remote administration
commands, please enable it explicitly. 

   [COMMAND]

   3    PERMIT_COMMAND_FROM                members_only
   4    WHEN_COMMAND_FROM_NOT_MEMBER       auto_subscribe


   2    REGISTRATION METHOD TYPE

        AUTO_REGISTRATION_TYPE             confirmation
        UNSUBSCRIBE_AUTH_TYPE              address


The automatic registration type. The default is "confirm" wh