マニュアルページ ss_attach.1
名前
ss_attach - Sun Studio IDE での、指定されたプロセスに接続 さ
れたデバッグセッションの開始
形式
ss_attach program-name [argument...] [-v|-V] [-?|--help]
機能説明
ss_attach コマンドは、一つまたは複数の argument を 付 け て
program-name を 呼び出し、program-name に接続されたデバッグ
セッションを Sun[tm] Studio IDE に開始させます。
ss_attach コマンドを発行する前に、「ツール」->「ss_attach 要
求 を許可」を選択することによって、Sun Studio IDE で、プロセ
スへのこの種の接続を可能にする必要があります。可能にしていな
い 場 合、 ss_attach コ マ ン ド は何のメッセージも出さずに
program-name の実行に進みます。
IDE のこの新しいデバッグセッションは、program-name と同じ 現
在の作業用ディレクトリを持ちます。
dbx から program-name が再実行できるよう、argument はデ バッ
グセッションに渡されます (dbx runargs を使って適用される)。
引数および作業用ディレクトリの指定は、そのプログラム の dbx
設定情報にあるあらゆる設定値に優先します。
たとえばシェルのループの暴走などのために、接続しようと す る
ss_attach コマンドが多すぎる場合、IDE はそれらの接続待ち状態
を 中 止 し ま す。 Sun Studio の 場 合、 こ れ は
spro.ss_attach.maxrequests によって制限されています。
終了ステータス
program-name の呼び出しに成功すると、ss_attach コマンドの 終
了ステータスは program-name の終了ステータスと同じです。失敗
した場合は、次のいずれかの値で終了します。:
1-125 ss_attach コマンドでエラーが発生しました。
126 program-name が見つかりましたが、呼び出せま
せんでした。
127 program-name が見つかりませんでした。
ss_attach が指定したプロセスに接続したデバッグセッションの開
始に成功しなかった場合は、-V オプションを使って ss_attach を
実行してみてください。
オプション
-v 詳細モード。ss_attach と IDE との対話に関する 情
報を表示します。
$ ss_attach -v date
ss_attach: trying to connect to IDE ...
ss_attach: got connection
ss_attach: waiting for session start in IDE ...
ss_attach: Proceeding with exec.
Mon Mar 22 16:34:09 PST 2004
$
-V バージョン。ss_attach のバージョンを表示して終了
します。
-? --help
ヘルプ。使用法のメッセージを表示して終了します。
制限事項
現在、Sun Studio IDE が動作していない場合、Sun Studio IDE の
イ ンスタンスを ss_attach コマンドに起動させる方法はありませ
ん。
複数のインスタンスの IDE が ss_attach 要求を許可してい る 場
合、 ss_attach コマンドがプログラムをどの IDE インスタンスに
接続するかは、定義されていません。
ss_attach コマンドは、Java アプリケーションの捕捉には役立 ち
ま せん。Java[tm] Virtual Machine は、一般的なネイティブアプ
リケーションとして扱われます。
ss_attach コマンドによって捕捉されたプログラムは、IDE の「デ
バッグ」->「最近行なった読み込み」メニューに追加されません。
捕捉したプロセスに対する実行時検査やパフォーマンスデータの収
集を簡単に有効にする機能はありません。
捕捉の成功時、main にデバッグ情報がある場合に dbx が main に
進むのを防ぐ方法はまだありません。このため、ss_attach コマン
ドは、静的初期化子のデバッグにはあまり向きません。
環境
パス execvp(2) を使用して、$PATH に program-name
がないか検索されます。
ファイル
なし。
エラー
次のエラーメッセージで考えられる原因:
ss_attach: could not connect to external start service --
service not registered
IDE と ss_attach が、
o 同じユーザーによって起動されていない
o 同じ $DISPLAY 環境変数の設定を使って起動されていない (画面
番号が異なることが許可されている)
関連項目
dbx(1)、sunstudio(1)、execvp(2)