名前 | 形式 | 機能説明 | オプション | オペランド | 列 | 使用例 | 終了ステータス | 属性 | 関連項目
svcs [-aHpv?] [-o col[,col]]... [-R FMRI-instance]... [-sS col]... [FMRI | pattern]...
svcs {-d | -D} [-Hpv?] [-o col[,col]]... [-sS col]... [FMRI | pattern] ...
svcs -l [FMRI | pattern]...
svcs -x [-v] [FMRI]...
svcs コマンドは、サービス設定リポジトリに記録されているサービスインスタンスに関する情報を表示します。
このコマンドの 1 番目の形式では、引数に指定したサービスインスタンスの状態が、1 行のリストとして出力されます。各インスタンスは 1 回だけ出力されます。引数を指定しない場合は、有効になっているすべてのサービスインスタンス (一時的に無効になっているものも含む) が、あとに示すように列のリストとして出力されます。
2 番目の形式では、引数に指定したサービスインスタンスの依存関係 (依存しているサービス) の状態が、1 行のリストとして出力されます。
3 番目の形式では、特定のサービスおよびインスタンスに関する詳細情報が出力されます。
4 番目の形式では、サービスインスタンスの状態の説明が出力されます。指定した引数ごとに、サービスの状態およびその状態になった理由の説明が、人間が読み取れる形式のテキストで表示されます。引数を指定しない場合は、問題の発生したサービスの説明が表示されます。
エラーメッセージが標準エラーストリームに出力されます。
このコマンドの出力は、svcadm(1M) コマンドへの適切な入力として使用できます。
サポートしているオプションは、次のとおりです。
列指定子を含めて、使用状況のメッセージを詳細に表示します。
無効になっているサービスを含めて、すべてのサービスを表示します。サービスが選択されている場合は、このオプションの効果はありません。
指定されたサービスインスタンスが依存するサービスまたはサービスインスタンスの一覧を表示します。
指定されたサービスまたはサービスインスタンスに依存するサービスインスタンスの一覧を表示します。
列ヘッダーを省略します。
(英字のエル)。選択されたサービスおよびサービスインスタンスについて、表示可能な情報をすべて表示します。各行に 1 つのサービス属性が表示されます。異なるインスタンスの情報は、空白行で区切られます。
次の属性について個別に説明します。
依存関係に関する情報。グループ化および restart_on プロパティーが最初に表示されます。プロパティーの間はスラッシュ (/) で区切られます。次に、各エンティティーとその状態が表示されます。状態の詳細については、smf(5) を参照してください。標準の状態のほかに、各サービスの依存関係に次の状態説明が表示される場合があります。
このサービスはシステムに定義されていません。
障害管理リソース識別子 (FMRI) は無効です (smf(5) を参照)。
このエンティティーは、複数のインスタンスを持つサービスです。
ファイルの依存関係には、次のいずれかの状態説明のみ表示されます。
このファイルはシステムに存在しません。
このファイルは存在します。
最後に svc.startd がサービスの依存関係を評価したときにファイルが存在しなかった場合には、依存関係が満たされていないものとみなされることがあります。svcadm refresh は、強制的に依存関係を再評価します。
ENOENT 以外の理由で、stat(2) が失敗しました。
依存関係、グループ化、および restart_on の値の詳細については、smf(5) を参照してください。
このサービスが有効であるかどうか、および一時的に (次回のシステム再起動まで) 有効であるか無効であるかの情報。サービスが有効かどうかは、true または false によって示されます。一時的に有効かどうかは、(temporary) が存在するかどうかで示されます。
管理者が svcadm disable -t を実行した場合、svcadm milestone を使用した場合、または特定のタイミングにシステムをブートした場合に、サービスが一時的に無効になることがあります。詳細については、svcadm(1M) を参照してください。
指定された列を出力します。各 col は列名でなければなりません。指定できる列については、後述の「列」を参照してください。
各サービスインスタンスに関連付けられているプロセスの一覧を表示します。サービスインスタンスによっては、プロセスが関連付けられていないことがあります。プロセス ID、開始時刻、およびコマンド名 (ps(1) の PID、STIME、および CMD フィールド) がプロセスごとに表示されます。
指定されたサービスインスタンスをリスタータとして使用するサービスインスタンスを選択します。
出力を列でソートします。col は列名でなければなりません。指定できる列については、後述の「列」を参照してください。複数の -s オプションが指定された場合は、指定された順番にソートします。
オプション -s と反対の順序に、 col でソートします。
-x が指定されていない場合は、次の冗長列を表示します。STATE、NSTATE、 STIME、CTID、および FMRI。
-x が指定されている場合は、各説明に関する追加情報を表示します。
サービスの状態の説明を表示します。
引数が指定されていない場合の -x オプションは、次のようなサービスの状態説明を表示します。
有効になっているが、実行されていない。
別の有効なサービスが動作しているので、実行できない。
次のオペランドがサポートされています。
1 つまたは複数のインスタンスを指定する障害管理リソース識別子 (FMRI) (smf(5) を参照)。インスタンス名を指定するか、サービス名の連続する部分を指定することにより、FMRI を省略形にすることもできます。たとえば、次のような FMRI を仮定します。
svc:/network/smtp:sendmail |
この場合、次に示す省略形は有効です。
sendmail :sendmail smtp smtp:sendmail network/smtp |
この場合、次に示す省略形は無効です。
mail network network/smt |
FMRI にサービスを指定した場合は、-D オプションを一緒に使用している場合を除いて、そのサービスのすべてのインスタンスにコマンドが適用されます。
FMRI の省略形は不安定なので、スクリプトやその他の長期に渡って使用するツールには使用しないでください。
fnmatch(5) で説明されている展開規則に従ってサービスインスタンスの FMRI と照合されるパターン。このパターンが「svc:」で始まっていない場合は、「svc:/」が前に付加されます。glob パターンの一般的な例を次に示します。
qexample% svcs \*keyserv\* STATE STIME FMRI disabled Aug_02 svc:/network/rpc/keyserv:default |
あるインスタンスを指定する FMRI。
列名の大文字と小文字は区別されません。デフォルトの出力形式は「-o state,stime,fmri」です。デフォルトのソート列は STATE、STIME、FMRI です。
サービスインスタンスの主契約 ID。すべてのインスタンスに有効な主契約 ID が割り当てられているわけではありません。
テンプレート要素から渡された、サービスの簡単な説明。説明が渡されていないサービスの場合は、値が空であることを示すために、ハイフン (-) が使用されます。
サービスインスタンスの FMRI。
サービスインスタンスのインスタンス名。
サービスインスタンスの次の状態 (省略名)。STA 列の説明を参照してください。ハイフンは、インスタンスが移行していないことを示します。それ以外は STA と同じです。
サービスの次の状態。ハイフンは、インスタンスが移行していないことを示します。それ以外は STATE と同じです。
サービスインスタンスの有効範囲名。
サービスインスタンスのサービス名。
サービスインスタンスの状態 (省略名) (smf(5) を参照)。
機能低下
無効
レガシー rc*.d スクリプト主導インスタンス
保守
オフライン
オンライン
未初期化
状態が存在しないか認識されない場合は、疑問符 (?) が表示されます。移行中のインスタンスにはアスタリスク (*) が付加されます。ただし、NSTA 列または NSTATE 列が一緒に表示されている場合には付加されません。
サービスの状態の説明については、smf(5) を参照してください。
サービスインスタンスの状態。移行中のインスタンスには、アスタリスクが付加されます。ただし、NSTA 列または NSTATE 列が一緒に表示されている場合には付加されません。
サービスの状態の説明については、smf(5) を参照してください。
直前の 24 時間の間にサービスインスタンスが現在の状態になった場合は、この列にその時刻が表示されます。それ以外の場合は、その日付が表示されます。空白の場所は下線 (_) に変換されます。
この例では、デフォルトの出力が表示されます。
example% svcs STATE STIME FMRI ... legacy_run 13:25:04 lrc:/etc/rc3_d/S42myscript ... online 13:21:50 svc:/system/svc/restarter:default ... online 13:25:03 svc:/milestone/multi-user:default ... online 13:25:07 svc:/milestone/multi-user-server:default ... |
この例では、service1 サービスのすべてのローカルインスタンスの一覧が表示されます。
example% svcs -o state,nstate,fmri service1 STATE NSTATE FMRI online - svc:/service1:instance1 disabled - svc:/service1:instance2 |
この例では、冗長情報が表示されます。
example% svcs -v network/rpc/rstat:udp STATE NSTATE STIME CTID FMRI online - Aug_09 - svc:/network/rpc/rstat:udp |
この例では、system/service3 のすべてのインスタンスに関する詳細情報が表示されます。管理しているリスタータに応じて、追加フィールドが表示されます。
example% svcs -l network/rpc/rstat:udp fmri svc:/network/rpc/rstat:udp enabled true state online next_state none restarter svc:/network/inetd:default contract_id dependency require_all/error svc:/network/rpc/bind (online) |
example% svcs -p sendmail STATE STIME FMRI online 13:25:13 svc:/network/smtp:sendmail 13:25:15 100939 sendmail 13:25:15 100940 sendmail |
(a) この例では、svcs -x を実行することで、無効になっている print/server サービスが、ある 2 つのサービスが有効なのにオンラインになっていない根本原因であることが明らかになりました。svcs -xv を実行すると、それらのサービスが print/rfc1179 と print/ipp-listener であることがわかります。この状況を解決するには、print/server を有効にするか、あるいは rfc1179 と ipp-listener を無効にします。
example% svcs -x svc:/application/print/server:default (LP print server) State: disabled since Mon Feb 13 17:56:21 2006 Reason: Disabled by an administrator. See: http://sun.com/msg/SMF-8000-05 See: lpsched(1M) Impact: 2 dependent services are not running. (Use -v for list.) |
(b) この例では、NFS が動作していません。
example$ svcs nfs/client STATE STIME FMRI offline 16:03:23 svc:/network/nfs/client:default |
(c) 次の例から、問題は nfs/status にあることがわかります。nfs/client が待機中になっている理由は、nfs/status に依存する nfs/nlockmgr に、自身が依存しているからです。
example$ svcs -xv nfs/client svc:/network/nfs/client:default (NFS client) State: offline since Mon Feb 27 16:03:23 2006 Reason: Service svc:/network/nfs/status:default is not running because a method failed repeatedly. See: http://sun.com/msg/SMF-8000-GE Path: svc:/network/nfs/client:default svc:/network/nfs/nlockmgr:default svc:/network/nfs/status:default See: man -M /usr/share/man -s 1M mount_nfs See: /var/svc/log/network-nfs-client:default.log Impact: This service is not running. |
次の属性については、attributes(5) を参照してください。
属性タイプ |
属性値 |
---|---|
使用条件 |
SUNWcsu |
インタフェースの安定性 |
以下を参照。 |
画面出力は不安定 (Unstable) です。この呼び出しは開発中です。
ps(1), svcprop(1), svcadm(1M), svccfg(1M), svc.startd(1M), stat(2), libscf(3LIB), attributes(5), fnmatch(5), smf(5)
名前 | 形式 | 機能説明 | オプション | オペランド | 列 | 使用例 | 終了ステータス | 属性 | 関連項目