[PREVIOUS CHAPTER] [______TOC_______]
2 makefml HOW-TO

2.1	Lock ML and edit its config.ph


To edit files (e.g. cf, config.ph) under locking a ML like vipw(8),
FML provides the mechanism by "makefml".

	% makefml edit ML [file]


Example: to edit elena/config.ph 
	% makefml edit elena
	% makefml edit elena config.ph

Example: to edit elena/cf
	% makefml edit elena cf


enables you to edit config.ph by hand.
ATTENTION: "makefml config" edits $DIR/cf and creates $DIR/config.ph
from $DIR/cf. If you use "makefml config" usually but now need to set
up FML over "makefml config" spec, you need to edit $DIR/cf manually
and run "make config.ph".

	 cf -> config.ph 


  % makefml update-config.ph ML


3.1 -d


3.2	-v

verbose mode

3.3	-D CONFIG_DIR


3.4	-f system


It is useful for virtual domain setup.

	% makefml -f /some/where/fml/.fml/system install


3.5	-i INPUT-CHANNEL


For examle
  CGI -> open(MAKEFML, "|  makefml -i STDIN  ") ..


3.6	-U


not lock


makefml -U install


3.7	-F


Enforce "newml" operation. For example, to re-create elena ML, runs

makefml -F newml elena


3.8	-E Environment (for GUI)


-E tells makefml under CUI or GUI mode.


3.9	-W cgi (for GUI)

CGI installation mode


3.10	-c cgi.conf (for GUI)

cgi configuration file.


3.11	-m


-m tells whether fml sends command reply mail or not under "makefml
test" emulation mode.


3.12	-u USER


-u tells makefml under $USER.

3.13	-w 


-w is used on Windows 2000/NT4.

3.14	-V VENDOR


VENDER name. It is for debug ?

3.15	-A ARCHITECTURE


mainly for debug ?


3.16	-O OPERATING-SYSTEM


mainly for debug ?


4.1 directiry hier


fml 4.0 clean up the directory hierarchy to 4 locations following
each objective.

	$DIST_AUTH_KEYRING_DIR     = "$DIR/etc/dist-auth";
	$DIST_ENCRYPT_KEYRING_DIR  = "$DIR/etc/dist-encrypt";
	$ADMIN_AUTH_KEYRING_DIR    = "$DIR/etc/admin-auth";
	$ADMIN_ENCRYPT_KEYRING_DIR = "$DIR/etc/admin-encrypt";

     * PGP keys for encryption of articles
	$DIST_ENCRYPT_KEYRING_DIR	
	Example: /var/spool/ml/elena/etc/dist-encrypt/

     * PGP keys for the autentication of admin command mails
	$ADMIN_AUTH_KEYRING_DIR
	Example: /var/spool/ml/elena/etc/admin-auth/


4.2	How to make makefml to manipulate PGP keys


	makefml	mode.PGP-COMMAND-NAME


	% makefml admin-auth.pgp2 elena [pgp options]


If you set environment variable MAKEFML_PGP_DEFAULT_MODE to be
"admin-auth", pgp becomes admin-auth.pgp. 

	% setenv MAKEFML_PGP_DEFAULT_MODE admin-auth
	% makefml pgp elena


By default, the following two samples are the same.

	% makefml pgp elena
	% makefml admin-auth.pgp elena


4.3	makefml without abbrebiation  (authentication of admin commands)


	makefml admin-auth.pgp
	makefml admin-auth.pgp2
	makefml admin-auth.pgp5
	makefml admin-auth.pgpk
	makefml admin-auth.pgps
	makefml admin-auth.pgpe
	makefml admin-auth.pgpv
	makefml admin-auth.gpg


You can abbrebiate admin-auth as "aa".

	makefml aa.pgp2
	makefml aa.pgp5
	makefml aa.gpg


4.4	makefml usage (article encryption)


	makefml dist-encrypt.pgp
	makefml dist-encrypt.pgp2
	makefml dist-encrypt.pgp5
	makefml dist-encrypt.pgpk
	makefml dist-encrypt.pgps
	makefml dist-encrypt.pgpe
	makefml dist-encrypt.pgpv
	makefml dist-encrypt.gpg


You can use de as dist-encrpyt.

	makefml de.pgp2
	makefml de.pgp5
	makefml de.gpg


4.5	What is differant between fml 3.0 and 4.0


		/var/spool/ml/elena/etc/pgp/


		$DIST_ENCRYPT_KEYRING_DIR = $PGP_PATH;
		$ADMIN_AUTH_KEYRING_DIR   = $PGP_PATH;


		% cd /var/spool/ml/elena/etc
		% ln -s pgp dist-encrypt
		% ln -s pgp admin-auth


	makefml pgp elena


	makefml admin-auth.pgp2 elena