mpss.so.1

- 優先ページサイズを設定するための共有オブジェクト

形式

mpss.so.1 

機能説明

mpss.so.1 共有オブジェクトは、起動されたプロセスとその子孫のスタック、ヒープ、あるいはその両方の優先ページサイズを選択的に構成する手段を提供します。mpss.so.1 を有効にするには、次の文字列が 1 つ以上の MPSS (Multiple Page Size Support) 環境変数とともに環境内に存在する必要があります (ld.so.1(1) を参照)。

LD_PRELOAD=$LD_PRELOAD:mpss.so.1

環境変数

mpss.so.1 共有オブジェクトは、事前に読み込まれると次の環境変数を読み取り、その環境変数に固有のものである可能性がある優先ページサイズ要件とプロセスを判定します。

MPSSHEAP=size

MPSSSTACK=size

MPSSHEAP および MPSSSTACK には、それぞれヒープおよびスタックの優先ページサイズを指定します。指定したページサイズは、作成されたすべてのプロセスに適用されます。

size には、サポートされるページサイズ (pagesize(1) を参照) または 0 を指定する必要があります。0 を指定すると、適切なページサイズがシステムによって選択されます (memcntl(2) を参照)。

size は、K (K バイト)、M (M バイト)、G (G バイト)、または T (T バイト) で修飾できます。

MPSSCFGFILE=config-file

config-file は、次の形式の mpss 構成エントリを 1 つ以上含むテキストファイルです。

exec-name exec-args:heap-size:stack-size

exec-name には、アプリケーションまたは実行可能ファイルの名前を指定します。対応する優先ページサイズは、ファイル内で最初に見つかった exec-name と一致する新規作成プロセス (getexecname(3C) を参照) に設定されます。

exec-name には、フルパス名、基本名、またはパターン文字列を指定できます。パターンマッチングについては、sh(1) の「ファイル名の生成」を参照してください。

exec-args は、引数と照合する任意指定のパターン文字列です。exec-args が指定されていないか、または exec-args が exec-name の引数内に存在する場合にのみ、優先ページサイズは設定されます。

heap-size、stack-size、あるいはその両方を指定しないと、対応する優先ページサイズは設定されません。

MPSSCFGFILE は、MPSSHEAP および MPSSSTACK よりも優先されます。MPSSCFGFILE が設定されていない場合は、/etc/mpss.conf から優先ページサイズが取得されます (存在している場合)。

MPSSERRFILE=pathname

デフォルトでは、エラーメッセージは syslog(3C) の LOG_ERR レベルと LOG_USER 機能を使用してログに記録されます。MPSSERRFILE に有効な pathname (/dev/stderr など) が含まれている場合は、エラーメッセージがその場所に記録されます。

使用例

例 1 MPSSCFGFILE を使用して優先ページサイズを構成する

次の Bourne シェルコマンド (sh(1) を参照) は、MPSSCFGFILE 環境変数を使用して、foo で始まる実行可能ファイル名を持つ一連のアプリケーションに優先ページサイズを構成しています。MPSS 構成ファイル mpsscfg は、vi(1) などのテキストエディタを使用してが事前に作成されているものとします。cat(1) コマンドは、内容をダンプしているだけです。

example$ LD_PRELOAD=$LD_PRELOAD:mpss.so.1
example$ MPSSCFGFILE=mpsscfg
example$ export LD_PRELOAD MPSSCFGFILE
example$ cat $MPSSCFGFILE
foo*:512K:64K

アプリケーションの起動後、pmap (proc(1) を参照) を使用すると、構成された実際のページサイズを表示できます。

example$ foobar &
example$ pmap -s `pgrep foobar`

(pmap の出力に表示された) ページサイズが希望のサイズに構成されていない場合は、MPSS 構成ファイルまたは環境変数のエラーが原因である可能性があります。エラーログ (デフォルトでは /var/adm/messages) でエラーを確認してください。

エラーが見つからない場合は、リソースまたは境界合わせの制約が原因である可能性があります。「注意事項」の節を参照してください。

例 2 MPSSHEAP および MPSSSTACK を使用して優先ページサイズを構成する

次の Bourne シェルコマンドは、MPSSHEAP および MPSSSTACK 環境変数を使用して、すべてのアプリケーションに対して 512K のヒープの優先ページサイズと 64K のスタックの優先ページサイズを構成しています。

example$ LD_PRELOAD=$LD_PRELOAD:mpss.so.1
example$ MPSSHEAP=512K
example$ MPSSSTACK=64K
example$ export LD_PRELOAD MPSSHEAP MPSSSTACK

例 3 優先順位規則 (例 2 の続き)

MPSSCFGFILE による優先ページサイズの構成は、MPSSHEAP および MPSSTACK よりも優先されます。例 2 のあとに次のコマンドを追加すると、構成ファイルで指定された ls コマンドと名前が ora で始まり、引数として ora1 が指定されたアプリケーションを除くすべてのアプリケーションに対して、512K のヒープの優先ページサイズと 64K のスタックの優先ページサイズが構成されます。

example$ MPSSCFGFILE=mpsscfg2
example$ export MPSSCFGFILE
example$ cat $MPSSCFGFILE
ls::
ora* ora1:4m:4m

ファイル

/usr/lib/ld/map.bssalign

bss 整列用のテンプレートリンカーマップファイル (mapfile) (「注意事項」を参照)。

/etc/mpss.conf

構成ファイル

属性

属性についての詳細は、attributes(5) を参照してください。

関連項目

cat(1), ld(1), ld.so.1(1), pagesize(1), ppgsz(1), proc(1), sh(1), vi(1), exec(2), fork(2), memcntl(2), getexecname(3C), getpagesize(3C), syslog(3C), proc(4), attributes(5)

注意事項

ヒープおよびスタックの優先ページサイズは継承されます。子プロセスには親と同じ優先ページサイズが適用されます。exec(2) では、mpss 共有オブジェクトで優先ページサイズを構成しないかぎり、優先ページサイズがデフォルトのシステムページサイズに戻されます。

また、ppgsz(1) (proc ツール) を使用すると、スタック、ヒープ、あるいはその両方のページサイズを設定できます。ただし、名前の一致に基づいて子孫のページサイズを選択して構成することはできません。

ppgsz(1) の「注意事項」も参照してください。