\documentclass{howto}

\title{GNU Mailman - インストールマニュアル}
\author{Barry Warsaw}
\authoraddress{\email{barry(at)python.org}}

\date{\today}
\release{2.1}                   % software release, not documentation
\setreleaseinfo{}               % empty for final release
\setshortversion{2.1}           % major.minor only for software

\begin{document}

\maketitle

% This makes the Abstract go on a separate page in the HTML version;
% if a copyright notice is used, it should go immediately after this.
%
\ifhtml
\chapter*{序\label{front}}
\fi

\begin{abstract}
\noindent
この文書は GNU Mailman を POSIX システム (例: \UNIX{}, MacOSX, GNU/Linux)
にインストールする方法を説明するものです. 基本的なインストール手順
だけでなく, あなたが使用するウェブとメールサーバに統合するための
ガイドラインを含んでいます\footnote{
訳注：現時点で翻訳は訳者（菊地・池田）の環境において確認できる部分
に限られています.
}.



\noindent
GNU Mailman のウェブサイトは \url{http://www.list.org} です.
\end{abstract}

% The ugly "%begin{latexonly}" pseudo-environment supresses the table
% of contents for HTML generation.
%
%begin{latexonly}
\tableofcontents
%end{latexonly}


\section{インストールの必要事項}

GNU Mailman は \UNIX{} や MacOSX, GNU/Linux といった POSIX に基くシステム
のほとんどで稼動します. 現在のところ Windows では動きません. あなたが
メールを送信できるメールサーバを必要とし, CGI/1.1 API を備えたウェブ
サーバが必要です. ウェブサーバには
\ulink{Apache}{http://httpd.apache.org} が, ぴったりです. メールサーバには
例えば,
\ulink{Postfix}{http://www.postfix.org},
\ulink{Exim}{http://www.exim.org},
\ulink{Sendmail}{http://www.sendmail.org}, 
\ulink{qmail}{http://cr.yp.to/qmail.html} 
などはどれも使えます.

Mailman をソースからインストールするには, セキュリティ向上のために
用いられている ラップ\footnote{訳註: wrapper ... ○○ラップ(商品名)と同じ
「包む」という意味なので, こう訳してみました}
プログラムを構築するときに, ANSI C コンパイラーが
必要です. \ulink{GNU C コンパイラ gcc}{http://gcc.gnu.org} の 2.8.1 以降の
バージョンでうまくいきます.

システムには \ulink{Python}{http://www.python.org} インタプリタが
どこかにインストールされていなければなりません.
Mailman 2.1 には Python 2.1 またはそれよりも新しいものが必要です.
Python 2.3 以上を推奨します.

\section{システムセットアップ}

Mailman ソフトウェアのインストールの前に，特定のユーザとグループを
追加登録することでシステムの準備をする必要があります.
このため, この節のステップを実行するには root になる必要があります.

\subsection{グループとユーザの追加}

Mailman は, ファイルを所有し, プロセスを走らせるために, 他で使用されていない
ユーザとグループの名前を必要とします. Mailman の基本的なセキュリティは
グループ所有権の許可(パーミッション)に基いています. 従って, このステップを
きちんとしておくことが重要です\footnote{インストールが完了してから
パーミッションをチェックして修正することができます.}. 典型的には,
\code{mailman} という名前のユーザとグループを作成することになります.
\code{mailman} ユーザは \code{mailman} グループのメンバーでなければ
なりません. Mailman は \code{mailman} ユーザとグループの下に,
set-group-id (setgid) ビットを立ててインストールされます.

もし, この名前が既に使われていたなら, 別のユーザとグループ名を選ぶことが
できますが, \program{configure} を走らせるときに覚えておかないといけません.
もし, 別のユーザ名を選んだなら, これを \program{configure} の
\longprogramopt{with-username} オプションで指定します. また, 別の
グループ名を選んだ場合には, \program{configure} の 
\longprogramopt{with-username} オプションで指定してください.

Linux システムでは, 次のコマンドでこれらのアカウントを作成することが
できます. ご利用のシステムのマニュアルで詳細を確認してください:

\begin{verbatim}
    % groupadd mailman
    % useradd -c''GNU Mailman'' -s /no/shell -d /no/home -g mailman mailman
\end{verbatim}

\subsection{インストールディレクトリの作成\label{create-install-dir}}
通常, Mailman は単一のディレクトリにインストールされ, そこには
Mailman ソースコードと, 実行時のデータ(リストと保存書庫)の両方が入ります.
静的なプログラムファイルと変化するデータファイルを分離して, 別のディレクトリ
に入れることも可能です. ここではこのことに関するオプションを説明します.

Mailman のデフォルトのインストールディレクトリは
\file{/usr/local/mailman}\footnote{これは Mailman 2.1 のデフォルトです.
以前のバージョンでは, /home/mailman に全てインストールしていました.}
このインストールディレクトリ(\var{\$prefix} で参照します) を変更するには
configure で \longprogramopt{prefix} オプションを使います.
以前のバージョンから更新するには, インストールディレクトリを変更す
るので無い限り, \longprogramopt{prefix} を設定する必要があります.

\begin{notice}[警告]
Mailman を \code{nosuid} オプションでマウントされたファイルシステムに
インストールすることはできません. これがあると Mailman のインストールに
失敗します. というのは, セキュリティ上の理由で setgid プログラムの利用を
前提としているからです. もし, これがあてはまるようでしたら, 単純に,
setgid プログラムを許している場所に Maiman をインストールしてください.
\end{notice}

インストールのディレクトリが \code{mailman} グループに設定されて
いることを確認してください (あるいは \longprogramopt{with-groupname} で指定
しようとしているグループ). そして, setgid ビットがセットされ
ていることを確認してください\footnote{もし, BSD システムを使うなら
\ref{bsd-issues} も読んでください} また, このディレクトリが全ての
ユーザに読み取りと実行(移動)可能であることを保証したいと思う
でしょう. 以下のシェルコマンドでこれらのことが設定できます:

\begin{verbatim}
    % cd $prefix
    % chgrp mailman .
    % chmod a+rx,g+ws .
\end{verbatim}

これで, Mailman ソフトウェアを configure しインストールする
準備ができました.

\section{Mailman の構築とインストール\label{building}}

\subsection{\program{configure} を実行}

Mailman をインストールする前に \program{configure} を実行して, システム
で必要になるいろいろなインストールオプションを設定しなければなりません.

\begin{notice}[注意]
下にある，\longprogramopt{with-mail-gid} と \longprogramopt{with-cgi-gid}
のオプションに特に注意. 多分これが必要になります.
\end{notice}

この節に書いてある手順を実行する間は, あなたは root に
なるべきではあり \strong{ません}. 自分自身のログイン名か, 他のソフトを
インストールするときに使うアカウントを使ってください. また,
\code{mailman} ユーザになる必要はありませんが, そうしても構いません.
但し, 前の手順で作成した \var{\$prefix} ディレクトリの書き込み許可を
得るためには, そのアカウントが \code{mailman} グループに所属している
必要があります.
ターゲットのインストールディレクトリに書き込み権限があることと,
そこに setgid ファイルを作成できることを確認してください.
(NFS や他のマウント方式で setgid を禁止している場合があります)

もし, 他の GNU ソフトをインストールしたことがあるなら, \program{configure}
スクリプトにはおなじみでしょう. Mailman の tarball を開いた
ディレクトリに \program{cd} して, \program{configure} を引数を付けずに実行して
ください:

\begin{verbatim}
  % cd mailman-<version>
  % ./configure
  % make install
\end{verbatim}

以下のオプションで Mailman のインストールをカスタマイズできます.

\begin{description}
\item[\longprogramopt{prefix}=\var{dir}]
    標準的な GNU configure のオプションで Mailman がインス
    トールされることになるベースのディレクトリを変更します．
    デフォルトでは \var{\$prefix} は \file{/usr/local/mailman} です．この
    ディレクトリはその時点で存在していなければならず, 
    \ref{create-install-dir} で説明したようにセットアップされていなけれ
    ばなりません．

\item[\longprogramopt{exec-prefix}=\var{dir}]
    標準的な GNU configure のオプションでアーキテクチャに
    依存したバイナリのインストールディレクトリを指定できます．

\item[\longprogramopt{with-var-prefix}=\var{dir}]
    交換可能なデータを \var{\$prefix} や \var{\$exec-prefix} の代わりに
    \var{dir} の下に保存します. このようなデータの例としては,
    リストの保存書庫やリスト設定データベースがあります.

\item[\longprogramopt{with-python}=\file{/path/to/python}]
    ラッププログラムで使用する Python インタプリタを変更
    して指定することができます．デフォルトはシェルの \var{\$PATH}
    の中で最初に見つかったものを使います.

\item[\longprogramopt{with-username}=\var{username-or-uid}]
    \code{mailman} でないユーザ名を使う場合に指定する.
    このオプションの値には整数のユーザID またはユーザ名を使うことができます.
    \var{\$prefix} ディレクトリがこのユーザの所有であることを確認してください.

\item[\longprogramopt{with-groupname}=\var{groupname-or-gid}]
    \code{mailman} でないグループ名を使う場合に指定する.
    このオプションの値には整数のグループID またはグループ名を使うことができます.
    \var{\$prefix} ディレクトリがこのグループの所有であることを確認してください.

\item[\longprogramopt{with-mail-gid}=\var{group-or-groups}]
    メールラップ を介してスクリプトを実行する際のグループを
    指定します．\var{group-or-groups} は，１個または複数の整数
    のグループID でも，グループの名前であっても可です．リス
    トの最初の値で実際に存在 するグループの値が使用されます．
    デフォルトでは，これは \code{mailman} \code{other} \code{mail}
    \code{daemon} のリストになっています.

    \begin{notice}[note]
    これは高度にシステム依存であり，正しい値を知っておく必
    要があります．というのは，グループ ID が メールラップ プロ
    グラムにコンパイルされてセキュリティを高めるからです．
    \program{Sendmail} を使っているシステムでは, \file{sendmail.cf} に 
    \var{DefaultUser} を使って \program{sendmail} プロセスの gid が 設定
    されています．(もし，コメントアウトされていたら，それで
    もデフォルトを示しているかもしれません)
    \end{notice}

    このスイッチの正しい値を知るために, 使用しているメールサーバの
    説明や設定ファイルをチェックしてください.

\item[\longprogramopt{with-cgi-gid}=\var{group-or-groups}]
    CGI ラップ を介してスクリプトを実行する際のグループを
    指定します. \var{group-or-groups} は, 1個または複数の整数
    のグループID でも，グループの名前であっても可です．リス
    トの最初の値で実際に存在 するグループの値が使用されます．
    デフォルトでは，これは \code{www} \code{www-data} \code{nobody} の リスト
    になっています．

    \begin{notice}[note]
    この値は Web サーバの設定に依存します．正しい値を知っ
    ておく必要があります． というのは，グループIDがCGI ラップ
    プログラムにコンパイルされてセキュリティを高めるからで
    す．これが違っていると Mailman CGI スクリプトは 動きま
    せん．
    \end{notice}

    もし Apache を使っていれば，\file{httpd.conf} に書かれている 
    \var{Group} オプション の値をチェックしてください．

\item[\longprogramopt{with-cgi-ext}=\var{extension}]
    cgi プログラムの拡張子を指定します. \file{\var{\$prefix}/cgi-bin} に
    置かれた CGI ラップ はこの拡張子を持ちます．(ウェブサーバ
    によっては 拡張子が必要です) \var{extension} には区切りの . (dot) 
    を入れておくこと．

\item[\longprogramopt{with-mailhost}=\var{hostname}]
    メールが出て行く時のホスト名(FQDN)を指定します. インストール
    が完了すれば, この値は \file{\var{\$prefix}/Mailman/mm_cfg.py} で上書き
    することができます.

\item[\longprogramopt{with-urlhost}=\var{hostname}]
    ウェブ URL のホスト名 (FQDN) を指定します. インストールが
    完了すれば, この値は \file{\var{\$prefix}/Mailman/mm_cfg.py} で上書き
    することができます.

\item[\longprogramopt{with-gcc}=no]
    gcc が見つかっても使いません．\program{cc} が \var{\$PATH} に無いとい
    けません．

\end{description}

\subsection{Make とインストール}

\program{configure} を実行したら, \program{make} を走らせ, 次に
\program{make install} とすることで, Mailman を構築しインストールする
ことができます.

\section{インストールのチェック}

\program{make install} を実行した後, 正しいパーミッションとグループ
所有権が設定されていることを \program{check_perms} スクリプトで
確かめてください. まずインストールディレクトリ(\var{\$prefix})に移動します.
そして, \program{bin/check_perms} プログラムを実行します. 
ソースディレクトリで \program{bin/check_perms} を実行しようとしないでく
ださい. インストールディレクトリでのみ実行可能です.

これが問題を報告しなければ, あなたのインストールは正しく設定さ
れていた可能性が高い <ウィンク> です. もし, 問題点が報告されたら,
手で修正するか, もう一度インストールをやりなおすか, \program{check_perms}
を使って(多分, 一番簡単)修正することが出来ます.

\begin{itemize}
\item インストールを行ったユーザ (\var{\$prefix} のファイルの所有権を持つ
      ユーザ) になるか, root になります.

\item \program{bin/check_perms -f} を実行します.

\item エラーの報告がなくなるまで, 上の手順を繰り返す!
\end{itemize}

\section{ウェブサーバの設定}

おめでとう！Mailman ソフトウェアのインストールが完了しました． 
しかし，実際に全てをうまく動かすには，Mailman を ウェブサーバと
メールシステムの 両方に接続しないといけません．

もし，メールとウェブサーバを別のマシンで動かして，Mailman を NFS 
経由で 共有したいと考えていたら，その２つのマシンの時計が同期
していることを 確かめてください．この手の環境では，
\file{Mailman/LockFile.py} に定義された \var{CLOCK_SLOP} という定数を使って，
時計のずれを補償したファイルロック機構 にすることができます．

この節では Mailman のウェブインタフェースをウェブサーバに接続するために
必要な事柄を説明します. ここでの手順は Apache ウェブサーバに若干偏って
いますので, 詳細についてはご利用のウェブサーバの説明書を参照してください.

ウェブサーバの設定で \file{\var{\$prefix}/cgi-bin} に CGI スクリプトの
実行許可を与えてください. 書き加える行は以下のようなものになる
はずです. (もちろん, \var{\$prefix} のところは実際の絶対パスに
してください.)

\begin{verbatim}
    Exec        /mailman/*      $prefix/cgi-bin/*
\end{verbatim}
% $ - emacs turd

  又は:

\begin{verbatim}
    ScriptAlias /mailman/       $prefix/cgi-bin/
\end{verbatim}
% $ - emacs turd

\begin{notice}[警告]
CGIスクリプトを実行する ユーザIDが \code{mailman} グループに入って
\strong{いない}ことをよく確認してください．でないと，非公開の保存書庫
が誰にでも見られてしまいます.
\end{notice}

Mailman, Python, GNU のロゴをWebサーバのアクセス可能なところに
コピーしてください．例えば Apacheの場合，画像ファイルを入れて
おくのに \file{icons} ディレクトリが用意されているはずです．例:

\begin{verbatim}
    % cp $prefix/icons/*.{jpg,png} /path/to/apache/icons
\end{verbatim}

\file{\var{\$prefix}/Mailman/mm_cfg.py} にロゴのベースディレクトリを書いた
行を追加してください．例えば:

\begin{verbatim}
  IMAGE_LOGOS = '/images/'
\end{verbatim}

\var{IMAGE_LOGOS} のデフォルト値は \file{/icons/} です. 
\file{Defaults.py.in} に書かれたコメントを読んでください.

Pipermail の公開メーリングリスト保存書庫を参照できるように 
Web サーバを 設定してください. 例えば Apache の場合:

\begin{verbatim}
    Alias   /pipermail/     $varprefix/archives/public/
\end{verbatim}
% $ - emacs turd

ここで, \var{\$varprefix} は通常は \var{\$prefix} と同じで,
\longprogramopt{with-var-prefix} オプションを付けて \program{configure}
した場合にはその値となります. また,
このディレクトリでシンボリックリンクをたどることができるように 
ウェブサーバを設定してください．でないと，Pipermail の書庫にアク
セスできません. Apache のユーザは \var{FollowSymLinks} オプションを 
調べてください.

また, もし公開保存書庫を国際化したいのであれば, Pipermail
ディレクトリのデフォルト文字集合の指示をオフにした方がよいかも
しれません. でないと, 多言語の保存書庫は正しく見ることができな
いでしょう. Apache の標準のインストールについての設定例は:

\begin{verbatim}
    <Directory "/usr/local/mailman/archives/public/">
        AddDefaultCharset Off
    </Directory>
\end{verbatim}

ここで, ウェブサーバを再起動してください.

\section{メールサーバの設定\label{mail-server}}

この節では Mailman のメールインタフェースをメールサーバに
接続するのに必要な事柄を説明します. ここでの手順はメールサーバによって
異なりますが; もしあなたのメールサーバが次の小節に見当たらない
場合は, ここにある文書から一般化することを試してください. そして, 文書の更新を
Mailman 開発者にプレゼントすることも考えてください.

\subsection{Postfix メールサーバを使う場合}

Mailman は標準の Postfix インストールとうまく合うようになっています.
Postfix 2.1.5 (を含む) までの各種バージョンで試験済みです.

デフォルトでは, Postfix は \code{-owner} と \code{-request} のアドレスを
特殊扱いします. このようなメールも Mailman に届けてもらうために, 
次のように \file{main.cf} に追加してこのオプションをオフにします:

\begin{verbatim}
    owner_request_special = no
\end{verbatim}

Mailman のオプションである VERP 配送をサポートするためには, 
\code{luser_relay} を無効(これが既定値)にしたままで, 
\code{recipient_delimiter} を
設定して 拡張アドレス\footnote{訳注：原文は extended address 
semantics なので, `拡張されたアドレスの意味論'. 実際には,
extended address とだけ書いてある文献が多いようなので, `意味論'
を省略した.}
を有効にします.
\file{main.cf} の \code{luser_relay} の値をどれもコメントアウトし,
デフォルトのままにします. また, 次のように \file{main.cf} ファイルに
追加します.

\begin{verbatim}
    recipient_delimiter = +
\end{verbatim}

区切り記号として \samp{+} を使うと \file{Defaults.py} にある
\var{VERP_FORMAT} と \var{VERP_REGEXP} のデフォルト値とうまく合います.

存在しないローカルアドレスにメールを送信しようとすると, Postfix は
450 のエラーコードを返すかもしれません. これは一時的なエラーを表す
コードなので, Mailman はデフォルトで \var{DELIVERY_RETRY_PERIOD} -- 5
日間メールを送信しようとし続けます. 次のように \file{main.cf} に
設定することで, 存在しないローカルユーザについて恒久的なエラーコード
を返させることができます.

\begin{verbatim}
    unknown_local_recipient_reject_code = 550
\end{verbatim}

最後に, もし Postfix スタイルの仮想ドメインを使っているなら,
下の仮想ドメインサポートの節を読んでください.

\subsubsection{Postfix と Mailman の統合}

Postfix と Mailman を統合すると, 新しいリストを作成したり,
リストを削除したときに, Postfix のエイリアスデータベースが自動的に
更新されるようになります. これを実現するための手順は以下のとおりです.

以下の説明では, Mailman がデフォルトの位置, つまり \file{/usr/local/mailman}
にインストールされているものと仮定します. もし, そうでなければ,
\program{configure} で用いた \longprogramopt{prefix} と
\longprogramopt{with-var-prefix} のオプションに従って読み替えてください.

\begin{notice}[注意]
もし, 仮想ドメインを使っていて, 仮想ドメインの設定を優先させたいと
いう場合には, \ref{postfix-virtual} 節を先に読んでください!
\end{notice}

\begin{itemize}
\item \file{\var{\$prefix}/Mailman/mm_cfg.py} ファイルの最後に次のように
      追加してください:

      \begin{verbatim}
        MTA = 'Postfix'
      \end{verbatim}

      変数 MTA は \file{Mailman/MTA} ディレクトリにあるモジュールの
      名前を指定します. ここには, リストが作成／削除されるときに
      実行される, メールサーバ固有の関数が入っています.

\item \file{Defaults.py} ファイルを見て, \var{POSTFIX_ALIAS_CMD} と
      \var{POSTFIX_MAP_CMD} コマンド変数の値を確認してください.
      これらは, それぞれ \program{postalias} と \program{postmap} プログラム
      を指していなければなりません. もし変更が必要の場合は \file{mm_cfg.py}
      の中で行うようにしてください.

\item \program{bin/genaliases} スクリプトを実行して \file{aliases} 
      ファイルを初期化してください.

      \begin{verbatim}
        % cd /usr/local/mailman
        % bin/genaliases
      \end{verbatim}

      \file{data/aliases} と \file{data/aliases.db} の所有者が
      \code{mailman} で, グループ所有者が \code{mailman} であることを
      確認してください. これらは configure コマンドで設定したユーザ
      グループです:

      \begin{verbatim}
        % su
        % chown mailman:mailman data/aliases*
      \end{verbatim}

\item Postfix の \file{main.cf} ファイルの \var{alias_maps} 変数が
      次のパスを含むように書き換えてください:

      \begin{verbatim}
          /usr/local/mailman/data/aliases
      \end{verbatim}

      最後の \code{.db} が付いていないことにも注意してください. 
      \var{alias_database} にこれを入れてはいけません. なぜなら, Postfix
      の \program{newaliases} コマンドが Mailman の \file{aliases.db} 
      ファイルを書き換えてしまうからです. しかし, ローカルアドレスを探索する
      ときには \file{aliases.db} を見てもらいます.

      このエントリについて \code{hash:} スタイルのデータベースを作りたい
      と思うでしょう. これが記入例です:

      \begin{verbatim}
        alias_maps = hash:/etc/postfix/aliases,
            hash:/usr/local/mailman/data/aliases
      \end{verbatim}

\item Mailman を configure するときに, \longprogramopt{with-mail-gid=mailman}
      スイッチを使用してください; これは \code{mailman} ユーザを追加した
      後で Mailman を configure していればデフォルトになります.
      \file{aliases.db} ファイルの所有者が \code{mailman} なので,
      Postfix は Mailman の ラッププログラムを \code{mailman} の uid と gid で
      実行します.

\end{itemize}

これで完了! 問題がひとつ: リストを作成したり削除すると, \file{aliases.db}
は更新されますが, \program{postfix reload} を自動的に実行するわけでは
ありません. これを実行するには root にならなければなりませんが, root に
suid したスクリプトは安全でないからです. Postfix が \file{aliases.db}
ファイルの変更とテーブルの更新に気が付くのに 1分ほどかかるだけです.

\subsubsection{仮想ドメイン\label{postfix-virtual}}

Postfix 2.0 は ``仮想エイリアス ドメイン\footnote{訳注：virtual alias domains. }'' をサポートします. 
これは, 以前のバージョンの Postfix では ``Postfix スタイルの仮想ドメイン''
と呼ばれていたものです. 
Mailman で動作する仮想エイリアスドメインを作るには, 
Postfix と Mailman の両方で設定をする必要があります. 
Mailman は, (既定では) \file{/usr/local/mailman/data/virtual-mailman}
という名前のファイルにすべての仮想エイリアスのマップを書き込みます. 
また, Postfix が実際に使う \program{virtual-mailman.db}
ファイルを作成するために \program{postmap} を使います. 

まず, Postfix の仮想エイリアス ドメインを Postfix の文書の説明どおりに作ります
(Postfix の \code{virtual(5)} マニュアルページを参照してください). 
マニュアルページの説明にある
\code{virtual-alias.domain anything}
の行は, 自分で入れなければいけないことに注意してください. 
Mailman は \file{virtual-mailman} にこの行を入れてくれません. 
Mailman と統合する前に, 
この仮想エイリアス ドメインが正しく動作するようにしておくことが, 
とても大事です. 

次に, Postfix と \var{virtual_alias_maps} 変数に, virtual-mailman
ファイルの位置のパス名を追加します. 例:

\begin{verbatim}
    virtual_alias_maps = <通常の仮想エイリアスのファイル>,
        hash:/usr/local/mailman/data/virtual-mailman
\end{verbatim}

ここでは, Mailman は既定の場所にインストールしてあると仮定しています. 
\var{virtual_alias_maps}
変数のない古いバージョンの Postfix を使っているのなら, 
かわりに \var{virtual_maps} 変数を使います. 

次に, \file{mm_cfg.py} ファイルで, 
\var{POSTFIX_STYLE_VIRTUAL_DOMAINS} に, 
Mailman が更新する仮想ドメインのリストを設定するとよいでしょう. 
これは, Postfix のほうでサポートする仮想ドメインすべてとは限りません!
このリストの要素は, メーリングリスト オブジェクトの \var{host_name}
属性と照合されます. 完全一致でなければいけません. 

例を挙げます. 
Postfix は仮想ドメイン \code{dom1.ain}, \code{dom2.ain}, \code{dom3.ain}, 
を扱うよう設定してあるものとし, さらに, 
\file{main.cf} ファイルに次の設定がしてあるものとします:

\begin{verbatim}
    myhostname = mail.dom1.ain
    mydomain = dom1.ain
    mydestination = $myhostname, localhost.$mydomain
    virtual_alias_maps =
        hash:/some/path/to/virtual-dom1,
        hash:/some/path/to/virtual-dom2,
        hash:/some/path/to/virtual-dom2
\end{verbatim}

たとえば \file{virtual-dom1} ファイルに, つぎの行があるとします:

\begin{verbatim}
    dom1.ain  IGNORE
    @dom1.ain @mail.dom1.ain
\end{verbatim}

これは Postfix に, \code{dom1.ain} 宛てのものはなんでも, 
\code{mail.dom1.com} の同名のメールボックス (既定の配送先) に配送するよう
指示していることになります. 

この場合, \var{POSTFIX_STYLE_VIRTUAL_DOMAINS} には \code{dom1.ain}
を含めません. なぜなら
そうしなければ, Mailman は dom1.ain ドメインのメーリングリストの項目を

\begin{verbatim}
    mylist@dom1.ain         mylist
    mylist-request@dom1.ain mylist-request
    # 等々...
\end{verbatim}

のように書き込むからです. 

より特定した項目が, より一般的な項目を上書きするので, 
\code{dom1.ain} メーリングリストへの配送は止められてしまいます. 

いっぽう, \code{dom2.ain} は \code{dom3.ain} \file{mm_cfg.py} に含めます:

\begin{verbatim}
    POSTFIX_STYLE_VIRTUAL_DOMAINS = ['dom2.ain', 'dom3.ain']
\end{verbatim}

こうして, この二つのドメインのいずれかに属するメーリングリストを
Mailman が作ったら, \file{/usr/local/mailman/data/virtual-mailman}
には正しい項目が入ります. 

上の \file{data/aliases*} ファイルと同じく, 
\file{data/virtual-mailman} と \file{data/virtual-mailman.db}
の両方とも, \code{mailman} のユーザ, グループに
所有されているようにしたほうがいいでしょう. 

\subsubsection{他の方法}

Fil \email{fil@rezo.net} は, 
virtual マップと正規表現を使った他の方法を紹介しています. 
以下に説明があります:

\begin{itemize}
\item (フランス語)  \url{http://listes.rezo.net/comment.php}
\item (英語) \url{http://listes.rezo.net/how.php}
\end{itemize}

リストにアクセスするときのアドレスのドメインに
余分なホスト部がつくのが気にならなければ, これは良い (そしてよりシンプルな)
代替案です. 
つまり, \code{mylist@dom.ain} のかわりに \code{mylist@lists.dom.ain}
を使わないといけないのでもよければ, ということです. 

\subsection{Using the Exim mail server}

\begin{notice}[note]
This section is derived from Nigel Metheringham's ``HOWTO - Using Exim and
Mailman together'', which covers Mailman 2.0.x and Exim 3.  It has been
updated to cover Mailman 2.1 and Exim 4.  The original document is here:
\url{http://www.exim.org/howto/mailman.html}.
\end{notice}

There is no Mailman configuration needed other than the standard options
detailed in the Mailman install documentation.  The Exim configuration is
transparent to Mailman.  The user and group settings for Mailman must match
those in the config fragments given below.

\subsubsection{Exim configuration}

The Exim configuration is built so that a list created within Mailman
automatically appears to Exim without the need for defining any additional
aliases.

The drawback of this configuration is that it will work poorly on systems
supporting lists in several different mail domains.  While Mailman handles
virtual domains, it does not yet support having two distinct lists with the
same name in different virtual domains, using the same Mailman installation.
This will eventually change.  (But see below for a variation on this scheme
that should accommodate virtual domains better.)

The configuration file excerpts below are for use in an already functional
Exim configuration, which accepts mail for the domain in which the list
resides.  If this domain is separate from the others handled by your Exim
configuration, then you'll need to:

\begin{itemize}
\item add the list domain, ``my.list.domain'' to \var{local_domains}

\item add a ``domains=my.list.domain'' option to the director (router) for the
      list

\item (optional) exclude that domain from your other directors (routers)
\end{itemize}

\begin{notice}[note]
The instructions in this document should work with either Exim 3 or Exim 4.
In Exim 3, you must have a \var{local_domains} configuration setting; in Exim
4, you most likely have a \var{local_domains} domainlist.  If you don't, you
probably know what you're doing and can adjust accordingly.  Similarly, in
Exim 4 the concept of ``directors'' has disappeared -- there are only routers
now.  So if you're using Exim 4, whenever this document says ``director'',
read ``router''.
\end{notice}

Whether you are using Exim 3 or Exim 4, you will need to add some macros to
the main section of your Exim config file.  You will also need to define one
new transport.  With Exim 3, you'll need to add a new director; with Exim 4, a
new router plays the same role.

Finally, the configuration supplied here should allow co-habiting Mailman 2.0
and 2.1 installations, with the proviso that you'll probably want to use
\code{mm21} in place of \code{mailman} -- e.g., \var{MM21_HOME},
\var{mm21_transport}, etc.

\subsubsection{Main configuration settings}

First, you need to add some macros to the top of your Exim config file.  These
just make the director (router) and transport below a bit cleaner.  Obviously,
you'll need to edit these based on how you configured and installed Mailman.

\begin{verbatim}
    # Home dir for your Mailman installation -- aka Mailman's prefix
    # directory.
    MAILMAN_HOME=/usr/local/mailman
    MAILMAN_WRAP=MAILMAN_HOME/mail/mailman

    # User and group for Mailman, should match your --with-mail-gid
    # switch to Mailman's configure script.
    MAILMAN_USER=mailman
    MAILMAN_GROUP=mailman
\end{verbatim}

\subsubsection{Transport for Exim 3\label{exim3-transport}}

Add this to the transports section of your Exim config file,
i.e. somewhere between the first and second ``end'' line:

\begin{verbatim}
  mailman_transport:
    driver = pipe
    command = MAILMAN_WRAP \
              '${if def:local_part_suffix \
                    {${sg{$local_part_suffix}{-(\\w+)(\\+.*)?}{\$1}}} \
                    {post}}' \
              $local_part
    current_directory = MAILMAN_HOME
    home_directory = MAILMAN_HOME
    user = MAILMAN_USER
    group = MAILMAN_GROUP
\end{verbatim}

\subsubsection{Director for Exim 3}

If you're using Exim 3, you'll need to add the following director to your
config file (directors go between the second and third ``end'' lines).  Also,
don't forget that order matters -- e.g. you can make Mailman lists take
precedence over system aliases by putting this director in front of your
aliasfile director, or vice-versa.

\begin{verbatim}
  # Handle all addresses related to a list 'foo': the posting address.
  # Automatically detects list existence by looking
  # for lists/$local_part/config.pck under MAILMAN_HOME.
  mailman_director:
    driver = smartuser
    require_files = MAILMAN_HOME/lists/$local_part/config.pck
    suffix_optional
    suffix = -bounces : -bounces+* : \
             -confirm+* : -join : -leave : \
             -owner : -request : -admin
    transport = mailman_transport
\end{verbatim}

\subsubsection{Router for Exim 4}

In Exim 4, there's no such thing as directors -- you need to add a new router
instead.  Also, the canonical order of the configuration file was changed so
routers come before transports, so the router for Exim 4 comes first here.
Put this router somewhere after the ``begin routers'' line of your config
file, and remember that order matters.

\begin{verbatim}
  mailman_router:
    driver = accept
    require_files = MAILMAN_HOME/lists/$local_part/config.pck
    local_part_suffix_optional
    local_part_suffix = -bounces : -bounces+* : \
                        -confirm+* : -join : -leave : \
                        -owner : -request : -admin
    transport = mailman_transport
\end{verbatim}
% $ - emacs turds

\subsubsection{Transports for Exim 4}

The transport for Exim 4 is the same as for Exim 3 (see \ref{exim3-transport};
just copy the transport given above to somewhere under the ``begin
transports'' line of your Exim config file.

\subsubsection{Additional notes}

Exim should be configured to allow reasonable volume -- e.g. don't set
\var{max_recipients} down to a silly value -- and with normal degrees of
security -- specifically, be sure to allow relaying from 127.0.0.1, but pretty
much nothing else.  Parallel deliveries and other tweaks can also be used if
you like; experiment with your setup to see what works.  Delay warning
messages should be switched off or configured to only happen for non-list
mail, unless you like receiving tons of mail when some random host is down.

\subsubsection{Problems}

\begin{itemize}

\item Mailman will send as many \code{MAIL FROM}/\code{RCPT TO} as it needs.
      It may result in more than 10 or 100 messages sent in one connection,
      which will exceed the default value of Exim's
      \var{smtp_accept_queue_per_connection} value.  This is bad because it
      will cause Exim to switch into queue mode and severely delay delivery of
      your list messages.  The way to fix this is to set Mailman's
      \var{SMTP_MAX_SESSIONS_PER_CONNECTION} (in
      \file{\var{\$prefix}/Mailman/mm_cfg.py}) to a smaller value than Exim's
      \var{smtp_accept_queue_per_connection}.

\item Mailman should ignore Exim delay warning messages, even though Exim
      should never send this to list messages.  Mailman 2.1's general bounce
      detection and VERP support should greatly improve the bounce detector's
      hit rates.

\item List existence is determined by the existence of a \file{config.pck}
      file for a list.  If you delete lists by foul means, be aware of this.

\item If you are getting Exim or Mailman complaining about user ids when you
      send mail to a list, check that the \var{MAILMAN_USER} and
      \var{MAILMAN_GROUP} match those of Mailman itself (i.e. what were used
      in the \program{configure} script).  Also make sure you do not have
      aliases in the main alias file for the list.
\end{itemize}

\subsubsection{Receiver Verification}

Exim's receiver verification feature is very useful -- it lets Exim reject
unrouteable addresses at SMTP time.  However, this is most useful for
externally-originating mail that is addressed to mail in one of your local
domains.  For Mailman list traffic, mail originates on your server, and is
addressed to random external domains that are not under your control.
Furthermore, each message is addressed to many recipients
-- up to 500 if you use Mailman's default configuration and don't tweak
\var{SMTP_MAX_RCPTS}.

Doing receiver verification on Mailman list traffic is a recipe for trouble.
In particular, Exim will attempt to route every recipient addresses in
outgoing Mailman list posts.  Even though this requires nothing more than a
few DNS lookups for each address, it can still introduce significant delays.
Therefore, you should disable recipient verification for Mailman traffic.

Under Exim 3, put this in your main configuration section:

\begin{verbatim}
    receiver_verify_hosts = !127.0.0.1
\end{verbatim}

Under Exim 4, this is probably already taken care of for you by the default
recipient verification ACL statement (in the \code{RCPT TO} ACL):

\begin{verbatim}
  accept  domains       = +local_domains
          endpass
          message       = unknown user
          verify        = recipient
\end{verbatim}

which only does recipient verification on addresses in your domain.  (That's
not exactly the same as doing recipient verification only on messages coming
from non-127.0.0.1 hosts, but it should do the trick for Mailman.)

\subsubsection{SMTP Callback}

Exim's SMTP callback feature is an even more powerful way to detect bogus
sender addresses than normal sender verification.  Unfortunately, lots of
servers send bounce messages with a bogus address in the header, and there are
plenty that send bounces with bogus envelope senders (even though they're
supposed to just use an empty envelope sender for bounces).

In order to ensure that Mailman can disable/remove bouncing addresses, you
generally want to receive bounces for Mailman lists, even if those bounces are
themselves not bounceable.  Thus, you might want to disable SMTP callback on
bounce messages.

With Exim 4, you can accomplish this using something like the following in
your \code{RCPT TO} ACL:

\begin{verbatim}
  # Accept bounces to lists even if callbacks or other checks would fail
  warn     message      = X-WhitelistedRCPT-nohdrfromcallback: Yes
           condition    = \
           ${if and {{match{$local_part}{(.*)-bounces\+.*}} \
                     {exists {MAILMAN_HOME/lists/$1/config.pck}}} \
                {yes}{no}}
                {yes}{no}}

  accept   condition    = \
           ${if and {{match{$local_part}{(.*)-bounces\+.*}} \
                     {exists {MAILMAN_HOME/lists/$1/config.pck}}} \
                {yes}{no}}
                {yes}{no}}

  # Now, check sender address with SMTP callback.
  deny   !verify = sender/callout=90s
\end{verbatim}

If you also do SMTP callbacks on header addresses, you'll want something like
this in your \code{DATA} ACL:

\begin{verbatim}
  deny   !condition = $header_X-WhitelistedRCPT-nohdrfromcallback:
         !verify = header_sender/callout=90s
\end{verbatim}
% $ - emacs turd

\subsubsection{Doing VERP with Exim and Mailman}

VERP will send one email, with a separate envelope sender (return path), for
each of your subscribers -- read the information in
\file{\var{\$prefix}/Mailman/Default.py} for the options that start with VERP.
In a nutshell, all you need to do to enable VERP with Exim is to add these lines to \file{\var{\$prefix}/Mailman/mm_cfg.py}:

\begin{verbatim}
    VERP_PASSWORD_REMINDERS = Yes
    VERP_PERSONALIZED_DELIVERIES = Yes
    VERP_DELIVERY_INTERVAL = Yes
    VERP_CONFIRMATIONS = Yes
\end{verbatim}

(The director (router) above is smart enough to deal with VERP bounces.)

\subsubsection{Virtual Domains}

One approach to handling virtual domains is to use a separate Mailman
installation for each virtual domain.  Currently, this is the only way to have
lists with the same name in different virtual domains handled by the same
machine.

In this case, the \var{MAILMAN_HOME} and \var{MAILMAN_WRAP} macros are useless
-- you can remove them.  Change your director (router) to something like this:

\begin{verbatim}
  require_files = /virtual/${domain}/mailman/lists/${lc:$local_part}/config.pck
\end{verbatim}
% $ - emacs turd

and change your transport like this:

\begin{verbatim}
  command = /virtual/${domain}/mailman/mail/mailman \
            ${if def:local_part_suffix \
                 {${sg{$local_part_suffix}{-(\\w+)(\\+.*)?}{\$1}}}
                 {post}} \
              $local_part
  current_directory = /virtual/${domain}/mailman
  home_directory = /virtual/${domain}/mailman
\end{verbatim}
% $ - emacs turd

\subsubsection{List Verification}

This is how a set of address tests for the Exim lists look on a working
system.  The list in question is \email{quixote-users@mems-exchange.org}, and
these commands were run on the \code{mems-exchange.org} mail server ("% "
indicates the Unix shell prompt):

\begin{verbatim}
  % exim -bt quixote-users
  quixote-users@mems-exchange.org
    router = mailman_main_router, transport = mailman_transport

  % exim -bt quixote-users-request
  quixote-users-request@mems-exchange.org
    router = mailman_router, transport = mailman_transport

  % exim -bt quixote-users-bounces
  quixote-users-bounces@mems-exchange.org
    router = mailman_router, transport = mailman_transport

  % exim -bt quixote-users-bounces+luser=example.com
  quixote-users-bounces+luser=example.com@mems-exchange.org
    router = mailman_router, transport = mailman_transport
\end{verbatim}

If your \program{exim -bt} output looks something like this, that's a start:
at least it means Exim will pass the right messages to the right Mailman
commands.  It by no means guarantees that your Exim/Mailman installation is
functioning perfectly, though!

\subsubsection{Document History}

Originally written by Nigel Metheringham \email{postmaster@exim.org}.  Updated
by Marc Merlin \email{marc_soft@merlins.org} for Mailman 2.1, Exim 4.
Overhauled/reformatted/clarified/simplified by Greg Ward
\email{gward@python.net}.

\subsection{Sendmail メールサーバを使う場合}

\begin{notice}[警告]
Sendmail メールサーバを使うとき, 
\file{mm_cfg.py} の中に \var{DELIVERY_MODULE} 設定変数として \code{'Sendmail'}
を入れたいと思うかもしれませんが, そうしては\strong{いけません}.
\file{Sendmail.py} のモジュール名は
間違って付けられています.
デフォルトの \file{SMTPDirect.py} で使う SMTP 方式に対して, コマンドラインで
メッセージを渡す方式を表しています.
\file{Sendmail.py} ファイルには既知のセキュリティホールがあり
概念的可能性を証明するために提供されています\footnote{実際, Mailman の
最近のバージョンでは, このモジュールをわざと動かなくしてあります.
もしこれを有効にしたいのであれば, なにが起こるかよく理解していなければ
いけません.}.
もし \file{SMTPDirect.py} の利用で問題があるなら \file{Sendmail.py} を
使うのでなく, 問題を直すことです. でないとセキュリティ悪用にさらす
ことになりかねません.
\end{notice}

\subsubsection{Sendmail の ``smrsh'' との適合}

新しいバージョンの Sendmail は Sendmail がメールプログラムとして
使うことを制限するために ``smrsh'' という制限実行ユーティリティが
付いてきます. 明示的に Mailman のラッププログラムが smrsh で使える
ようにしてあげないと Mailman は動作しません. もしメールが Mailman の
ラッププログラムに届かず, ``operating system error'' がメールの
ログに記録されていれば, この問題に突き当たっていることになります.

これを解決するのによい方法は:

\begin{itemize}
    \item Sendmail が smrsh ラッププログラムをどこで実行しているかを探す:

          \begin{verbatim}
            % grep smrsh /etc/mail/sendmail.cf
          \end{verbatim}

    \item 実行許可するメールプログラムを smrsh がどこにシンボリック
          リンクしているかを探す. 次のコマンドの最初のほうでどこかの
          ディレクトリ(例えば \file{/var/adm/sm.bin} みたいな)のパス
          が出てくるでしょう:

          \begin{verbatim}
            % strings $path_to_smrsh | less
          \end{verbatim}

    \item \file{/var/adm/sm.bin} あるいは自分のシステムで見つけた
          ディレクトリ (\file{/etc/smrsh} とか \file{/var/smrsh} とか
          \file{/usr/local/smrsh} とか...) へ移って:

          \begin{verbatim}
            % cd /var/adm/sm.bin
          \end{verbatim}

    \item Mailman のラッププログラムへのシンボリックリンクを作成します:

          \begin{verbatim}
            % ln -s /usr/local/mailman/mail/mailman mailman
          \end{verbatim}
\end{itemize}

\subsubsection{Sendmail と Mailman の統合}

David Champion は Sendmail と Mailman をより密接に統合する, つまり
リストが作成されたときにエイリアステーブルを手で編集しなくても, 
Sendmail が自動的に認識し新しいリストに配送するようにするための
レシピを寄贈してくれました.

Mailman のソース配布物 \file{contrib} ディレクトリに次の4つの
ファイルがあります:

\begin{itemize}
\item \file{mm-handler.readme} - セットアップする方法の説明
\item \file{mm-handler}        - メール配送エージェント (MDA)
\item \file{mailman.mc}        - 設定ファイルの例
\item \file{virtusertable}     - RFC 2142 アドレスを例外にする例
\end{itemize}

\subsubsection{性能について}

Sendmail で性能を落とす要因として確実なのは, 受信者のホストを DNS 
で同時に検証するように設定されている場合です. Mailman からサーバに
メールが送信されるときにこれをやると非常に性能が落ちます.
Mailman は \code{localhost} (つまり, 127.0.0.1) から Sendmail の
SMTP ポートに接続しますので, ローカルホストからの接続については
DNS での同時検証を\strong{しない}ように Sendmail を設定してください.

\subsection{Using the Qmail mail server\label{qmail-issues}}

There are some issues that users of the qmail mail transport agent have
encountered.  None of the core maintainers use qmail, so all of this
information has been contributed by the Mailman user community, especially
Martin Preishuber and Christian Tismer, with notes by Balazs Nagy (BN) and
Norbert Bollow (NB).

\begin{itemize}
\item You might need to set the mail-gid user to either \code{qmail},
      \code{mailman}, or \code{nofiles} by using the
      \longprogramopt{with-mail-gid} \program{configure} option.

      \emph{BN:} it highly depends on your mail storing policy.  For example
      if you use the simple \file{~alias/.qmail-*} files, you can use
      \program{`id -g alias`}.  But if you use \file{/var/qmail/users}, the
      specified mail gid can be used.

      If you are going to be directing virtual domains directly to the
      \code{mailman} user (using ``virtualdomains'' on a list-only domain, for
      example), you will have to use \longprogramopt{with-mail-gid}=\var{gid
      of mailman user's group}.  This is incompatible with having list aliases
      in \file{~alias}, unless that alias simply forwards to
      \code{mailman-listname*}.

\item If there is a user \code{mailman} on your system, the alias
      \code{mailman-owner} will work only in \file{~mailman}.  You have to do
      a \program{touch .qmail-owner} in \file{~mailman} directory to create
      this alias.

      \emph{NB:} An alternative, IMHO better solution is to \program{chown
      root ~mailman}, that will stop qmail from considering \code{mailman} to
      be a user to whom mail can be delivered.  (See ``man 8 qmail-getpw''.)

\item In a related issue, if you have any users with the same name as one of
      your mailing lists, you will have problems if list names contain
      \samp{-} in them.  Putting \file{.qmail} redirections into the user's
      home directory doesn't work because the Mailman wrappers will not get
      spawned with the proper GID.  The solution is to put the following lines
      in the \file{/var/qmail/users/assign} file:

\begin{verbatim}
  +zope-:alias:112:11:/var/qmail/alias:-:zope-:
  .
\end{verbatim}

      where in this case the listname is e.g. \code{zope-users}.

      \emph{NB:} Alternatively, you could host the lists on a virtual domain,
      and use the \file{/var/qmail/control/virtualdomains} file to put the
      \code{mailman} user in charge of this virtual domain.

\item \emph{BN:}If inbound messages are delivered by another user than
      \code{mailman}, it's necessary to allow it to access \file{~mailman}.
      Be sure that \file{~mailman} has group writing access and setgid bit is
      set.  Then put the delivering user to \code{mailman} group, and you can
      deny access to \file{~mailman} to others.  Be sure that you can do the
      same with the WWW service.

      By the way the best thing is to make a virtual mail server to handle all
      of the mail.  \emph{NB:} E.g. make an additional "A" DNS record for the
      virtual mailserver pointing to your IP address, add the line
      \code{lists.kva.hu:mailman} to \file{/var/qmail/control/virtualdomains}
      and a \code{lists.kva.hu} line to \file{/var/qmail/control/rcpthosts}
      file.  Don't forget to HUP the qmail-send after modifying
      ``virtualdomains''.  Then every mail to lists.kva.hu will arrive to
      mail.kva.hu's mailman user.

      Then make your aliases:

\begin{verbatim}
          .qmail              => mailman@...'s letters
          .qmail-owner        => mailman-owner's letters
\end{verbatim}

      For list aliases, you can either create them manually:

\begin{verbatim}
          .qmail-list         => posts to the 'list' list
          .qmail-list-admin   => posts to the 'list's owner
          .qmail-list-request => requests to 'list'
          etc
\end{verbatim}

      or for automatic list alias handling (when using the lists.kva.hu
      virtual as above), see \file{contrib/qmail-to-mailman.py} in the Mailman
      source distribution.  Modify the \file{~mailman/.qmail-default} to
      include:

\begin{verbatim}
          |/path/to/python /path/to/qmail-to-mailman.py
\end{verbatim}

      and new lists will automatically be picked up.

\item You have to make sure that the localhost can relay.  If you start qmail
      via inetd and tcpenv, you need some line the following in your
      \file{/etc/hosts.allow} file:

\begin{verbatim}
      tcp-env: 127. 10.205.200 : setenv RELAYCLIENT
\end{verbatim}

      where 10.205.200. is your IP address block.  If you use tcpserver, then
      you need something like the following in your \file{/etc/tcp.smtp} file:

\begin{verbatim}
      10.205.200.:allow,RELAYCLIENT=""
      127.:allow,RELAYCLIENT=""
\end{verbatim}

\item \emph{BN:} Bigger \file{/var/qmail/control/concurrencyremote} values
      work better sending outbound messages, within reason.  Unless you know
      your system can handle it (many if not most cannot) this should not be
      set to a value greater than 120.

\item More information about setting up qmail and relaying can be found in the
      qmail documentation.
\end{itemize}

\emph{BN:} Last but not least, here's a little script to generate aliases to
your lists (if for some reason you can/will not have them automatically picked
up using \file{contrib/qmail-to-mailman.py}):

This script is for the Mailman 2.0 series:

\begin{verbatim}
#!/bin/sh
if [ $# = 1 ]; then
    i=$1
    echo Making links to $i in the current directory...
    echo "|preline /home/mailman/mail/mailman post $i" > .qmail-$i
    echo "|preline /home/mailman/mail/mailman mailowner $i" > .qmail-$i-admin
    echo "|preline /home/mailman/mail/mailman mailowner $i" > .qmail-$i-owner
    echo "|preline /home/mailman/mail/mailman mailowner $i" > .qmail-owner-$i
    echo "|preline /home/mailman/mail/mailman mailcmd $i" > .qmail-$i-request
fi
\end{verbatim}
% $ - emacs turd

\begin{notice}[note]
This is for a new Mailman 2.1 installation.  Users upgrading from
Mailman 2.0 would most likely change \file{/usr/local/mailman} to
\file{/home/mailman}.  If in doubt, refer to the \longprogramopt{prefix}
option passed to \program{configure} during compile time.
\end{notice}

\begin{verbatim}
#!/bin/sh
if [ $# = 1 ]; then
    i=$1
    echo Making links to $i in the current directory...
    echo "|preline /usr/local/mailman/mail/mailman post $i" > .qmail-$i
    echo "|preline /usr/local/mailman/mail/mailman admin $i" > .qmail-$i-admin
    echo "|preline /usr/local/mailman/mail/mailman bounces $i" > .qmail-$i-bounces
    # The following line is for VERP
    # echo "|preline /usr/local/mailman/mail/mailman bounces $i" > .qmail-$i-bounces-default
    echo "|preline /usr/local/mailman/mail/mailman confirm $i" > .qmail-$i-confirm
    echo "|preline /usr/local/mailman/mail/mailman join $i" > .qmail-$i-join
    echo "|preline /usr/local/mailman/mail/mailman leave $i" > .qmail-$i-leave
    echo "|preline /usr/local/mailman/mail/mailman owner $i" > .qmail-$i-owner
    echo "|preline /usr/local/mailman/mail/mailman request $i" > .qmail-$i-request
    echo "|preline /usr/local/mailman/mail/mailman subscribe $i" > .qmail-$i-subscribe
    echo "|preline /usr/local/mailman/mail/mailman unsubscribe $i" > .qmail-$i-unsubscribe
fi
\end{verbatim}
% $ - emacs turd

\subsubsection{Information on VERP}

You will note in the alias generating script for 2.1 above, there is a line
for VERP that has been commented out.  If you are interested in VERP there are
two options.  The first option is to allow Mailman to do the VERP formatting.
To activate this, uncomment that line and add the following lines to your
\file{mm_cfg.py} file:

\begin{verbatim}
    VERP_FORMAT = '%(bounces)s-+%(mailbox)s=%(host)s'
    VERP_REGEXP = r'^(?P<bounces>.*?)-\+(?P<mailbox>[^=]+)=(?P<host>[^@]+)@.*$'
\end{verbatim}
% $ - emacs turd

The second option is a patch on SourceForge located at:

\url{http://sourceforge.net/tracker/?func=detail\&atid=300103\&aid=645513\&group_id=103}

This patch currently needs more testing and might best be suitable for
developers or people well familiar with qmail.  Having said that, this patch
is the more qmail-friendly approach resulting in large performance gains.

\subsubsection{Virtual mail server}

As mentioned in the \ref{qmail-issues} section for a virtual mail server, a
patch under testing is located at:

\url{http://sf.net/tracker/index.php?func=detail\&aid=621257\&group_id=103\&atid=300103}

Again, this patch is for people familiar with their qmail installation.

\subsubsection{More information}

You might be interested in some information on modifying footers that Norbert
Bollow has written about Mailman and qmail, available here:

    \url{http://mailman.cis.to/qmail-verh/}

\section{サイトのデフォルトを点検\label{customizing}}

Mailman には沢山のサイト全体の設定オプションがありますので, ここで点検し, 
必要に応じて変更してください.
オプションのいくつかは Mailman があなたの環境でどう動作するかを制御し,
あるいは新規に作成したリストのデフォルトを選びます\footnote{
一般的に, ここで変更したリストのデフォルトは既に作成済みのリストには
適用されません. リストが作成された後に変更を加えるには, ウェブインタフェース
を使うか \program{bin/withlist} や \program{bin/config_list} のような
コマンド行スクリプトを使います.}.
またシステムチューニングのパラメータや統合のオプションがあります.

\file{\var{\$prefix}/Mailman/Defaults.py} ファイルにサイト全体の
デフォルトの全部が入っています. しかし, \strong{絶対} このファイルを
変更してはいけません. その代わり, 同じディレクトリにある,
\file{mm_cfg.py} ファイルを変更してください. \file{Defaults.py} に
入っているのと違うものだけ \file{mm_cfg.py} に書き加えればよいだけです.
将来 Mailman をバージョンアップする時に, \file{mm_cfg.py} が書き換えられる
ことはありません.

\file{Defaults.py} ファイルにはコメントが沢山書いてあります. そこで
オプションをここで説明することはしません. \file{Defaults.py} と \file{mm_cfg.py}
はどちらも \ulink{Python}{http://www.python.org} ファイルなので
Python の文法を守るようにしないといけません. でないと Mailman は動きません.

\begin{notice}[注意]
\var{HOME_DIR} と \var{MAILMAN_DIR} 変数を変えては \strong{いけません}.
これらは \program{configure} スクリプトで自動的に設定されます.
もし変えると Mailman のインストールが壊れます.
\end{notice}

\file{mm_cfg.py} の変更は \ref{building} 節で Mailman を
インストールしたときのユーザでおこなう必要があります.

\section{サイト全体のメーリングリストを作る}

Mailman とメールサーバの統合を完成させたら, 次に ``サイト全体'' の
メーリングリストを作る必要があります. これはパスワード備忘通知の発信者
として現れるものであり, Mailman を正しく運用するのに必要なものです.
通常, これは \code{mailman} という名前のリストですが, 変更する必要が
ある場合は, \file{mm_cfg.py} の中で \var{MAILMAN_SITE_LIST} 変数を
変更してください. 次のプロンプトに続くコマンドでこのサイトリストを
作成することができます.

\begin{verbatim}
    % bin/newlist mailman
\end{verbatim}

ここで, サイトリストの設定をします. これの助けになるように,
サイトリストの便利なひな形が \file{data/sitelist.cfg} に作って
あります. このひな形の設定オプションについて見ておいてください.
\file{sitelist.cfg} ファイルに名前が出ていないオプションについては
変更されないことも注意してください.

このひな形を適用するには次のようにします:

\begin{verbatim}
    % bin/config_list -i data/sitelist.cfg mailman
\end{verbatim}

\file{sitelist.cfg} のオプションを適用の後で, リストの管理ページで
設定を見ておくことを忘れないでください.
ください.

サイトリストには自分自身を登録しておいてください.

\section{Cron の設定}

多くの Mailman の仕事は定常的なスケジュールで発生します. そのため,
正しい時刻に正しいプログラムを実行するよう \program{cron} を設定しなければ
なりません\footnote{以前のバージョンから更新するときには, 新しい
crontab を入れないといけないかもしれません. しかし, 複数の Mailman を
インストールしている場合には注意が必要です. crontab を変更すると
他の平行した Mailman を壊すかもしれません.}.

もし, あなたの crontab が \programopt{-u} オプションをサポートして
いたら, root になって次のステップを実行してください. 
次のコマンドを実行して \file{\var{\$prefix}/cron/crontab.in} を
crontab のエントリに入れます.

\begin{verbatim}
    % cd $prefix/cron
    % crontab -u mailman crontab.in
\end{verbatim}

もし, \longprogramopt{with-username} オプションを使っていたら, \programopt{-u}
の引数には \code{mailman} の代わりにそのユーザ名を使います.
もし, crontab が \programopt{-u} オプションをサポートしていなければ,
次のようにしてください:

\begin{verbatim}
    % cd $prefix/cron
    % su - mailman
    % crontab crontab.in
\end{verbatim}

\section{Mailman の qrunner を起動する}

Mailman は全てのメール配送に ``qrunner'' と呼ばれるプロセスを使います.
\var{\$prefix} に移動して, 次のコマンドを実行することで qrunner を
起動する必要があります:

\begin{verbatim}
    % bin/mailmanctl start
\end{verbatim}

システムをリブートするたびに Mailman を起動したほうがよいでしょう.
実際にどうするかは使用するオペレーティングシステムに依存します.
OS が \program{chkconfig} コマンドをサポートしていれば (例えば Red Hat
や Mandrake の Linux) 次のようにしてください (Mailman の
インストールディレクトリから, root になって):

\begin{verbatim}
    % cp scripts/mailman /etc/init.d/mailman
    % chkconfig --add mailman
\end{verbatim}

\file{/etc/init.d} はシステムによっては \file{/etc/rc.d/init.d} かも
しれません.

Gentoo Linux では次のようにします:

\begin{verbatim}
    % cp scripts/mailman /etc/init.d/mailman
    % rc-update add mailman default
\end{verbatim}

Debian ではこうするとよいでしょう:

\begin{verbatim}
    % update-rc.d mailman defaults
\end{verbatim}

\program{chkconfig} をサポートしない \UNIX{} では次の一連のコマンド
を試してみるとよいかもしれません:

\begin{verbatim}
    % cp scripts/mailman /etc/init.d/mailman
    % cp misc/mailman /etc/init.d
    % cd /etc/rc.d/rc0.d
    % ln -s ../init.d/mailman K12mailman
    % cd ../rc1.d
    % ln -s ../init.d/mailman K12mailman
    % cd ../rc2.d
    % ln -s ../init.d/mailman S98mailman
    % cd ../rc3.d
    % ln -s ../init.d/mailman S98mailman
    % cd ../rc4.d
    % ln -s ../init.d/mailman S98mailman
    % cd ../rc5.d
    % ln -s ../init.d/mailman S98mailman
    % cd ../rc6.d
    % ln -s ../init.d/mailman K12mailman
\end{verbatim}

\section{ホスト名の設定をチェックする}

\file{Defaults.py} の中の \var{DEFAULT_EMAIL_HOST} と \var{DEFAULT_URL_HOST}
をチェックしてください. 変更が必要な場合は \file{Defaults.py} で \strong{なく}
\file{mm_cfg.py} に書きます. 
また, どちらかの値を変更したときには, \file{mm_cfg.py} の変更の後に,
次のように追加してください.

\begin{verbatim}
    add_virtualhost(DEFAULT_URL_HOST, DEFAULT_EMAIL_HOST)
\end{verbatim}

もし既に作成したリストがあったら, \program{bin/fix_url.py} を使って
ドメイン名を変更してください.

\section{サイトパスワードの作成}

\program{bin/mmsitepass} スクリプトを使用すると, コマンドラインから
２つのサイト全体のパスワードを作成できます.
一つ目は, ``サイトパスワード'' でシステム上でパスワードが必要の
場合はどこでも使うことができます. サイトパスワードはどのリストの
管理ページへも入ることができますし, どのユーザとしてもログインできます.
Unix システムでの \code{root} を考えてください. このパスワードは
賢く考えて選んでください.

２番目のパスワードはサイト全体の ``リスト作成'' パスワードです.
これを使うと, サイトパスワードの全ての特権を与えずに, 新しいリストを
作成するだけの権限を持たせることができます.
もちろん, サイトパスワードでも新しいメーリングリストを作成できますが,
リスト作成パスワードは特別の役割だけに限定するものです.

サイトパスワードの設定には次のコマンドを使います:

\begin{verbatim}
    % $prefix/bin/mmsitepass <あなたのサイトパスワード>
\end{verbatim}

リスト作成パスワードの設定は次のコマンドを使ってください:

\begin{verbatim}
    % $prefix/bin/mmsitepass -c <リスト作成パスワード>
\end{verbatim}

リスト作成パスワードを設定しなくても結構ですが, サイトパスワードは
必要になるはずです.

\section{初めてリストを作成する}

Mailman を使うに当たってリストを作成したり設定したりといった詳しい情報
については, Mailman リスト管理マニュアルを参照してください.
ここでは, ウェブインタフェースを使って最初のメーリングリストを作成
するための簡単なガイドを説明します:

\begin{itemize}
\item まず URL \code{http://my.dom.ain/mailman/create} を開いてください.

\item 画面に出ている指示に従ってフォームに記入して, ``リスト作成者の
      パスワード'' のところに \ref{customizing} 節で作成した
      パスワードを入れてください. 自分のメールアドレスを
      ``リスト管理者アドレスの初期設定'' のところに入れ, 
      ``「リスト作成完了」をメールで管理者に知らせますか'' で ``はい'' を
      選んでください.

\item ``リストを作成する'' ボタンをクリックしてください.

\item Mailman からあなた宛に新しいメーリングリストが作成されたことを
      メールで知らせますのでチェックしてください.

\item 確認のウェブページか Mailman が送信したメールに書かれたリンクを
      たどって, リストの管理ページへ行って下さい. たいがいは, URL は
      \code{http://my.dom.ain/mailman/admin/mylist} みたいになってる
      はずです.

\item リストのパスワードを入れて, ``ログイン...'' をクリックします.

\item ``会員管理'' をクリックし, 続いて ``まとめて入会登録'' へ行って
      ください.

\item 大きいテキスト入力エリアに自分のメールアドレスを入れ,
      ``変更を送信する'' をクリックしてください.

\item 自分のメールソフトで, \code{mylist@my.dom.ain} 宛てにメールを
      出してください. 1,2分のうちに, Mailman 経由で自分のメールが返って
      来るでしょう.
\end{itemize}

おめでとう! あなたの最初のメーリングリストの設定とテストが完了しました.
何か問題が起こったら, \ref{troubleshooting} 節を見てください.

\section{トラブルと対策\label{troubleshooting}}

もし, Mailman の実行で問題が発生したら, まず以下の「一般的な
問題」の節をチェックしましょう．もし，問題がそこに含
まれていなければ，\ulink{オンラインヘルプ}{http://www.list.org/help.html}
を見てください. そこから, \ulink{FAQ}{http://www.list.org/faq.html}
と \ulink{インタラクティブな FAQ ウィザード}{http://www.python.org/cgi-bin/faqw-mm.py}
へ行くことができます.

それから，システムの syslog と, Mailman の
\file{\var{\$prefix}/logs/error} ファイルにエラーが入っていないかもチェック
しましょう．
それでも問題があれば, \email{mailman-users@python.org} メーリングリスト
\footnote{メールを投稿するにはこメーリングリストに入らないといけませんが,
リストの保存書庫は一般公開されています.} に質問を書いてください.
\url{http://mail.python.org/mailman/listinfo/mailman-users} に詳しい
案内があります.

オペレーティングシステムや, 使用している Python のバージョン,
インストール中の Mailman のバージョンなどについての情報も
忘れずに入れてください.

以下は, 一般的な質問と回答のリストです:
Here is a list of some common questions and answers:

\begin{itemize}

\item \strong{問題:} Mailman の ウェブページが全て 404 File not found エラーに
      なります.

      \strong{解決法:} ウェブサーバの設定で Mailman の CGI コマンドを正しく
      扱えるように設定できていません. 以下を確認:

      \begin{enumerate}
      \item ウェブサーバで \file{\var{\$prefix}/cgi-bin} に正しく許可
            (パーミッション) を設定する.

      \item ウェブサーバを正しく再起動する.
      \end{enumerate}

      ウェブサーバの説明書をよく読んでどうしたらよいか調べてください.

\item \strong{問題:} Mailman のウェブページが全て "Internal Server
      Error" になります.

      \strong{解決法:} 間違ったユーザまたはグループを使って CGI を
      実行しようとしている可能性があります. ウェブサーバのログをチェックして
      ください. 例えば以下のような行があったら,

      \begin{verbatim}
            Attempt to exec script with invalid gid 51, expected 99
      \end{verbatim}

      Mailman を再インストールしなければなりません. \label{building} 
      節に書かれていたように, 正しい CGI グループ ID を指定して
      ください.

\item \strong{問題:} メールをリストに送ったら, リストが見つからないという
      メールを受け取りました.

      \strong{解決法:} 多分, システムのエイリアスデータベースに必要な
      エイリアスを登録していなかったのでしょう. あるいは, Mailman と
      メールサーバの組み合わせが正しく行われていないのかもしれません.
      エイリアスデータベースを更新していないか, あなたのシステムでは
      \program{newaliases} を明示的に実行する必要があるのかしれません.
      あなたがご利用のサーバについて\ref{mail-server}節で
      確認してください.

\item \strong{問題:} リストにメールを送ったら, ``unknown mailer error''
      が帰ってきました.

      \strong{解決法:} メールラップで間違ったユーザまたはグループID
      を使っている可能性があります. メールサーバのログをチェックして
      ください. 次のような行があったら,

      \begin{verbatim}
            Attempt to exec script with invalid gid 51, expected 99
      \end{verbatim}

      Mailman を再インストールしなければなりません. \label{building}
      節に書かれていたように, 正しいメールグループ ID を指定して
      ください.

\item \strong{問題:} 私は Postfix をメールサーバに使っています.
      そして, メールラッププログラムは GID が違っていると不平をログに残します.

      \strong{解決法:} \file{\var{\$prefix}/data/aliases.db} ファイルの
      所有者が \code{mailman} (又は \program{configure} コマンドで使った名前) 
      であることを確認してください. もし \code{mailman} 以外のユーザに
      所有されている場合は, Postfix は正しいユーザでメールプログラムを
      実行しません.

\item \strong{問題:} 私は Sendmail をメールサーバに使っています.
      そして, メールをリストに送ると 
      ``sh: mailman not available for
      sendmail programs'' というメールが返ってきます.

      \strong{解決法:} あなたのシステムでは Sendmail restricted shell
      (smrsh) が使われています. メールラッププログラム
      (\file{\var{\$prefix}/mail/mailman}) から smrsh で実行が許可されて
      いるディレクトリにシンボリックリンクを張る必要があります.

      一般的にこのディレクトリは \file{/var/admin/sm.bin},
      \file{/usr/admin/sm.bin}, \file{/etc/smrsh} などに設定されています.

      Debian Linux ではシステムは \file{/usr/lib/sm.bin} を作成します
      が，これは間違っています. \file{/usr/admin/sm.bin} を 作ってそ
      こへリンクを作成する必要があります. 
      注：\program{newaliases} が吐き出すどのエイリアスもラップへの
      安全なリンクを指す必要があります．

\item \strong{問題:}  \program{configure} を呼び出すときに散らかして
      しまいました. 掃除をして再インストールするにはどうしたらいいですか?

      \strong{解決法:}

      \begin{verbatim}
        % make clean
        % ./configure --with-the-right-options
        % make install
      \end{verbatim}

\end{itemize}

\section{プラットフォームやオペレーティング システムごとの注}

一般に, Mailman は POSIX 準拠のシステム (Solaris, 
BSD のさまざまな変種, Linux 系システム, MacOSX, 
その他の \UNIX{} システムなど) でなら動作します. 
Windows では動作しません. 
たいていの場合, 
Mailman がサポートされているプラットフォームで動作するようにするには, 
この文書で説明した一般的な手順だけで充分です. 
しかし, 一部のオペレーティング システムでは, 
このほかに, インストールや設定の際に推奨される手順があります. 

\subsection{GNU/Linux について}

Linux は, Mailman を実行するプラットフォームとしては, 
もっとも普及しているもののようです. 
Mailman を Linux で実行できるようにするためのヒントをいくつか挙げます:

\begin{itemize}
\item ハードリンクの作成でエラーが起こったり, 
      特別なセキュア カーネル (securelinux/openwall/grsecurity) を使っているときは, 
      Mailman のソース配布物のファイル
      \file{contrib/README.check_perms_grsecurity} を見てください. 

      Linux Mandrake をセキュア モードで使っているのなら, 
      これは役にたつでしょう. 

\item Mandrake は 9.0 あたりから gcc の実行権限を変更しています. 
      \code{mailman} ユーザになってビルドするのなら, 
      \code{mailman} が \code{cctools} グループにも所属しているようにします. 

\item Python を Linux ディストリビューションのパッケージ管理
      (例えば Redhat 系のシステムなら .rpm, Debian なら .deb)
      でインストールしたのなら, 
      Python ``開発用'' パッケージもインストールしなければいけません. 
      そうしないと期待したとおりの結果になりません. 

      例えば, Debian で Python 2.2 を使っているのなら, 
      \code{python2.2-dev} パッケージをインストールする必要があります. 
      Redhat では, たぶん \code{python2-devel} パッケージが必要でしょう. 

      Python をソースからインストールしたのなら, うまくいくはずです. 

      理屈はよくわかりませんが, インストールの最中につぎのようなエラーが起こるのなら, 
      この問題がおきていると判断してよいでしょう:

      \begin{verbatim}
          Traceback (most recent call last):
            File "bin/update", line 44, in ?
              import paths
          ImportError: No module named paths
          make: *** [update] Error 1
      \end{verbatim}

      これがおこるのなら, 
      Python の開発用パッケージをインストールしてから
      もう一度 \program{configure} と \program{make install} をやってみましょう. 
      あるいは, 最新バージョンの Python (\url{http://www.python.org}
      で入手できる) をソースからインストールします. 

      この問題は, 上記以外の Linux ディストリビューションでは
      違ったふうに表れるかもしれませんが, 
      普通は \code{ImportErrors} \code{ImportErrors} として表れます. 
\end{itemize}

\subsection{BSD について\label{bsd-issues}}

Vivek Khera によれば, 一部の BSD システムでは, 
夜間のセキュリティ スキャンで setuid ファイルの変更を調べます. 
setgid ディレクトリも, 変更されるとスキャン結果に現れます. 
また, BSD システムでは, ディレクトリの中にファイルを作ると, 
ディレクトリのグループ所有権を自動的に継承するので, 
setgid ビットはなくてもいいのです. 
他の \UNIX{} システムでは, ディレクトリの setgid ビットがオンになっていないと
こうはなりません. 

ディレクトリの setgid ビットをオンにせずにインストールするには, 
\program{configure} を実行したあとで, 
\program{make} に \var{DIRSETGID} 変数を渡せばいいです:

\begin{verbatim}
    % make DIRSETGID=: install
\end{verbatim}

これで, インストールされるディレクトリに対する
\program{chmod g+s} コマンドが無効になります. 

\subsection{MacOSX について}

Mailman を MacOSX で実行している人も大勢います. 
ここでは, Mailman を MacOSX で実行できるようにするために集めた
情報へのポインタを挙げておきます. 

\begin{itemize}
\item Jaguar (MacOSX 10.2) には Python 2.2 がついてきます. 
      が, これは Python のあまり最近の安定バージョンではなく, 
      Mailman 2.1 を実行するのには充分ではありません. 

\item David B. O'Donnell は, Web サイトで, 
      自分の MacOSX 上の Mailman 2.0.13 と Postfix の設定を説明しています. 

      \url{http://www.afp548.com/Articles/mail/python-mailman.html}

\item Kathleen Webb は, Jaguar で Sendmail を使って Mailman を実行できるように
      した経験を投稿してくれました. 

      \url{http://mail.python.org/pipermail/mailman-users/2002-October/022944.html}

\item Panther サーバ (MacOSX 10.3) には Mailman が入っています;
      Apple は, Mailman を MacOSX Server 10.3 で動作させる際にぶつかりそうな
      問題についての技術文書を出しています:

      \url{http://docs.info.apple.com/article.html?artnum=107889}
\end{itemize}

Terry Allen provides the following detailed instructions on running Mailman on
the 'client' version of OSX, or in earlier versions of OSX:

Mac OSX 10.3 and onwards has the basics for a successful Mailman installation.
Users of earlier versions of Mac OSX contains Sendmail and those users should
look at the Sendmail installation section for tips.  You should follow the
basic installation steps as described earlier in this manual, substituting as
appropriate, the steps outlined in this section.

By default, Mac OSX 10.3 'client' version does not have a fully functional
version of Postfix.  Setting up a working MTA such as Postfix is beyond the
scope of this guide and you should refer to \url{http://www.postfix.org} for
tips on getting Postfix running.  An easy way to set Postfix up is to install
and run Postfix Enabler, a stand-alone tool for configuring Postfix on Mac
OSX, available from
\url{http://www.roadstead.com/weblog/Tutorials/PostfixEnabler.html}.

Likewise, Mac OSX 'client' version from 10.1 onwards includes a working Apache
webserver.  This is switched on using the System Preferences control panel
under the 'Sharing tab'.  A useful tool for configuring the Apache on Mac OSX
is Webmin, which can be obtained from
\url{http://www.webmin.com}.

Webmin can also perform configuration for other system tasks, including
Postfix, adding jobs to your crontab, adding user and groups, plus adding
startup and shutdown jobs.

In a stock installation of OSX, the requirement for Mailman is to have Python
installed.  Python is not installed by default, so it is advised that you
install the developer's tools package, which may have been provided with your
system.  It can also be downloaded from the Apple developer site at
\url{http://connect.apple.com}.  Not only is the developer tools package an
essential requirement for installing Mailman, but it will come in handy at a
later date should you need other tools.  The developer's tools are also know
by the name XCode tools.

As a minimum, the Python version should be 2.2, but 2.3 is recommended.

If you wish to add a user and group using the command line in OSX instead of
via Webmin or another GUI interface, open your terminal application and follow
the commands as indicated below - do not type the comments following the
\samp{\#} since they are just notes:

\begin{verbatim}
sudo tcsh
niutil -create / /users/mailman
niutil -createprop / /users/mailman name mailman
# Note that xxx is a free group ID number on your system
niutil -createprop / /users/mailman uid xxx
niutil -createprop / /users/mailman home /usr/local/mailman
mkdir -p /usr/local/mailman
niutil -createprop / /users/mailman shell /bin/tcsh
passwd mailman
# To prevent malicious hacking, supply a secure password here
niutil -create / /groups/mailman
niutil -createprop / /groups/mailman name mailman
# Note that xxx is a free group ID number on your system
niutil -createprop / /groups/mailman gid xxx
niutil -createprop / /groups/mailman passwd '*'
niutil -createprop / /groups/mailman users 'mailman'
chown mailman:mailman /usr/local/mailman
cd /usr/local/mailman
chmod a+rx,g+ws .
exit
su mailman
\end{verbatim}

For setting up Apache on OSX to handle Mailman, the steps are almost identical
and the configuration file on a stock Mac OSX Client version is stored in the
nearly standard location of \file{/etc/httpd/httpd.conf}.

The \url{AFP548.com} site has a time-saving automated startup item creator for
Mailman, which can be found at 
\url{http://www.afp548.com/Software/MailmanStartup.tar.gz}

To install it, copy it into your \file{/Library/StartupItems} directory. As
the root or superuser, from the terminal, enter the following:

\begin{verbatim}
gunzip MailmanStartup.tar.gz
tar xvf MailmanStartup.tar
\end{verbatim}

It will create the startup item for you so that when you reboot, Mailman will
start up.

\end{document}