From 14b8a04fba0e733af36282cf1d4454ed73cfa78d Mon Sep 17 00:00:00 2001 From: fukachan Date: Fri, 25 Jul 2003 14:30:51 +0000 Subject: translated --- fml/doc/en/tutorial/overview/fml.sgml | 434 ++++++++++++++++++++++++++++++++++ 1 file changed, 434 insertions(+) create mode 100644 fml/doc/en/tutorial/overview/fml.sgml (limited to 'fml/doc/en/tutorial/overview') diff --git a/fml/doc/en/tutorial/overview/fml.sgml b/fml/doc/en/tutorial/overview/fml.sgml new file mode 100644 index 00000000..b8641166 --- /dev/null +++ b/fml/doc/en/tutorial/overview/fml.sgml @@ -0,0 +1,434 @@ + + + + + &fmldevel; overview + + + + + + + &fmldevel; features + + + + + + + + + new postfix style format configuration files (.cf files). + + + + + + + usage of CUI is same as one unser &fml4; . + You can use CUI(makefml and fml command) + to create/remove ML, + to add/remove/change addresses of ML members, + to add/remove/change address of remote administrators, + to see logs, + to see member list + et.al. + + + + + + CGI interface. + The functions are a subset of CUI. + + + + + + + article delivery, + header rewriting + and + several filters. + + + + + + command mail for users. + + + + + + command mail (admin command) for remote administratoin by mail. + + + + + + automatic analyzer of error messages. + + + + + + + IPv6 ready. + + + + + + + thread track system. + + + + + + + built-in HTML converter of articles. + + + + + + + main programs (fml/libexec): + fml.pl distribute command error + + + + + + + utilities: + fmladdr + fmlailas + fmlconf + fmldoc + fmlhtmlify + fmlsch + makefml + fml + + + + + + + + Abstracted IO + + to get member list in unified way from + a file, + /etc/group, + NIS, + SQL. + + + + + + + + + + + + installation overview + + + + + + +You run GNU autoconf firstly, and "make install". It is standard in +the world of open sources. This procedure is not similar to &fml4; +installation steps. It confuses you but it is friendly for package +systems of free unix like systems. + + + +The main differece between &fml4; and &fml8; in installation is +"work by root", +"use of configure", +and +editing of configuration files: +/usr/local/etc/fml/main.cf +and +/usr/local/etc/fml/site_default_config.ph. + + + + + + +Suppse we craete a new ML named elena ML (elena@fml.org). +The brief flow of installation is as follows: + + + + + + + + download &fml8; source and expand it. + + + + + + + + install by user root. + Firstly, change user to "root" and create the user "fml" and + the group "fml". + Secondly, run + + configure + + and "make install". + + +% su root +# groupadd fml +# useradd -m -g fml fml +# ./configure +# make install + + + + + By default, installer installs utility programs to + /usr/local/bin. + + + You can control paths by + + configure options. + + + + These are wrappers to call real programs at /usr/local/libexec/fml/. + + + + + + + + change user to "fml", create elena ML. + + +% su fml +% makefml newml elena + +You can use "fml" instead of makefml. +Both are same except for the syntax. + +% su fml +% fml elena newml + + + + + + + + Set up MTA. + + + + + + + test. + + + + + + + + cutomize. + + + + + + + + +Please install by user root. +It is differ from &fml4;. + + + + + + + + + + Create an ML + + + +create an ML by CUI (makefml). +To create elena@fml.org ML (fml.org is the default domain), +run + +% su fml +% makefml newml elena + +. See the section + + + +for more details. + + + +Instead, consider a virtual domain nuinui.net. +In this case, specify the whole address. +To create an ML elena@nuinui.net, run the following: + +% su fml +% makefml newml elena@nuinui.net + + + + + + + + + + add a new user to ML + + + +In the case of the default domain (fml.org) + +% su fml +% makefml subscribe elena rudo@nuinui.net + +in the case of virtual domain (nuinui.net), +specify the whole adress of ML. + +% su fml +% makefml subscribe elena@nuinui.net fukachan@sapporo.iij.ad.jp + + + + + + + + + + remove the user + + + +In the case of the default domain (fml.org), + +% su fml +% makefml unsubscribe elena rudo@nuinui.net + +in the case of virtual domain (nuinui.net), +specify the whole adress of ML. + +% su fml +% makefml unsubscribe elena@nuinui.net fukachan@sapporo.iij.ad.jp + + + + + + + + + + customize + + + + +"makefml config" is a CUI to customize ML by menu form. +BUT NOT yet implemented. + + + +Edit files anyway. + + + + + + + + common configurations on this host + + + +/usr/local/etc/fml/site_default_config.cf +affects all ML on this host +irrespective of the default domain or virtual domains. + + +This corresponds to site_init.ph of &fml4;. + + + + + +The format of site_default_config.cf is same as config.cf described +below. + + + + + + + + elena ML's configuration + + + +To customize elena ML, edit +/var/spool/ml/elena/config.cf +file. +The format is a little modified postfix style. +It is differ from both &fml4;'s config.ph and cf. + + + +Add or modify the least variables. +If unspecified, the default value is used. +The default value depends fml version and is defined at + +/usr/local/etc/fml/defaults/${fml_version}/default_config.cf + + + + +The library path depends fml version. + +This technique + +ensures the easy upgrade/downgrade procedure. +This is a feature of &fml8;. + + + + + + + + -- cgit v1.2.1