mhash_keygen_s2k() は、指定したパスワードから 長さが bytes のキーを生成します。これは、 OpenPGP のドキュメント (RFC 2440) で規定された Salted S2K アルゴリズムによります。このアルゴリズムは、キーを生成する際に 指定した hash アルゴリズムを使用します。 異なったキーを生成するため、キーを生成する度毎に salt は毎回異なり十分にランダムである必要があります。 キーを調べる際に salt を知っている必要があるため、キーを salt に付加するというのは 良い発想です。salt は8バイト固定長で、これより少ない場合はゼロで 埋められます。
ユーザが指定したパスワードが暗号化アルゴリズムのキーとして 実際には使用できないことに注意してください。これは、ユーザは 通常キーボードから入力可能なキーを選択するからです。これらの パスワードは文字当たり 6 から 7 ビットのみ(もしくはそれ以下)を 使用しています。このようなパスワードは、ユーザの指定したキーに (この関数のような)ある種の変換を行うことが強く推奨されます。