| Current File : //usr/share/man/ja_JP.UTF-8/man1/pkgrepo.1 |
'\" te
.\" Copyright (c) 2007, 2015, Oracle and/or its affiliates.All rights reserved.
.TH pkgrepo 1 "2015 年 5 月 26 日" "SunOS 5.11" "ユーザーコマンド"
.SH 名前
pkgrepo \- Image Packaging System リポジトリ管理ユーティリティー
.SH 形式
.LP
.nf
/usr/bin/pkgrepo create [--version \fIver\fR] \fIuri_or_path\fR
.fi
.LP
.nf
/usr/bin/pkgrepo add-publisher -s \fIrepo_uri_or_path\fR
\fIpublisher\fR \&.\&.\&.
.fi
.LP
.nf
/usr/bin/pkgrepo remove-publisher [-n] [--synchronous]
-s \fIrepo_uri_or_path\fR \fIpublisher\fR \&.\&.\&.
.fi
.LP
.nf
/usr/bin/pkgrepo get [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]\&.\&.\&.
-s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]\&.\&.\&.
[\fIsection/property\fR \&.\&.\&.]
.fi
.LP
.nf
/usr/bin/pkgrepo info [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]\&.\&.\&.
-s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]\&.\&.\&.
.fi
.LP
.nf
/usr/bin/pkgrepo list [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]\&.\&.\&.
-s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]\&.\&.\&.
[\fIpkg_fmri_pattern\fR \&.\&.\&.]
.fi
.LP
.nf
/usr/bin/pkgrepo contents [-m]
[-t \fIaction_name\fR[,\fIaction_name\fR]\&.\&.\&.]\&.\&.\&. -s \fIrepo_uri_or_path\fR
[--key \fIssl_key\fR --cert \fIssl_cert\fR]\&.\&.\&. [\fIpkg_fmri_pattern\fR\&.\&.\&.]
.fi
.LP
.nf
/usr/bin/pkgrepo rebuild [-p \fIpublisher\fR]\&.\&.\&.
-s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]\&.\&.\&.
[--no-catalog] [--no-index]
.fi
.LP
.nf
/usr/bin/pkgrepo refresh [-p \fIpublisher\fR]\&.\&.\&.
-s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]\&.\&.\&.
[--no-catalog] [--no-index]
.fi
.LP
.nf
/usr/bin/pkgrepo remove [-n] [-p \fIpublisher\fR]\&.\&.\&.
-s \fIrepo_uri_or_path\fR \fIpkg_fmri_pattern\fR \&.\&.\&.
.fi
.LP
.nf
/usr/bin/pkgrepo set [-p \fIpublisher\fR]\&.\&.\&. -s \fIrepo_uri_or_path\fR
\fIsection/property\fR=[\fIvalue\fR] \&.\&.\&.
.fi
.LP
.nf
/usr/bin/pkgrepo set [-p \fIpublisher\fR]\&.\&.\&. -s \fIrepo_uri_or_path\fR
\fIsection/property\fR=([\fIvalue\fR]) \&.\&.\&.
.fi
.LP
.nf
/usr/bin/pkgrepo verify [-p \fIpublisher\fR]\&.\&.\&.
-s \fIrepo_uri_or_path\fR
.fi
.LP
.nf
/usr/bin/pkgrepo fix [-v] [-p \fIpublisher\fR]\&.\&.\&.
-s \fIrepo_uri_or_path\fR
.fi
.LP
.nf
/usr/bin/pkgrepo help
.fi
.LP
.nf
/usr/bin/pkgrepo version
.fi
.SH 機能説明
.sp
.LP
\fBpkgrepo\fR を使用すると、\fBpkg\fR(5) パッケージリポジトリの作成および管理を行うことができます。パッケージリポジトリは、\fBpkg\fR や、\fBpkgsend\fR または \fBpkgrecv\fR などの公開クライアントがパッケージデータを格納したり取得したりできるようにするための、定義済みの一連のディレクトリおよびファイルです。さらに、パッケージリポジトリへのネットワークベースのアクセスが必要な場合、\fBpkg\&.depotd\fR は、クライアントにパッケージデータを格納したり取得したりするためのリポジトリへのアクセスを提供できます。
.SH オプション
.sp
.LP
サポートしているオプションは、次のとおりです。
.sp
.ne 2
.mk
.na
\fB\fB-?\fR\fR
.ad
.br
.na
\fB\fB--help\fR\fR
.ad
.br
.sp .6
.RS 4n
使用方法に関するメッセージを表示します。
.RE
.SH サブコマンド
.sp
.LP
サポートされているサブコマンドは次のとおりです。
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo create\fR [\fB--version\fR \fIver\fR] \fIuri_or_path\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された場所に \fBpkg\fR(5) リポジトリを作成します。
.sp
このサブコマンドは、ファイルシステムベースのリポジトリでのみ使用できます。
.sp
.ne 2
.mk
.na
\fB\fB--version\fR\fR
.ad
.br
.sp .6
.RS 4n
指定されたバージョンと互換性がある形式でリポジトリを作成します。デフォルトでは、バージョン 4 のリポジトリが作成されます。サポートされるバージョンは次のとおりです。
.sp
.ne 2
.mk
.na
\fB3\fR
.ad
.RS 5n
.rt
1 つのパブリッシャー、カタログバージョン 1、および検索バージョン 1 でのパッケージの格納をサポートします。
.RE
.sp
.ne 2
.mk
.na
\fB4\fR
.ad
.RS 5n
.rt
複数のパブリッシャー、カタログバージョン 1、および検索バージョン 1 でのパッケージの格納をサポートします。
.RE
.RE
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo add-publisher\fR \fB-s\fR \fIrepo_uri_or_path\fR \fIpublisher\fR \&.\&.\&.\fR
.ad
.br
.sp .6
.RS 4n
指定された発行元をリポジトリに追加します。新しいパブリッシャーにパッケージや内容は含まれていません。
.sp
このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
.sp
.ne 2
.mk
.na
\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
.RE
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo remove-publisher\fR [\fB-n\fR] [\fB--synchronous\fR] \fB-s\fR \fIrepo_uri_or_path\fR \fIpublisher\fR \&.\&.\&.\fR
.ad
.br
.sp .6
.RS 4n
指定されたパブリッシャーをリポジトリから削除します。指定されたパブリッシャーのすべてのパッケージとすべてのほかのデータを削除します。
.sp
デフォルトパブリッシャーが削除され、リポジトリ内にパブリッシャーが 1 つだけ残った場合は、その残りのパブリッシャーがデフォルトになります。リポジトリの \fBpublisher/prefix\fR プロパティーは、その残りのパブリッシャーに設定されます。
.sp
デフォルトパブリッシャーが削除され、リポジトリ内に複数のパブリッシャーが残った場合、またはリポジトリ内の最後のパブリッシャーが削除された場合、\fBpublisher/prefix\fR プロパティーは未設定になります。
.sp
このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
.sp
.ne 2
.mk
.na
\fB\fB-n\fR\fR
.ad
.br
.sp .6
.RS 4n
パブリッシャーの変更は行わずに試しに操作を実行します。終了する前に、パブリッシャーごとに削除されるパッケージの数が表示されます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
.RE
.sp
.ne 2
.mk
.na
\fB\fB--synchronous\fR\fR
.ad
.br
.sp .6
.RS 4n
操作が完了するのを待ってから戻ります。このオプションが指定されなかった場合、このコマンドはただちに戻りますが、パブリッシャーはバックグラウンドで非同期的に削除されます。
.RE
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo get\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]\&.\&.\&. [\fIsection/property\fR \&.\&.\&.]\fR
.ad
.br
.sp .6
.RS 4n
リポジトリまたはその発行元のプロパティー情報を表示します。
.sp
デフォルトでは、各プロパティーとその値が個別の行に出力されます。空の ASCII 文字列値は、二重引用符 (\fB""\fR) のペアで表されます。ASCII 文字列値内の次の Bourne シェルのメタキャラクタと、改行、スペース、およびタブは、バックスラッシュ文字 (\fB\\fR) でエスケープする必要があります。
.sp
.sp
.in +2
.nf
; & ( ) | ^ < > \e " \' `
.fi
.in -2
.sp
発行元とリポジトリプロパティーの表示例については、「使用例」セクションを参照してください。
.sp
プロパティーのリスト、および各プロパティーの目的と値については、下の \fBset\fR サブコマンドを参照してください。
.sp
.ne 2
.mk
.na
\fB\fB-F\fR \fIformat\fR\fR
.ad
.br
.sp .6
.RS 4n
代替出力形式を指定します。\fIformat\fR の値は、\fBtsv\fR (Tab Separated Values)、\fBjson\fR (単一行としての JavaScript Object Notation)、または \fBjson-formatted\fR (読みやすい形式にされた JavaScript Object Notation) にできます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-H\fR \fR
.ad
.br
.sp .6
.RS 4n
一覧からヘッダーを省略します。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIpublisher\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された発行元のプロパティー情報を表示します。特殊な値 \fBall\fR により、すべてのパブリッシャーのプロパティーが表示されます。このオプションは複数回指定できます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
.RE
.sp
.ne 2
.mk
.na
\fB\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR\fR
.ad
.br
.sp .6
.RS 4n
\fB--key\fR オプションは、HTTPS リポジトリからのパッケージ取得に使用するクライアント SSL キーファイルを指定するために使用します。\fB--cert\fR オプションは、HTTPS リポジトリからのパッケージ取得に使用するクライアント SSL 証明書ファイルを指定するために使用します。このオプションのペアは複数回指定できます。
.RE
.sp
.ne 2
.mk
.na
\fB\fIsection/property\fR\fR
.ad
.br
.sp .6
.RS 4n
\fB publisher/prefix\fR や \fBrepository/version\fR などの、指定されたプロパティーの値のみを表示します。プロパティーの完全な一覧については、\fB set\fR サブコマンドを参照してください。
.RE
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo info\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]\&.\&.\&.\fR
.ad
.br
.sp .6
.RS 4n
リポジトリで認識されているパッケージ発行元のリストを表示します。このリストには、パブリッシャーごとのパッケージの数、パブリッシャーのパッケージデータが最後に更新された日時、およびパブリッシャーのパッケージデータのステータス (現在処理されているかどうかなど) が含まれます。
.sp
.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIpublisher\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された発行元のデータのみを表示します。指定されていない場合は、すべてのパブリッシャーのデータが表示されます。このオプションは複数回指定できます。
.RE
ほかのすべてのオプションの説明については、前述の \fBpkgrepo get\fR コマンドを参照してください。
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo list\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]\&.\&.\&. [\fIpkg_fmri_pattern\fR \&.\&.\&.]\fR
.ad
.br
.sp .6
.RS 4n
指定された \fIpkg_fmri_pattern\fR にマッチする \fIrepo_uri_or_path\fR リポジトリのパッケージを一覧表示します。パターンが指定されない場合、リポジトリのすべてのパッケージが一覧表示されます。\fIpkg_fmri_pattern\fR パターンには、\fBglob\fR(3C) 形式のワイルドカードとして 1 つ以上のパッケージと一致する \fB?\fR および \fB*\fR 文字を含めることができます。
.sp
デフォルトの出力では、最初の列にパッケージのパブリッシャーの名前が含まれます。2 番目の列にはパッケージの名前が含まれます。3 番目の列には、パッケージのステータスを示すフラグが含まれます。ステータス列の \fBo\fR の値は、パッケージが廃止されていることを示します。ステータス列の \fBr\fR の値は、パッケージの名前が変更されたことを示します (廃止の形態の 1 つです)。4 番目の列には、パッケージのリリースおよびブランチのバージョンが含まれます。リリースバージョンとブランチバージョンについては、\fBpkg\fR(5) を参照してください。
.sp
.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIpublisher\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された発行元のパッケージのみを表示します。指定されていない場合は、すべてのパブリッシャーのパッケージが一覧表示されます。このオプションは複数回指定できます。
.RE
ほかのすべてのオプションの説明については、前述の \fBpkgrepo get\fR コマンドを参照してください。
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo contents\fR [\fB-m\fR [\fB-t\fR \fIaction_name\fR[,\fIaction_name\fR]\&.\&.\&.]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]\&.\&.\&. [\fIpkg_fmri_pattern\fR\&.\&.\&.]\fR
.ad
.br
.sp .6
.RS 4n
\fIrepo_uri_or_path\fR リポジトリ内のすべてのパッケージを一覧表示します。\fIpkg_fmri_pattern\fR が指定された場合は、リポジトリ内の一致するすべてのパッケージの内容 (アクション属性) を表示します。
.sp
.sp
.ne 2
.mk
.na
\fB\fB-m\fR\fR
.ad
.br
.sp .6
.RS 4n
指定されたパッケージ内のアクションのすべての属性を表示します。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-t\fR \fIaction_name\fR\fR
.ad
.br
.sp .6
.RS 4n
指定されたパッケージ内の指定されたアクションのみを表示します。\fB-t\fR オプションは複数回指定できます。または、アクション名をコンマで区切ることにより、1 つの \fB-t\fR オプションの引数として複数のアクションを指定できます。\fIaction_name\fR の値は、\fBpkg\fR(5) のマニュアルページの「アクション」に一覧表示されているアクションのいずれか (\fBfile\fR、\fBdir\fR、\fBdriver\fR、\fBdepend\fR、\fBset\fR など) です。
.RE
ほかのすべてのオプションの説明については、前述の \fBpkgrepo get\fR コマンドを参照してください。
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo rebuild\fR [\fB-p\fR \fIpublisher\fR]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]\&.\&.\&. [\fB--no-catalog\fR] [\fB--no-index\fR]\fR
.ad
.br
.sp .6
.RS 4n
リポジトリ内に見つかったすべてのカタログ、検索、およびその他のキャッシュされた情報を破棄し、それをリポジトリの現在の内容に基づいて再作成します。
.sp
.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIpublisher\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された発行元についてのみ操作を実行します。指定されていない場合や、特殊な値 \fBall\fR が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB--no-catalog\fR\fR
.ad
.br
.sp .6
.RS 4n
パッケージデータを再構築しません。
.RE
.sp
.ne 2
.mk
.na
\fB\fB--no-index\fR\fR
.ad
.br
.sp .6
.RS 4n
検索インデックスを再構築しません。
.RE
ほかのすべてのオプションの説明については、前述の \fBpkgrepo get\fR コマンドを参照してください。
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo refresh\fR [\fB-p\fR \fIpublisher\fR]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]\&.\&.\&. [\fB--no-catalog\fR] [\fB--no-index\fR] \fR
.ad
.br
.sp .6
.RS 4n
リポジトリ内に見つかった新しいパッケージをすべてカタログ化し、すべての検索インデックスを更新します。これは、遅延公開 (\fBpkgsend\fR の \fB--no-catalog\fR または \fB--no-index\fR オプション) で使用されることを目的にしています。
.sp
.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIpublisher\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された発行元についてのみ操作を実行します。指定されていない場合や、特殊な値 \fBall\fR が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB--no-catalog\fR\fR
.ad
.br
.sp .6
.RS 4n
新しいパッケージを追加しません。
.RE
.sp
.ne 2
.mk
.na
\fB\fB--no-index\fR\fR
.ad
.br
.sp .6
.RS 4n
検索インデックスを更新しません。
.RE
ほかのすべてのオプションの説明については、前述の \fBpkgrepo get\fR コマンドを参照してください。
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo remove\fR [\fB-n\fR] [\fB-p\fR \fIpublisher\fR]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR \fIpkg_fmri_pattern\fR \&.\&.\&.\fR
.ad
.br
.sp .6
.RS 4n
リポジトリから、指定された \fIpkg_fmri_pattern\fR パターンに一致するパッケージ (これらのパッケージが参照している、ほかのどのパッケージでも使用されていないすべてのファイルを含む) を削除します。\fIpkg_fmri_pattern\fR パターンには、\fBglob\fR(3C) 形式のワイルドカードとして 1 つ以上のパッケージと一致する \fB?\fR および \fB*\fR 文字を含めることができます。
.sp
.LP
注 -
.sp
.RS 2
.sp
.LP
関連するパブリッシャーのすべての検索インデックスデータが削除されます。
.RE
このサブコマンドは、ファイルシステムベースのリポジトリでのみ使用できます。
.LP
注意 -
.sp
.RS 2
.sp
.LP
この操作は元に戻せません。また、ほかのクライアントがそのリポジトリにアクセスしている間に使用すべきではありません。使用すると、それらのクライアントが取得操作中に失敗する可能性があります。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-n\fR\fR
.ad
.br
.sp .6
.RS 4n
パッケージの変更は行わずに試しに操作を実行します。終了する前に、削除されるパッケージのリストが表示されます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIpublisher\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された発行元の一致するパッケージのみを削除します。指定されていない場合は、すべてのパブリッシャーの一致するパッケージがすべて削除されます。このオプションは複数回指定できます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
.RE
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo set\fR [\fB-p\fR \fIpublisher\fR]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR \fIsection/property\fR=[\fIvalue\fR] \&.\&.\&.\fR
.ad
.br
.na
\fB\fBpkgrepo set\fR [\fB-p\fR \fIpublisher\fR]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR \fIsection/property\fR=([\fIvalue\fR]) \&.\&.\&.\fR
.ad
.br
.sp .6
.RS 4n
リポジトリまたは発行元の指定されたプロパティーの値を設定します。
.sp
このサブコマンドは、ファイルシステムベースのリポジトリでのみ使用できます。
.sp
.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIpublisher\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された発行元のプロパティーデータのみを設定します。パブリッシャーがまだ存在しない場合は、追加されます。特殊な値 \fBall\fR を使用すると、すべての発行元のプロパティーを設定できます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
.RE
プロパティーと値は、次のいずれかの形式を使用して指定できます。
.sp
.sp
.ne 2
.mk
.na
\fB\fIsection\fR/\fIproperty\fR=\fR
.ad
.br
.sp .6
.RS 4n
プロパティー値をクリアーします。
.RE
.sp
.ne 2
.mk
.na
\fB\fIsection\fR/\fIproperty\fR=\fIvalue\fR\fR
.ad
.br
.sp .6
.RS 4n
プロパティー値を指定された値に置き換えます。
.RE
.sp
.ne 2
.mk
.na
\fB\fIsection\fR/\fIproperty\fR=(\fIvalue1\fR \fIvalue2\fR \fIvalueN\fR)\fR
.ad
.br
.sp .6
.RS 4n
プロパティー値を値のリストに置き換えます。
.RE
リポジトリバージョン 3 および 4 の場合は、リポジトリの次のプロパティーを設定できます。
.sp
.sp
.ne 2
.mk
.na
\fB\fBpublisher/prefix\fR\fR
.ad
.br
.sp .6
.RS 4n
デフォルトのパブリッシャーの名前を表す文字列。最初の文字は a-z、A-Z、または 0-9 である必要があります。文字列の残りの部分には、文字 0-9、-、\&.、a-z、および A-Z のみを含めることができます。この値は、複数のパブリッシャーのパッケージが存在するとき、またはパッケージがリポジトリに公開されているが、パブリッシャーが指定されていないときに使用されるべきパブリッシャーを示します。
.RE
リポジトリバージョン 3 および 4 の場合は、リポジトリ内の個々のパブリッシャーの次のプロパティーを設定できます。これらのプロパティーを設定するときは、\fB-p\fR オプションを使用して 1 つ以上のパブリッシャーを指定します。
.sp
.sp
.ne 2
.mk
.na
\fB\fBpublisher/alias\fR\fR
.ad
.br
.sp .6
.RS 4n
リポジトリの構成データを使用してパブリッシャーを追加するときにクライアントが使用すべきデフォルトの別名を表す文字列。最初の文字は a-z、A-Z、または 0-9 である必要があります。文字列の残りの部分には、文字 0-9、-、\&.、a-z、および A-Z のみを含めることができます。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/check-certificate-revocation\fR\fR
.ad
.br
.sp .6
.RS 4n
証明書が失効したかどうかを検査する boolean。このプロパティーを \fBTrue\fR に設定すると、\fBpkgrepo verify\fR および \fBpkgrepo fix\fR コマンドは、署名検証のために使用される証明書の CRL 配布ポイントへのアクセスを試み、発行時よりもあとに証明書が失効していないかどうかを調べます。デフォルト値は \fBFalse\fR です。このプロパティーは、リポジトリの内容を検証するために、\fBverify\fR および \fBfix\fR サブコマンドによってのみ使用されます。このプロパティーはクライアント設定には影響しません。この値は、対応する \fBpkg\fR(1) プロパティー値と同じである必要があります。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/collection_type\fR\fR
.ad
.br
.sp .6
.RS 4n
このリポジトリで提供されるパッケージのタイプを示す値 \fBcore\fR または \fBsupplemental\fR を持つことができます。
.sp
\fBcore\fR タイプは、このリポジトリにはリポジトリ内のパッケージによって宣言されたすべての依存関係が含まれていることを示します。\fBcore\fR タイプは主に、オペレーティングシステムリポジトリに使用されます。
.sp
\fBsupplemental\fR タイプは、このリポジトリには、別のリポジトリ内に配置されているパッケージに依存するか、またはそれらのパッケージとともに使用されるためのパッケージが含まれていることを示します。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/description\fR\fR
.ad
.br
.sp .6
.RS 4n
リポジトリの目的と内容を説明した標準テキストの段落。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/detailed_url\fR\fR
.ad
.br
.sp .6
.RS 4n
リポジトリに関する追加情報を提供するドキュメント (Web ページなど) の場所を表す URI。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/legal_uris\fR\fR
.ad
.br
.sp .6
.RS 4n
リポジトリに関する追加の使用条件情報を提供するドキュメントの場所 (URI) のリスト。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/mirrors\fR\fR
.ad
.br
.sp .6
.RS 4n
リポジトリのパッケージ内容のコピーを含むが、パッケージのメタデータは含まないリポジトリの場所 (URI) のリスト。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/name\fR\fR
.ad
.br
.sp .6
.RS 4n
リポジトリの名前を含む標準テキスト文字列。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/origins\fR\fR
.ad
.br
.sp .6
.RS 4n
リポジトリのパッケージのメタデータと内容の完全なコピーを含むリポジトリの場所 (URI) のリスト。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/refresh_seconds\fR\fR
.ad
.br
.sp .6
.RS 4n
クライアントが、更新されたパッケージデータがあるかどうかを調べるためにリポジトリをチェックする際に、各更新チェックのあとに待つべき秒数を表す整数値。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/registration_uri\fR\fR
.ad
.br
.sp .6
.RS 4n
リポジトリへのアクセスのための資格を取得するために使用する必要のあるリソースの場所を表す URI。この 1 つの例に、登録 Web ページがあります。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/related_uris\fR\fR
.ad
.br
.sp .6
.RS 4n
ユーザーが関心を持っている可能性があるパッケージを含むリポジトリの場所 (URI) のリスト。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/signature-required-names\fR\fR
.ad
.br
.sp .6
.RS 4n
パッケージの署名の検証中に、証明書の共通名として表示される必要のある名前の一覧です。このプロパティーは、リポジトリの内容を検証するために、\fBverify\fR および \fBfix\fR サブコマンドによってのみ使用されます。このプロパティーはクライアント設定には影響しません。これらの値は、対応する \fBpkg\fR(1) プロパティー値と同じである必要があります。
.RE
.sp
.ne 2
.mk
.na
\fB\fBrepository/trust-anchor-directory\fR\fR
.ad
.br
.sp .6
.RS 4n
このリポジトリ内のパッケージのトラストアンカーを含むディレクトリの絶対パス名。指定しない場合、\fB/etc/certs/CA/\fR が使用されます。このプロパティーは、リポジトリの内容を検証するために、\fBverify\fR および \fBfix\fR サブコマンドによってのみ使用されます。このプロパティーはクライアント設定には影響しません。この値は、対応する \fBpkg\fR(1) プロパティー値と同じである必要があります。
.RE
ここには記載されていないが \fBget\fR サブコマンドの出力に一覧表示されるプロパティーは、内部使用のために予約されているため、設定しないようにしてください。
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo verify\fR [\fB-p\fR \fIpublisher\fR]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR\fR
.ad
.br
.sp .6
.RS 4n
パッケージリポジトリの内容の次の属性が正しいことを検証します。
.sp
.RS +4
.TP
.ie t \(bu
.el o
ファイルのチェックサム
.RE
.RS +4
.TP
.ie t \(bu
.el o
ファイルのアクセス権
.sp
\fBpkg5srv\fR ユーザーがリポジトリの内容を読み取ることができることを確認するために、リポジトリへのパスも検査されます。この検査は、\fBsvc:/application/pkg/server\fR サービスを使用するか、システムに非大域ゾーンがある場合に \fBsvc:/application/pkg/system-repository\fR サービスを使用することによって使用できるようになるリポジトリに対して必要になることがあります。
.RE
.RS +4
.TP
.ie t \(bu
.el o
パッケージマニフェストのアクセス権
.RE
.RS +4
.TP
.ie t \(bu
.el o
パッケージマニフェストの内容
.RE
.RS +4
.TP
.ie t \(bu
.el o
パッケージ署名
.sp
パッケージマニフェスト署名は、\fBrepository/signature-required-names\fR、\fBrepository/trust-anchor-directory\fR、および \fBrepository/check-certificate-revocation \fR プロパティーの値に基づいて計算されます。
.RE
エラーは \fBstdout\fR に出力されます。何らかのエラーが出力された場合、\fBpkgrepo\fR コマンドはゼロ以外の戻りコードで終了します。
.sp
このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIpublisher\fR\fR
.ad
.br
.sp .6
.RS 4n
指定されたパブリッシャーについてのみ操作を実行します。パブリッシャーが指定されていない場合や、特殊な値 \fBall\fR が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
.RE
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo fix\fR [\fB-v\fR] [\fB-p\fR \fIpublisher\fR]\&.\&.\&. \fB-s\fR \fIrepo_uri_or_path\fR\fR
.ad
.br
.sp .6
.RS 4n
最初にリポジトリを検証し、無効なリポジトリの内容をリポジトリ内の検疫ディレクトリに移動することによって、リポジトリの内容を修正します。
.sp
リポジトリエラーが見つかった場合は、リポジトリの再構築が自動的に実行されます。エラーが見つかった場合は、メッセージが \fBstdout\fR に出力され、リポジトリ内容を復元するために \fBpkgsend\fR(1) または \fBpkgrecv\fR(1) を使用して再インポートする必要があるパッケージが示されます。
.sp
このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
.sp
.ne 2
.mk
.na
\fB\fB-v\fR\fR
.ad
.br
.sp .6
.RS 4n
リポジトリの検証時に見つかったエラーを詳述する出力が含まれます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-p\fR \fIpublisher\fR\fR
.ad
.br
.sp .6
.RS 4n
指定されたパブリッシャーについてのみ操作を実行します。パブリッシャーが指定されていない場合や、特殊な値 \fBall\fR が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。
.RE
.sp
.ne 2
.mk
.na
\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
.ad
.br
.sp .6
.RS 4n
指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
.RE
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo help\fR\fR
.ad
.br
.sp .6
.RS 4n
使用方法に関するメッセージを表示します。
.RE
.sp
.ne 2
.mk
.na
\fB\fBpkgrepo version\fR\fR
.ad
.br
.sp .6
.RS 4n
\fBpkg\fR(5) システムのバージョンを識別する一意の文字列を表示します。\fBversion\fR 操作によって生成される値はソート可能ではないため、等しいかどうかを超えて安全に比較することはできません。
.RE
.SH 使用例
.LP
\fB例 1\fR パッケージリポジトリを作成する
.sp
.in +2
.nf
$ \fBpkgrepo create /my/repository\fR
.fi
.in -2
.sp
.LP
\fB例 2\fR 情報を表示する
.sp
.LP
パブリッシャーのサマリーと、リポジトリ内のパッケージの数を表示します。
.sp
.in +2
.nf
$ \fBpkgrepo info -s /my/repository\fR
PUBLISHER PACKAGES STATUS UPDATED
example\&.com 5 online 2011-07-22T18:09:09\&.769106Z
$ \fBpkgrepo info -s http://pkg\&.oracle\&.com/solaris/release/\fR
PUBLISHER PACKAGES STATUS UPDATED
solaris 3941 online 2010-11-12T19:24:25\&.967246Z
.fi
.in -2
.sp
.LP
\fB例 3\fR カタログと検索データを再構築する
.sp
.LP
リポジトリのカタログと検索データを再構築します。
.sp
.in +2
.nf
$ \fBpkgrepo rebuild -s /my/repository\fR
.fi
.in -2
.sp
.LP
\fB例 4\fR カタログと検索データを再表示する
.sp
.LP
リポジトリのカタログと検索データを再表示します。
.sp
.in +2
.nf
$ \fBpkgrepo refresh -s /my/repository\fR
$ \fBpkgrepo refresh -s http://example\&.com/repository\fR
.fi
.in -2
.sp
.LP
\fB例 5\fR すべてのリポジトリプロパティーを表示する
.sp
.in +2
.nf
$ \fBpkgrepo get -s /export/repoSolaris11\fR
SECTION PROPERTY VALUE
publisher prefix solaris
repository description Local\e copy\e of\e the\e Oracle\e Solaris\e 11\e repository
repository name Oracle\e Solaris\e 11
repository version 4
$ \fBpkgrepo get -s http://pkg\&.oracle\&.com/solaris/release/\fR
SECTION PROPERTY VALUE
deployment content s11_11-11
deployment pubdate 20111102T222051Z
publisher prefix solaris
repository version 4
.fi
.in -2
.sp
.LP
\fB例 6\fR すべてのパブリッシャープロパティーを表示する
.sp
.in +2
.nf
$ \fBpkgrepo get -s http://pkg\&.oracle\&.com/solaris/release/ -p all\fR
PUBLISHER SECTION PROPERTY VALUE
solaris publisher alias
solaris publisher prefix solaris
solaris repository collection-type core
solaris repository description This\e repository\e serves\e the\e Oracle\e
Solaris\e 11\e Package\e repository\&.
solaris repository legal-uris ()
solaris repository mirrors (http://pkg-cdn1\&.oracle\&.com/solaris\&.release/)
solaris repository name Oracle\e Solaris\e 11\e Package\e Repository
solaris repository origins ()
solaris repository refresh-seconds
solaris repository registration-uri ""
solaris repository related-uris ()
.fi
.in -2
.sp
.LP
\fB例 7\fR デフォルトのパブリッシャーを設定する
.sp
.in +2
.nf
$ \fBpkgrepo set -s /my/repository publisher/prefix=example\&.com\fR
.fi
.in -2
.sp
.LP
\fB例 8\fR パブリッシャープロパティーを設定する
.sp
.in +2
.nf
$ \fBpkgrepo set -s /my/repository -p example\&.com \e\fR
\fBrepository/origins=http://example\&.com/repository\fR
.fi
.in -2
.sp
.LP
\fB例 9\fR 新しいパブリッシャーをリポジトリに追加する
.sp
.in +2
.nf
$ \fBpkgrepo add-publisher -s /my/repository example\&.com\fR
.fi
.in -2
.sp
.SH 終了ステータス
.sp
.LP
次の終了ステータスが返されます。
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.RS 6n
.rt
コマンドが成功しました。
.RE
.sp
.ne 2
.mk
.na
\fB\fB1\fR\fR
.ad
.RS 6n
.rt
エラーが発生した。
.RE
.sp
.ne 2
.mk
.na
\fB\fB2\fR\fR
.ad
.RS 6n
.rt
無効なコマンド行オプションが指定された。
.RE
.sp
.ne 2
.mk
.na
\fB\fB3\fR\fR
.ad
.RS 6n
.rt
複数の操作が要求されましたが、それらの一部のみが成功しました。
.RE
.sp
.ne 2
.mk
.na
\fB\fB4\fR\fR
.ad
.RS 6n
.rt
変更は行われませんでした。処理がありません。
.RE
.sp
.ne 2
.mk
.na
\fB\fB99\fR\fR
.ad
.RS 6n
.rt
予期しない例外が発生しました。
.RE
.SH 属性
.sp
.LP
次の属性については、\fBattributes\fR(5) を参照してください。
.sp
.TS
tab(
) box;
cw(2.75i) |cw(2.75i)
lw(2.75i) |lw(2.75i)
.
属性タイプ
属性値
_
使用条件
\fBpackage/pkg\fR
_
インタフェースの安定性
不確実
.TE
.SH 関連項目
.sp
.LP
\fBpkg\fR(1), \fBpkgrecv\fR(1), \fBpkgsend\fR(1), \fBpkg\&.depotd\fR(1M), \fBpkg\fR(5)
.sp
.LP
\fICopying and Creating Package Repositories in Oracle Solaris 11\&.3\fR
.sp
.LP
\fBhttps://java\&.net/projects/ips/pages/Home\fR
.SH 注意事項
.sp
.LP
\fBpkgrepo\fR のほとんどの操作は、パッケージアーカイブでは使用できません。パッケージアーカイブは、\fBpkgrecv\fR(1) のマニュアルページの \fB-a\fR オプションで説明されているように、通常は \fB\&.p5p\fR 拡張子を持つファイルです。パッケージアーカイブには、パッケージが含まれていますが、リポジトリ構成は含まれていません。ただし、\fBpkgrepo list\fR、\fBpkgrepo info\fR、および \fBpkgrepo contents\fR コマンドは、パッケージアーカイブに対して動作します。