swlist(1M)

(ルートファイルシステムにインストールされているソフトウェアではなく)、デポからロード可能なソフトウェアをリストします。

swlist の対話型ユーザーインタフェースを呼び出します。この対話型のインタフェースによって、ユーザーは SD ソフトウェアオブジェクトを参照できます。 swlist -i -d を呼び出すと、デポソフトウェアを参照できます。詳細については、『対話型操作』および『リモート操作』の項を参照してください。

コマンドが代替ルートディレクトリで動作するようになります。代替ルートディレクトリは、@ target_selections オプションで指定する必要があります。(代替ルート操作にはこのオプションは必須ではありませんが、旧製品との互換性のために維持されています。詳細については、sd(5) の『代替ルートディレクトリとデポディレクトリ』 の項を参照してください。)

-l bundle -l product -l subproduct -l fileset の簡略形式です。

-a オプションが指定されていない場合は、オブジェクトのすべての属性をリストします。(ベンダー定義属性は含まれません。 -a オプションを参照。) 属性は次のように １ 行に １ 属性でリストされます。

attribute_name attribute_value

(すべての SD 属性の詳細は、sd(4) を参照してください。)

リビジョン、説明、ベンダー定義属性、サイズなど指定した attribute を表示します。(すべての SD 属性の詳細は、sd(4) を参照してください。) 属性は次のように １ 行に １ 属性でリストされます。

attribute_name attribute_value

複数の -a オプションを指定して複数の属性を表示することもできます。

あるソフトウェアオブジェクトの属性を全部リストしたい場合は、-v オプションを使用できます。

なお、プロダクト、サブプロダクト、およびファイルセットのオブジェクトの場合、tag 属性 (識別子) は常に表示されます。また、ファイルオブジェクトの場合、path 属性 (ファイル名) は常に表示されます。

完全なカタログ構造情報を catalog 修飾子によって指定されたディレクトリに書き込みます。配布用にエクスポートされたこのカタログ構造を使用して、インストール済みソフトウェアカタログ情報をリストすることができます。

-c catalog オプションを使用する場合は、-a attribute および -l level は適用されません。ファイルレベル以上のすべての属性と制御スクリプトが、カタログに書き込まれます。

現在のオプションとオペランドを session_file に保存します。ファイル名に相対パスまたは絶対パスを指定できます。セッションファイルのデフォルトのディレクトリは、/.sw/sessions/ です。-S オプションを使用して、セッションファイルを再び呼び出すことができます。(セッション管理は、-i オプションによって実行される swlist の対話型ユーザーインタフェース には適用されないことに注意してください。)

software_selections のリストを、コマンド行からではなく (あるいはコマンド行からだけでなく)、software_file から (も) 読み取ります。

指定された level 以上のすべてのオブジェクトをリストします。ここで指定したレベルと、software_selections で指定した深さは、両方とも swlist 出力の深さを制御します。

リストするソフトウェアソースを指定します。これは、ソースデポをリストする方法の １ つです。ソースをターゲットデポとして指定し、-d オプションでリストすることもできます。

session_file での定義に従って、前のセッションで保存されたオプションとオペランドに基づいて swlist を実行します。 -C オプションを使用して、セッション情報をファイルに保存することができます。(セッション管理は、-i オプションによって呼び出される swlist の対話型ユーザーインタフェースには適用されないことに注意してください。)

target_selections のリストを、コマンド行からではなく (あるいはコマンド行からだけでなく)、target_file から (も) 読み取ります。

セッションの option の値として value を設定し、デフォルト値 (または -X オプションで指定された代替の option_file の中の値) を無効にします。複数の -x オプションを指定できます。

セッションのオプションと動作を option_file から読み取ります。

システム全体のデフォルト値

ユーザー固有のデフォルト値

インストール済みのソフトウェアカタログの SD ログファイルとデフォルトの親ディレクトリの位置を指定します。標準の SD 操作でのデフォルト値は /var/adm/sw です。SD を非特権モードで操作する場合 (run_as_superuser デフォルトオプションを true に設定) は、次のようになります。

SD の非特権モードは、設計とパッケージ化が特別に行われるアプリケーションを管理するときにのみ使用するためのものです。 HP-UX オペレーティングシステムまたはそのパッチの管理には、このモードを使用できません。非特権の SD の詳細については、http://docs.hp.com/ja にある『 Software Distributor 管理者ガイド』 を参照してください。

installed_software_catalog および run_as_superuser オプションも併せて参照してください。

ターゲットエージェントが指定された時間中アクティブでない場合に、そのターゲットエージェントを終了させます。 これは、RPC が消失したネットワーク接続を検知するのに 130 分間かかる場合があるので、 ターゲットエージェントがより速く消失したネットワーク接続を検知できるようにするために使用されます。 お薦めできる値は、使用環境で予測されるアクティブでない最長の期間です。コマンド行の呼び出しの場合、10 分から 60 分の間の値が適切です。 GUI が使用される場合には、60 分以上の値をお薦めします。デフォルト値の 10000 は、7 日間よりもわずかに短い期間です。

保護された HP CD-ROM ソフトウェアをロツク解除するために必要な「コードワード」を定義します。

一部の HP ソフトウェア製品は、「プロテクト付き」の CD-ROM 製品として出荷されています。 つまり、これは「コードワード」と「顧客 ID」を入手しないとインストールやコピーができない製品です。 このコードワードは、HP から受け取る CD-ROM 使用許可証明書に記載されています。 このデフォルト指定構文をコマンド行または SD-UX 対話型ユーザーインタフェースで使用すれば、コードワードを入力することができます。

このデフォルトは、コードワードを将来の参照のために保存します。コードワードの入力は １ 回だけ行う必要があります。 新しい HP 製品を購入した際、その CD-ROM に対して前のコードワードが既に入力されている場合は、新しいコードワードを普通に入力すれば、それらのコードワードが内部で結合されます。

注記: HP-UX B.10.10 以降のシステムでは、SD は.codewords ファイルを、プロテクト付きソフトウェアを他のホストに提供しているサーバー上で捜します。 SD は customer_id とコードワードの有効なペアを捜します。 この方式により、SD ではソフトウェアを「受け取る」すべてのホスト上でコードワードと customer_id を入力する必要性が解消されています。

CD-ROM の customer_id とコードワードを正しく格納するためには、その CD-ROM が対応するホスト上で swinstall -p または swcopy -p を実行してください。コードワードが格納されると、それ以後、そのホストと CD-ROM をソースとして使用してソフトウェアをインストール (またはコピー) するクライアントは、コードワードと customer_id を必要としなくなります。

累積ソースデポの場合、このオプションを指定すると、swlist、swcopy および swinstall によるソフトウェアセレクションを長期的に一貫して行うことができます。 デフォルトのゼロでは、ソフトウェアセレクションおよび他のオプションに基づいて、ソースデポにあるすべてのバンドル、製品、サブ製品、ファイルセットが選択 (依存ソフトウェアやパッチの自動選択も含む) の対象になります。時間 (ゼロ時間からの秒数で指定) に設定すると、create_time が指定値以下となっているバンドル、製品、ファイルセット (製品内のサブ製品を含む) のみが選択 (または自動選択) の対象になります。バンドル、製品、およびファイルセットの create_time を表示するには、次のように指定します。

swlist -a create_time -a create_date

この数値もソフトウェアの使用許諾書に記載されています。これは保護されたソフトウェアを「ロック解除」して、そのインストールを特定のサイトまたは所有者に限定するために使用されます。 -x customer_id= オプションを使用するか、または対話型ユーザーインタフェースを使用することによって、この値を入力します。 customer_id は、HP-UX 10.X 以降のシステムで使用できます。

ターゲットデポのデフォルトの場所を定義します。

インストール済み製品データベース (IPD) が保存されているディレクトリパスを定義します。この情報は、インストール済みのソフトウェアについて説明しています。 このオプションを絶対パスに設定すると、IPD の位置を定義できます。このオプションに相対パスを指定すると、SD コントローラーは admin_directory オプションで指定されている値に相対パスを追加して、IPD のパスを決定します。代替ルートの場合には、このパスが代替ルートの位置を示す相対パスになります。 このオプションは、ソフトウェアのインストール場所には何ら影響を及ぼしません。

このオプションでは、個々のアプリケーションまたはアプリケーショングループで異なる IPD を使用することで、 複数のユーザーまたは複数のプロセスで複数のソフトウェアアプリケーションを同時にインストールおよび削除できるようになります。

注意: 特定のアプリケーションを管理するには、特定の installed_software_catalog を使用してください。SD では、いくつもの IPD で同じアプリケーションの記述をいくつも扱うことができません。

SD の非特権モードを制御する admin_directory および run_as_superuser オプションも参照してください (このモードは、設計とパッケージ化が特別に行われるアプリケーションを管理するときにのみ使用するためのものです。 HP-UX オペレーティングシステムまたはそのパッチの管理には、このモードを使用できません。非特権の SD の詳細については、http://docs.hp.com/ja にある『 Software Distributor 管理者ガイド』 を参照してください)。

配布媒体および swlist 出力を書き込む際に、SD コマンドが準拠する POSIX の layout_version を指定します。サポートされている値は、"1.0" (デフォルト値) および "0.8" です。

SD オブジェクトおよび属性構文は、『IEEE POSIX 1387.2 Software Administration』 標準の layout_version 1.0 仕様に準拠します。SD コマンドは、まだ以前のレイアウトバージョンに対応するキーワード名 layout_version=0.8 も受け入れますが、これを使用するのは、以前のバージョンの SD によって読み取り可能な配布媒体を作成するためだけにしてください。

詳細については、sd(5) の layout_version オプションを参照してください。

リストするオブジェクトの level を指定します。

サポートされているソフトウェアのレベルは、次のとおりです。

サポートされているデボおよびルートレベルは、次のとおりです。

-a と -v オプションがどちらも指定されない場合に、各オブジェクトについてリストする属性を定義します。 one_liner 定義に含める各属性は「タブ」または「スペース」で区切って指定します。 one_liner 定義には任意の属性を含めることができます。あるオブジェクトに特定の属性が存在しない場合、その属性は通知なしで単に無視されます。例えば、description 属性はプロダクト、サブプロダクト、およびファイルセットに対して有効ですが、architecture 属性はプロダクトにのみ有効です。

-l patch オプションを実行した場合、および、-a または -v オプションを指定しない場合に、リストされる各オブジェクトに対して表示される属性を指定します。デフォルトの表示属性は、title および patch_state です。

デーモンが従い、他のコマンドがデーモンと接続するために使用するプロトコルシーケンスおよびエンドポイントを定義します。 あるプロトコルシーケンスで接続に失敗した場合、次のプロトコルシーケンスが試されます。 SD はほとんどのプラットフォームで tcp (ncacn_ip_tcp:[2121]) と udp (ncadg_ip_udp:[2121]) の両方のプロトコルシーケンスをサポートします。 詳細については、sd(5) マンページ (コマンド行で man 5 sd と入力) を参照してください。

通信のタイムアウトの相対的な長さです。これは 0 〜 9 の範囲の値で、 DCE RPC によって解釈されます。値が大きいほど時間は長くなります。ネットワークが低速だったり混雑している場合に大きな値を指定する必要があります。小さい値を指定すると、停止中のホストや swagentd を実行していないホストに対する接続試行をより速く検知することが可能になります。各値が表す秒数は、それぞれ １ つ前の値が表す秒数の約 ２ 倍になります。5 という値は、ncadg_ip_udp では約 30 秒に相当します。このオプションは、ncacn_ip_tcp プロトコルシーケンスを使用している場合、特に影響を与えない可能性があります。

SD の非特権モードを制御します。実行ユーザーがスーパーユーザーの場合には、このオプションは無視されます (true とみなします)。

デフォルト値の true に設定すると、SD の操作は通常どおりに実行されます。つまり、操作のパーミッションはローカルのスーパーユーザーに与えられるか、SD ACL によって設定されます (ACL の詳細については、swacl(1M) を参照してください)。

false に設定すると、実行ユーザーがローカルユーザーでかつスーパーユーザーではない ときに、非特権モードで実行されます。

SD の非特権モードは、設計とパッケージ化が特別に行われるアプリケーションを管理するときにのみ使用するためのものです。 HP-UX オペレーティングシステムまたはそのパッチの管理には、このモードを使用できません。非特権の SD の詳細については、http://docs.hp.com/ja にある『 Software Distributor 管理者ガイド』 を参照してください。

また、admin_directory オプションおよび installed_software_catalog オプションを参照してください。

修正用パッチを swlist の コマンドライン 出力に表示するか、表示しないかを設定します。デフォルトの状態である false では、ユーザーが修正用パッチに対して swlist を実行した場合であっても、出力には表示されません。このオプションを true に設定すると、修正用パッチを出力に表示できます。このオプションはコマンドラインからの swlist でのみ使用できます。 swlist -i による対話型セッションでは、オプションに関わらず修正用パッチが表示されます。

target_selections の指定がない場合に、ローカルホスト上のデフォルトの target_directory を、コマンドの target_selection として選択します。

デフォルトの software_selections を定義します。このオプションにデフォルト値はありません。複数のソフトウェアセレクションがある場合は、空白で区切って指定しなければなりません。

GUI 上でソフトウェア表示のデフォルトレベルとして使用するソフトウェアビューを指定します。この値として指定できるのは、all_bundles、products またはバンドルカテゴリタグ (そのカテゴリのバンドルのみを表示するように指定) です。

デフォルトの target_selections を定義します。このオプションにデフォルト値はありません (上記の select_local を参照)。複数のターゲットセレクションがある場合は、空白で区切って指定しなければなりません。

属性値の表示方法を制御します。

メッセージの表示で使用する言語を決定します。LANG が指定されていないか、空白の文字列が設定されている場合、デフォルトの値 C を使用します。詳細については、lang(5) を参照してください。

注記: SD エージェントおよびデーモンログメッセージで表示される言語は、システム設定変数スクリプト /etc/rc.config.d/LANG で設定されます。例えば、エージェントおよびデーモンログメッセージを日本語で表示するには、/etc/rc.config.d/LANG を LANG=ja_JP.SJIS または LANG=ja_JP.eucJP に設定します。

LANG 環境変数または LC_ で始まる環境変数の設定値で指示されているロケールカテゴリのすべての値よりも優先して使用するロケールを決定します。

テキストデータのバイトシーケンスを文字としてどのように解釈するかを決定します (例えば、ベンダー定義の属性の値が単一バイト文字とマルチバイト文字のどちらであるかなど)。

メッセージを書き込む際の言語を決定します。

swlist で表示される日付のフォーマット ( create_date と mod_date) を決定します。 日付と時刻を stdout、stderr および logging に出力する際にすべてのユーティリティで使用されます。

日付と時刻を表示する際に使用するタイムゾーンを決定します。