| Current File : //usr/share/man/ja_JP.UTF-8/man1/rcapstat.1 |
'\" te
.\" Copyright (c) 2010, 2015, Oracle and/or its affiliates.All rights reserved.
.TH rcapstat 1 "2015 年 3 月 20 日" "SunOS 5.11" "ユーザーコマンド"
.SH 名前
rcapstat \- リソース上限適用デーモンの統計の報告
.SH 形式
.LP
.nf
\fBrcapstat\fR [\fB-p | -z\fR] [\fB-T\fR u | d ] [\fIinterval\fR [\fIcount\fR]]
.fi
.SH 機能説明
.sp
.LP
\fBrcapstat\fR コマンドは、\fBrcapd\fR(1M) によって上限が設けられたゾーンまたはプロジェクトについて報告します。各報告には、プロジェクトまたはゾーンに関する統計、およびページング統計が含まれています。ページングとは、物理メモリーから (または物理メモリーへ) ページと呼ばれるメモリーの一部を再配置する処理を指します。\fBrcapd\fR は、もっとも使用されていないページをページアウトします。
.sp
.LP
最初に発行する報告では、ページング統計はデーモンの起動以降の活動を示します。以後の報告では、前回の報告以降の活動を示します。
.sp
.LP
報告は、\fIinterval\fR 秒ごとに \fIcount\fR によって指定されている回数まで発行されます。\fIcount\fR が指定されていない場合は、停止されることなく発行され続けます。
.SH オプション
.sp
.LP
サポートしているオプションは、次のとおりです。
.sp
.ne 2
.mk
.na
\fB\fB-p\fR\fR
.ad
.RS 12n
.rt
上限が設けられたプロジェクトの統計を報告します。これは、オプションが指定されていない場合のデフォルトです。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-T\fR \fBu\fR | \fBd\fR\fR
.ad
.RS 12n
.rt
タイムスタンプを表示します。
.sp
時間の内部表現の出力表現に \fBu\fR を指定します。\fBtime\fR(2) を参照してください。 標準の日付フォーマットに \fBd\fR を指定します。\fBdate\fR(1) を参照してください。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-z\fR\fR
.ad
.RS 12n
.rt
上限が設けられたゾーンの統計を報告します。
.RE
.SH 出力
.sp
.LP
\fBrcapstat\fR の報告の列見出しの定義、および報告の解釈方法についての情報を、次のリストに示します。
.sp
.ne 2
.mk
.na
\fB\fBid\fR\fR
.ad
.RS 12n
.rt
上限が設けられたプロジェクトまたはゾーンのプロジェクト ID またはゾーン \fBID\fR。
.RE
.sp
.ne 2
.mk
.na
\fB\fBcappd\fR\fR
.ad
.RS 12n
.rt
適用されるプロジェクトまたはゾーンの上限です。
.RE
.sp
.ne 2
.mk
.na
\fB\fBproject\fR \fR
.ad
.RS 12n
.rt
プロジェクト名。
.RE
.sp
.ne 2
.mk
.na
\fB\fBzone\fR\fR
.ad
.RS 12n
.rt
ゾーン名。
.RE
.sp
.ne 2
.mk
.na
\fB\fBnproc\fR\fR
.ad
.RS 12n
.rt
前回の報告以降のプロジェクトまたはゾーンのプロセス数。
.RE
.sp
.ne 2
.mk
.na
\fB\fBvm\fR\fR
.ad
.RS 12n
.rt
ディスクまたはメモリーのスワップを予約するすべての匿名マッピングの合計。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrss\fR\fR
.ad
.RS 12n
.rt
プロジェクトまたはゾーンのプロセス常駐の合計設定サイズ (\fBRSS\fR)。単位は、キロバイト (\fBK\fR)、メガバイト (\fBM\fR)、またはギガバイト (\fBG\fR) です。サイズには共有ページは含まれていません。
.RE
.sp
.ne 2
.mk
.na
\fB\fBcap\fR\fR
.ad
.RS 12n
.rt
プロジェクトまたはゾーンの \fBRSS\fR の上限。メモリーの上限を指定する方法については、\fBrcapd\fR(1M) を参照してください。
.RE
.sp
.ne 2
.mk
.na
\fB\fBat\fR\fR
.ad
.RS 12n
.rt
\fBrcapd\fR がページアウトを試みるメモリーの合計容量。
.sp
ページングとは、物理メモリーから (または物理メモリーへ) ページと呼ばれるメモリーの一部を再配置する処理を指します。\fBrcapd\fR は、もっとも使用されていないページをページアウトします。
.RE
.sp
.ne 2
.mk
.na
\fB\fBavgat\fR\fR
.ad
.RS 12n
.rt
\fBrcapd\fR が各サンプリングサイクル中にページアウトを試みるメモリーの平均サイズ。\fBrcapd\fR が \fBRSS\fR をサンプリングする頻度は、\fBrcapadm\fR(1M) で設定できます。
.RE
.sp
.ne 2
.mk
.na
\fB\fBpg\fR\fR
.ad
.RS 12n
.rt
\fBrcapd\fR が正常にページアウトするメモリーの合計容量の見積り。
.RE
.sp
.ne 2
.mk
.na
\fB\fBavgpg\fR\fR
.ad
.RS 12n
.rt
\fBrcapd\fR が各サンプリングサイクル中に正常にページアウトするメモリーの平均サイズの見積り。\fBrcapd\fR がプロセス \fBRSS\fR をサンプリングする頻度は \fBrcapadm\fR で設定できます。
.RE
.SH オペランド
.sp
.LP
次のオペランドがサポートされています。
.sp
.ne 2
.mk
.na
\fB\fIinterval\fR\fR
.ad
.RS 12n
.rt
報告間隔を指定します (秒)。デフォルトの間隔は 5 秒です。
.RE
.sp
.ne 2
.mk
.na
\fB\fIcount\fR\fR
.ad
.RS 12n
.rt
報告を生成する回数を指定します。デフォルトでは、終了シグナルを受信するまで、あるいは、\fBrcapd\fR プロセスが終了するまで、\fBrcapstat\fR は統計を報告し続けます。
.RE
.SH 使用例
.LP
\fB例 1 \fR\fBrcapstat\fR を使用した、上限とプロジェクト情報の報告
.sp
.LP
2 人のユーザーに関連付けられた 2 つのプロジェクトに、上限が定義されています。\fBuser1\fR の上限は 50M バイト、\fBuser2\fR の上限は 10M バイトです。
.sp
.LP
次のコマンドは、5 つの報告を 5 秒間のサンプリング間隔で生成します。
.sp
.in +2
.nf
example# \fBrcapstat 5 5\fR
id project cappd nproc vm rss cap at avgat pg avgpg
112270 user1 Yes 24 123M 35M 50M 50M 0K 3312K 0K
78194 user2 Yes 1 2368K 1856K 10M 0K 0K 0K 0K
id project cappd nproc vm rss cap at avgat pg avgpg
112270 user1 Yes 24 123M 35M 50M 0K 0K 0K 0K
78194 user2 Yes 1 2368K 1856K 10M 0K 0K 0K 0K
id project cappd nproc vm rss cap at avgat pg avgpg
112270 user1 Yes 24 123M 35M 50M 0K 0K 0K 0K
78194 user2 Yes 1 2368K 1928K 10M 0K 0K 0K 0K
id project cappd nproc vm rss cap at avgat pg avgpg
112270 user1 Yes 24 123M 35M 50M 0K 0K 0K 0K
78194 user2 Yes 1 2368K 1928K 10M 0K 0K 0K 0K
id project cappd nproc vm rss cap at avgat pg avgpg
112270 user1 Yes 24 123M 35M 50M 0K 0K 0K 0K
78194 user2 Yes 1 2368K 1928K 10M 0K 0K 0K 0K
.fi
.in -2
.sp
.sp
.LP
出力の最初の 3 行は 1 回目の報告です。ここには、2 つのプロジェクトに関する上限とプロジェクトの情報、および \fBrcapd\fR 起動以降のページング統計が記載されています。\fBat\fR と \fBpg\fR の列において、\fBuser1\fR にはゼロより大きな値が入っており、\fBuser2\fR にはゼロが入っています。これは、1 回目の報告の期間中、\fBuser1\fR は上限を超えたが、\fBuser2\fR は超えなかったことを意味します。
.sp
.LP
2 回目以降の報告では、目立った活動はありません。
.LP
\fB例 2 \fR\fBrcapstat\fR を使用した、プロジェクトの RSS の監視
.sp
.in +2
.nf
example% \fBrcapstat 5 5\fR
id project cappd nproc vm rss cap at avgat pg avgpg
376565 user1 Yes 57 209M 46M 10M 440M 220M 5528K 2764K
376565 user1 Yes 57 209M 44M 10M 394M 131M 4912K 1637K
376565 user1 Yes 56 207M 43M 10M 440M 147M 6048K 2016K
376565 user1 Yes 56 207M 42M 10M 522M 174M 4368K 1456K
376565 user1 Yes 56 207M 44M 10M 482M 161M 3376K 1125K
.fi
.in -2
.sp
.sp
.LP
プロジェクト \fBuser1\fR には、物理メモリーの上限を超える \fBRSS\fR があります。\fBpg\fR 列の 0 以外の値が示しているとおり、\fBrcapd\fR は、このプロジェクトのプロセスの物理メモリーの使用率を上限に合わせて下げようと、メモリーをページアウトし続けています。ただし、\fBrcapd\fR が成功していないのは、\fBrss\fR 値が相応の減少を示していないことでわかります。これは、アプリケーションの常駐メモリーがアクティブに使用されているために \fBrcapd\fR が作業用セットに影響を及ぼしていることを意味します。この状況では、作業用セットのサイズ (\fBWSS\fR) が減少するか、上限を上げるか、アプリケーションのメモリーアクセスパターンを変更するまで、高いページフォルト率とそれに関連する入出力がシステムで続きます。ページフォルトが発生するのは、新しいページを作成する必要があるとき、あるいは、システムがスワップデバイスからページをコピーする必要があるときです。
.LP
\fB例 3 \fRプロジェクトの作業セットサイズの決定
.sp
.LP
この例は、\fB例 1\fR の続きで、同じプロジェクトを使用します。
.sp
.in +2
.nf
example% \fBrcapstat 5 5\fR
id project cappd nproc vm rss cap at avgat pg avgpg
376565 user1 Yes 56 207M 44M 10M 381M 191M 15M 7924K
376565 user1 Yes 56 207M 46M 10M 479M 160M 2696K 898K
376565 user1 Yes 56 207M 46M 10M 424M 141M 7280K 2426K
376565 user1 Yes 56 207M 43M 10M 401M 201M 4808K 2404K
376565 user1 Yes 56 207M 43M 10M 456M 152M 4800K 1600K
376565 user1 Yes 56 207M 44M 10M 486M 162M 4064K 1354K
376565 user1 Yes 56 207M 52M 100M 191M 95M 1944K 972K
376565 user1 Yes 56 207M 55M 100M 0K 0K 0K 0K
376565 user1 Yes 56 207M 56M 100M 0K 0K 0K 0K
376565 user1 Yes 56 207M 56M 100M 0K 0K 0K 0K
376565 user1 Yes 56 207M 56M 100M 0K 0K 0K 0K
376565 user1 Yes 56 207M 56M 100M 0K 0K 0K 0K
.fi
.in -2
.sp
.sp
.LP
プロジェクトの上限を上げるか、上限適用の最小物理メモリー使用率を変更して、上限の適用を禁止することにより (\fBrcapadm\fR(1M) 参照)、常駐セットを作業用セットにすることができます。前の例で示したように、\fBrss\fR 列が安定してプロジェクトの \fBWSS\fR を表示するようになる可能性があります。\fBWSS\fR は、このプロジェクトのプロセスがページフォルトを絶え間なく起こさずに動作できる、上限の最小値です。
.LP
\fB例 4 \fRRSS 上限の自動適用/非適用
.sp
.in +2
.nf
example% \fBrcapstat 10\fR
id project cappd nproc vm rss cap at avgat pg avgpg
100 user1 Yes - 101M 103M 100M 0K 0K 0K 0K
100 user1 Yes - 101M 103M 100M 0K 0K 0K 0K
100 user1 Yes - 101M 103M 100M 0K 0K 0K 0K
100 user1 Yes 2 201M 203M 100M 2780K 2780K 2780K 2780K
100 user1 Yes - 201M 203M 100M 0K 0K 0K 0K
100 user1 Yes 2 201M 203M 100M 103M 103M 103M 103M
100 user1 Yes 2 201M 203M 100M 103M 103M 103M 103M
100 user1 Yes - 201M 203M 100M 0K 0K 0K 0K
100 user1 Yes 2 201M 203M 100M 103M 103M 103M 103M
100 user1 Yes 2 201M 203M 100M 103M 103M 103M 103M
100 user1 Yes - 201M 203M 100M 0K 0K 0K 0K
100 user1 Yes 2 201M 203M 100M 103M 103M 103M 103M
100 user1 Yes 2 201M 203M 100M 103M 103M 103M 103M
100 user1 Yes - 201M 203M 100M 0K 0K 0K 0K
100 user1 Yes 2 201M 203M 100M 103M 103M 103M 103M
100 user1 Yes 2 201M 203M 100M 103M 103M 103M 103M
100 user1 Yes - 201M 203M 100M 0K 0K 0K 0K
100 user1 No 2 201M 203M 100M 103M 103M 103M 103M
100 user1 Yes - 101M 103M 100M 0K 0K 0K 0K
100 user1 Yes - 101M 103M 100M 0K 0K 0K 0K
.fi
.in -2
.sp
.sp
.LP
プロジェクト user1 は、その最大の物理メモリー上限である 100M を超える、常駐の設定サイズ 200M から始まります。最初、\fBrcapd\fR はプロジェクトに上限の適用を開始します。これは \fBcappd\fR 列の「Yes」で示されています。しばらくすると、\fBrcapd\fR は、プロジェクト user1 に対して設定されたメモリー上限は実現不可能であると評価します。頻繁に使用するページをスラッシュするとパフォーマンスが低下するため、それを回避するために user1 への上限の適用を停止します。このため、cappd 見出しに「No」と表示されます。user1 の常駐の設定サイズが 100M に減少すると、rcapd がプロジェクトにふたたび上限を適用し始めることがわかります。
.SH 終了ステータス
.sp
.LP
次の終了ステータスが返されます。
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.RS 5n
.rt
正常終了。
.RE
.sp
.ne 2
.mk
.na
\fB\fB1\fR\fR
.ad
.RS 5n
.rt
エラーが発生した。
.RE
.sp
.ne 2
.mk
.na
\fB\fB2\fR\fR
.ad
.RS 5n
.rt
無効なコマンド行オプションが指定されました。
.RE
.SH 属性
.sp
.LP
属性についての詳細は、マニュアルページの \fBattributes\fR(5) を参照してください。
.sp
.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i)
lw(2.75i) |lw(2.75i)
.
属性タイプ属性値
_
使用条件system/resource-mgmt/resource-caps
.TE
.SH 関連項目
.sp
.LP
\fBrcapadm\fR(1M), \fBrcapd\fR(1M), \fBattributes\fR(5)
.sp
.LP
『\fIOracle Solaris のシステム管理 (リソース管理)\fR』の「\fIリソース上限デーモンによる物理メモリーの制御\fR」
.SH 注意事項
.sp
.LP
\fBrcapstat\fR に指定した間隔が、(\fBrcapadm\fR(1M) で) \fBrcapd\fR に指定した報告間隔よりも短い場合、いくつかの間隔に対する出力がゼロになることがあります。これは、\fBrcapd\fR は、\fBrcapadm\fR で指定された間隔ほど頻繁に統計を更新しないためです。この間隔は、\fBrcapstat\fR によって使用されるサンプリング間隔より正確ではなく、かつ無関係です。