i686-w64-mingw32-pkg-config - クラウドでオンライン

プログラム：

NAME

pkg-config - インストールされているライブラリに関するメタ情報を返す

SYNOPSIS

パッケージ構成 [--modversion] [--version] [--help] [--atleast-pkgconfig-version=VERSION]
[--print-errors] [--short-errors] [--silence-errors] [--errors-to-stdout] [--debug]
[--cflags] [--libs] [--libs-only-L] [--libs-only-l] [--cflags-only-I] [--libs-only-other]
[--cflags-only-other] [--variable=VARIABLENAME] [--define-
変数=VARIABLENAME=VARIABLEVALUE] [--print-variables] [--uninstalled] [--exists]
[--atleast-version=VERSION] [--exact-version=VERSION] [--max-version=VERSION] [--validate]
[--list-all] [--print-provides] [--print-requires] [--print-requires-private]
[図書館...]

DESCRIPTION

　 パッケージ構成 プログラムは、インストールされているライブラリに関する情報を取得するために使用されます。
システム。 通常、XNUMX つ以上のライブラリに対してコンパイルおよびリンクするために使用されます。 ここは
Makefile での一般的な使用シナリオ:

プログラム：program.c
cc プログラム.c $(pkg-config --cflags --libs gnomeui)

パッケージ構成 特別なメタデータ ファイルからパッケージに関する情報を取得します。 これらのファイル
パッケージにちなんで名付けられており、 .pc 拡大。 ほとんどのシステムでは、 パッケージ構成 ルックス
in /usr/lib/pkgconfig, /usr/share/pkgconfig, /usr/local/lib/pkgconfig &
/usr/local/share/pkgconfig これらのファイルの場合。 さらに結腸も調べます。
で指定されたディレクトリの区切り (Windows ではセミコロン区切り) リスト。
PKG_CONFIG_PATH 環境変数。

で指定されたパッケージ名 パッケージ構成 コマンドラインは、
メタデータ ファイルから、 .pc 拡大。 ライブラリが複数のバージョンをインストールできる場合
同時に、各バージョンに独自の名前を付ける必要があります (たとえば、GTK 1.2 には
パッケージ名は「gtk+」ですが、GTK 2.0 は「gtk+-2.0」です)。

コマンドラインでパッケージ名を指定するだけでなく、特定のパッケージへのフルパスも指定できます。 .pc
ファイルを代わりに指定することもできます。 これにより、ユーザーは特定のクエリを直接クエリできるようになります。 .pc ファイルにソフトウェアを指定する必要があります。

OPTIONS

次のオプションがサポートされています。

--modversion
コマンドで指定されたライブラリのバージョン情報を要求します。
行が表示されます。 もし パッケージ構成 コマンドラインですべてのライブラリを見つけることができます。
各ライブラリのバージョン文字列は、XNUMX 行に XNUMX つのバージョンで標準出力に出力されます。 この中で
場合 パッケージ構成 正常に終了します。 XNUMX つ以上のライブラリが不明な場合は、 パッケージ構成
ゼロ以外のコードで終了し、標準出力の内容は未定義です。

- バージョン
のバージョンを表示します パッケージ構成 そして終了します。

--atleast-pkgconfig-version=VERSION
少なくとも指定されたバージョンの pkg-config が必要です。

- 助けて ヘルプメッセージを表示して終了します。

--印刷エラー
コマンドライン上の XNUMX つ以上のモジュールまたはその依存関係が正しくない場合、
見つかった場合、または解析中にエラーが発生した場合 .pc ファイルの場合、このオプションにより、
問題を説明するエラーが表示されます。 次のような「述語」オプションを使用すると、
「――存在する」 パッケージ構成 通常は次の場所で使用されるため、デフォルトではサイレントに実行されます。
出力内容を制御したいスクリプト。 このオプションは単独で使用できます（単に
コマンドラインでモジュールを検索中に印刷エラーが発生しました)、または他のコマンドで発生しました
オプション。 PKG_CONFIG_DEBUG_SPEW 環境変数はこのオプションをオーバーライドします。

--短いエラー
短いエラーメッセージを出力します。

--沈黙エラー
コマンドライン上の XNUMX つ以上のモジュールまたはその依存関係が正しくない場合、
見つかった場合、または aa の解析中にエラーが発生した場合 .pc ファイルの場合、このオプションは保持します
印刷による問題を説明するエラー。 次のような「述語」オプションを使用すると、
「――存在する」 パッケージ構成 通常は次の場所で使用されるため、デフォルトではサイレントに実行されます。
出力内容を制御したいスクリプト。 したがって、このオプションは次の場合にのみ役に立ちます。
デフォルトでエラーを出力する「--cflags」や「--modversion」などのオプション。 の
PKG_CONFIG_DEBUG_SPEW 環境変数はこのオプションをオーバーライドします。

-- 標準出力へのエラー
印刷エラーがある場合は、デフォルトの標準エラー出力ではなく標準出力に出力します。

- デバッグ
デバッグ情報を出力します。 これは、
PKG_CONFIG_DEBUG_SPEW 環境変数。これも「--print-errors」を有効にします。

次のオプションは、プログラムのコンパイルとリンクに使用されます。

--cflags
これにより、パッケージをコンパイルするために必要なプリプロセッサとコンパイル フラグが出力されます。
コマンド ライン (すべての依存関係のフラグを含む)。 フラグは「圧縮」されているため、
同一のフラグはそれぞれ XNUMX 回だけ表示されます。 パッケージ構成 ゼロ以外のコードで終了する場合
コマンドラインで XNUMX つ以上のパッケージのメタデータが見つかりません。

--cflags-only-I
これにより、「--cflags」の -I 部分が出力されます。 つまり、ヘッダー検索パスを定義します。
しかし他には何も指定していません。

--cflags-only-other
これにより、「--cflags-only-I」でカバーされていない「--cflags」の部分が出力されます。

--libs このオプションは「--cflags」と同じですが、リンク フラグを出力する点が異なります。 同様に
「--cflags」、重複したフラグはマージされ (適切な順序を維持)、
依存関係が出力に含まれます。

--libs-only-L
これにより、「--libs」の -L/-R 部分が出力されます。 つまり、ライブラリの検索パスを定義します。
ただし、どのライブラリとリンクするかは指定されていません。

--libs-only-l
これにより、コマンドで指定されたライブラリの「--libs」の -l 部分が出力されます。
ライン。 「--libs-only-l」と「--libs-only-L」の結合は小さくなる可能性があることに注意してください
-rdynamic などのフラグにより​​、「--libs」よりも異なります。

--libs-only-other
これにより、「--libs-only-L」および「--libs-only-」でカバーされていない「--libs」の部分が出力されます。
l」、「--pthread」など。

--variable=変数名
これは、パッケージの中で定義された変数の値を返します。 .pc ファイル。 ほとんどのパッケージ
たとえば、変数「prefix」を定義すると、次のように言えます。
$ pkg-config --variable=prefix glib-2.0
/ usr /

--define-variable=VARIABLENAME=VARIABLEVALUE
これは変数のグローバル値を設定し、任意の値をオーバーライドします。 .pc ファイル。
たとえば、ほとんどのパッケージでは変数「prefix」が定義されているため、次のように言えます。
$ pkg-config --print-errors --define-variable=prefix=/foo \
--variable=prefix glib-2.0
/ foo

--印刷変数
パッケージ内で定義されているすべての変数のリストを返します。

--アンインストール済み
通常、パッケージ「foo」をリクエストし、パッケージ「foo-uninstalled」が存在する場合、
パッケージ構成 「-uninstalled」バリアントが優先されます。 これによりコンパイル/リンクが可能になります
アンインストールされたパッケージに対して。 「--uninstalled」オプションを指定すると、 パッケージ構成
「-uninstalled」パッケージが使用されている場合は正常に戻り、また戻ります。
それ以外の場合は失敗 (false)。 (PKG_CONFIG_DISABLE_UNINSTALLED 環境
変数は保持します パッケージ構成 「-uninstalled」パッケージを暗黙的に選択しないため、
その変数が設定されている場合、それらは「foo-」のような名前を渡した場合にのみ使用されます。
アンインストール」をコマンドラインで明示的に実行します。)

-存在する

--atleast-version=バージョン

--exact-version=バージョン

--max-version=バージョン
これらのオプションは、コマンド ライン上のパッケージまたはパッケージのリストが有効かどうかをテストします。
知られている パッケージ構成、およびオプションでパッケージのバージョン番号が満たしているかどうか
特定の制約。 すべてのパッケージが存在し、指定されたバージョンを満たしている場合
制約、 パッケージ構成 正常に終了します。 それ以外の場合は、失敗して終了します。 のみ
最初の VERSION 比較オプションが受け入れられます。 このタイプの後続のオプション
無視されます。

バージョン テスト オプションを使用する代わりに、単にバージョンを指定することもできます。
各パッケージ名の後に制約を追加します。例:
$ pkg-config --exists 'glib-2.0 >= 1.3.4 libxml = 1.8.3'
エラー メッセージが必要な場合は、必ず --print-errors を使用してください。 出力オプションがない場合
に供給されています パッケージ構成, --exists が暗黙的に示されます。

- 検証
パッケージの構文をチェックします .pc 有効性を確認するためのファイル。 これは以下と同じです
--依存関係が検証されていないことを除いて存在します。 これはパッケージに役立ちます
開発者がテストするために .pc リリース前のファイル:
$ pkg-config --validate ./my-package.pc

--msvc-syntax
このオプションは Windows でのみ使用できます。 それは原因となります パッケージ構成 -l と -L を出力する
Microsoft Visual C++ コマンドライン コンパイラによって認識される形式のフラグ、 cl.
具体的には、代わりに -Lx:/some/パス 印刷します /libpath:x/some/pathそして代わりに
of -lfoo 印刷します foo.lib。 --libs 出力は、
リンカーであり、cl コマンド ラインの /link スイッチの後に配置する必要があります。

--定義プレフィックス
--dont-define-prefix
これらのオプションは、 パッケージ構成 変数の値をオーバーライドします 接頭辞
各 .pc ファイル内。 --define-prefix を使用すると、 パッケージ構成 のインストール場所を使用します
.pc ファイルを使用してプレフィックスを決定します。 --dont-define-prefix により、この動作が防止されます。
通常、デフォルトは --define-prefix です。

この機能が有効で、.pc ファイルが という名前のディレクトリで見つかった場合
pkgconfig、そのパッケージのプレフィックスは、そのパッケージの祖父母であるとみなされます。
ファイルが見つかったディレクトリと、 接頭辞 変数はそのためにオーバーライドされます
それに応じてファイルします。

.pc ファイル内の変数の値が、オーバーライドされていない元の値で始まる場合、
の値 接頭辞 変数、次にオーバーライドされた値 接頭辞 代わりに使用されます。
これにより、変数が展開されている場合でもこの機能が動作できるようになります。
.pc ファイル。

--prefix-variable=PREFIX
変数の名前を設定します。 パッケージ構成 の代わりにオーバーライドします 接頭辞 使用している場合
--define-prefix 機能。

- 静的
静的リンクに適した出力ライブラリ。 つまり、プライベートなものもすべて含まれます
出力内のライブラリ。 これは、.pc ファイル内の適切なタグ付けに依存します。そうでない場合は、
通常、出力されるライブラリの数が多すぎる場合があります。

-リスト-すべて
で見つかったすべてのモジュールをリストします。 パッケージ構成 パス。

--print-provides
指定されたパッケージが提供するすべてのモジュールをリストします。

--印刷が必要
指定されたパッケージに必要なすべてのモジュールをリストします。

--print-requires-private
指定されたパッケージが静的リンクに必要とするすべてのモジュールをリストします (--static を参照)。

ENVIRONMENT 変数

PKG_CONFIG_PATH
検索するディレクトリのコロン区切り (Windows ではセミコロン区切り) のリスト
.pc ファイルの場合。 デフォルトのディレクトリは、
パス; デフォルトは libdir/pkgconfig:データディレクトリ/pkgconfig ここで リブディレクトリ libdirです
for パッケージ構成 & データディレクトリ のデータディレクトリです パッケージ構成 取り付けたとき。

PKG_CONFIG_DEBUG_SPEW
設定すると、次の原因が発生します。 パッケージ構成 あらゆる種類のデバッグ情報とレポートを出力します。
すべてのエラー。

PKG_CONFIG_TOP_BUILD_DIR
マジック変数に設定する値 pc_top_builddir に登場する可能性があります .pc
ファイル。 環境変数が設定されていない場合は、デフォルト値「$(top_builddir)」が使用されます。
使用されます。 この変数は、Makefile の最上位の builddir を参照する必要があります。
によって報告されるコンパイル/リンク フラグ パッケージ構成 使用されます。 これは次の場合にのみ重要です
まだインストールされていないパッケージに対するコンパイル/リンク。

PKG_CONFIG_DISABLE_UNINSTALLED
通常、パッケージ「foo」をリクエストし、パッケージ「foo-uninstalled」が存在する場合、
パッケージ構成 「-uninstalled」バリアントが優先されます。 これによりコンパイル/リンクが可能になります
アンインストールされたパッケージに対して。 この環境変数が設定されている場合、無効になります。
と言った行動。

PKG_CONFIG_ALLOW_SYSTEM_CFLAGS
cflags から -I/usr/include を削除しないでください。

PKG_CONFIG_ALLOW_SYSTEM_LIBS
-L/usr/lib または -L/lib をライブラリから削除しないでください。

PKG_CONFIG_SYSROOT_DIR
ターゲット sysroot にあるディレクトリを使用するように -I と -L を変更します。 このオプションは
pkg-config を使用して CFLAGS と
LDFLAGS。 -I と -L は、新しいシステム ルートを指すように変更されます。 これは、
-I/usr/include/libfoo は、-I/var/target/usr/include/libfoo になります。
PKG_CONFIG_SYSROOT_DIR は /var/target に等しい (同じルールが -L に適用される)

PKG_CONFIG_LIBDIR
デフォルトを置き換えます パッケージ構成 通常、ディレクトリを検索します
/usr/lib/pkgconfig:/usr/share/pkgconfig.

PKG_CONFIG_$PACKAGE_$VARIABLE
パッケージ PACKAGE 内の変数 VARIABLE をオーバーライドします。 環境変数
パッケージ名とパッケージ変数は英数字以外の大文字にする必要があります
文字はアンダースコアに変換されます。 たとえば、設定
PKG_CONFIG_GLADEUI_2_0_CATALOGDIR は、
「gladeui-2.0」パッケージ。

PKG-CONFIG 派生 変数

パッケージ構成 .pc ファイルで使用したり、次の場所でクエリしたりできるいくつかのメタデータ変数を設定します。
ランタイム。

pc_path
で使用されるデフォルトの検索パス パッケージ構成 .pc ファイルを検索するとき。 これはできる
のクエリで使用されます パッケージ構成 モジュール自体自体:
$ pkg-config --variable pc_path pkg-config

PCファイルディレクトリ
.pc ファイルのインストール場所。 これは、次の場所のクエリに使用できます。
特定のモジュールの .pc ファイルですが、.pc ファイルの作成にも使用できます。
再配置可能。 例えば：
プレフィックス=${pcfiledir}/../.。
exec_prefix=${プレフィックス}
libdir=${exec_prefix}/ lib
includedir=${プレフィックス}/インクルード

pc_sysrootdir
ユーザーが設定した sysroot ディレクトリ。 sysrootディレクトリが設定されていない場合は、
この値は /。 見る PKG_CONFIG_SYSROOT_DIR 詳細については環境変数
詳細。

pc_top_builddir
呼び出し時のユーザーの最上位ビルド ディレクトリの場所 パッケージ構成。 これは便利です
アンインストールされた .pc ファイルにパスを動的に設定します。 を参照してください。 PKG_CONFIG_TOP_BUILD_DIR
詳細については、環境変数を参照してください。

WINDOWS 専攻

　 パッケージ構成 Windows ではデフォルトの検索パスは無視されます。 代わりに、検索パスは次のようになります。
のインストールされたディレクトリを使用して構築されます パッケージ構成 そして追加します
lib\pkgconfig & 共有\pkgconfig。 これは、標準を使用して拡張または置き換えることができます。
上記の環境変数。

自動会議 マクロス

PKG_CHECK_MODULES(VARIABLE-PREFIX, モジュール [,見つかったら行動 [,見つからない場合のアクション]])

マクロ PKG_CHECK_MODULES は以下で使用できます。 configure.ac モジュールかどうかを確認するには
存在する。 典型的な使用法は次のとおりです。
PKG_CHECK_MODULES([MYSTUFF], [gtk+-2.0 >= 1.3.5 libxml = 1.8.4])

これにより、MYSTUFF_LIBS および MYSTUFF_CFLAGS 置換変数が次のように設定されます。
指定されたモジュールリストのライブラリと cflags。 モジュールが見つからない場合、またはモジュールがある場合は、
バージョンが間違っていると、デフォルトでconfigureがメッセージを表示して中止されます。 交換するには
デフォルトのアクションでは、ACTION-IF-NOT-FOUND を指定します。 PKG_CHECK_MODULES は印刷されません
独自の ACTION-IF-NOT-FOUND を指定した場合は、エラー メッセージが表示されます。 ただし、
変数 MYSTUFF_PKG_ERRORS を設定します。これを使用して、問題の内容を表示できます。

PKG_CHECK_MODULES への最初の呼び出しが実行されない可能性がある場合は、注意してください。
このような場合は、必ず PKG_PROG_PKG_CONFIG への明示的な呼び出しを含める必要があります。
あなたのconfigure.ac。

また、VARIABLE-PREFIX を繰り返し使用することは推奨されないことに注意してください。 後に
最初に使用が成功した場合、同じ VARIABLE-PREFIX を使用した後続の呼び出しは単に
呼び出しを行わずに、以前の使用法で設定された _LIBS および _CFLAGS 変数を使用します。
パッケージ構成 再び。

PKG_PREREQ(MIN-VERSION)
使用中の pkg-config autoconf マクロのバージョンが少なくとも MIN-
バージョン。 これを使用すると、特定の pkg-config マクロが確実に
にアクセスできるようにしています。

PKG_PROG_PKG_CONFIG([MIN-VERSION])

PKG_CONFIG 変数を利用可能な最適な pkg-config に定義します。
pkg-config が必要ですが、PKG_CHECK_MODULES は使いたくないです。

PKG_CHECK_MODULES_STATIC(VARIABLE-PREFIX, モジュール [,見つかったら行動 [、そうでない場合のアクション-
見つかった]]）
PKG_CHECK_MODULES を呼び出す前に、--static を使用して静的リンクを有効にします。

PKG_CHECK_EXISTS(モジュール, [見つかったら行動]、 [見つからない場合の対処])

特定のモジュールのセットが存在するかどうかを確認します。 に似ている
PKG_CHECK_MODULES() を実行しますが、変数の設定やエラーの出力は行いません。

PKG_CHECK_MODULES と同様に、これまたは
PKG_CHECK_MODULES を呼び出すか、PKG_CHECK_EXISTS を手動で呼び出してください。

PKG_INSTALLDIR(ディレクトリ)

モジュールをインストールする場所として変数 pkgconfigdir を置き換えます。
pkg-config .pc ファイル。 デフォルトのディレクトリは $libdir/pkgconfig ですが、
デフォルトは DIRECTORY を渡すことで変更できます。 ユーザーは、
--with-pkgconfigdir パラメーター。

PKG_NOARCH_INSTALLDIR(ディレクトリ)

モジュールが配置される場所として変数 noarch_pkgconfigdir を置き換えます。
アーキテクチャに依存しない pkg-config .pc ファイルをインストールします。 デフォルトでは、ディレクトリは次のとおりです。
$datadir/pkgconfig ですが、DIRECTORY を渡すことでデフォルトを変更できます。 ユーザー
--with-noarch-pkgconfigdir パラメーターを通じてオーバーライドできます。

PKG_CHECK_VAR(変数, モジュール、 構成変数、 [見つかったら行動]、 [見つからない場合の対処])

MODULE から pkg-config 変数 CONFIG-VARIABLE の値を取得し、
VARIABLE に保存します。 VARIABLE を繰り返し使用することは推奨されないことに注意してください。
変数がすでに設定されている場合、チェックはスキップされます。

METADATA FILE 構文

パッケージのセットにライブラリを追加するには パッケージ構成 知っている場合は、単にインストールするだけです .pc ファイルにソフトウェアを指定する必要があります。
このファイルをインストールする必要があります リブディレクトリ/pkgconfig.

ファイルの例を次に示します。
#これはコメントです
prefix=/home/hp/unst # これは変数を定義します
exec_prefix=${prefix} # 最初の変数に関して別の変数を定義します
libdir=${exec_prefix}/ lib
includedir=${プレフィックス}/インクルード

名前: GObject # 人間が読める名前
説明: GLib のオブジェクト/型システム # 人間が読める説明
バージョン：1.3.1
URL： http://www.gtk.org
必要なもの: glib-2.0 = 1.3.1
競合: foobar <= 4.5
ライブラリ: -L${libdir} -lgobject-1.3
Libs.private: -lm
Cflags: -I${includeir}/glib-2.0 -I${libdir}/glib/include

通常はconfigureを使用してファイルを生成し、接頭辞などが次のように設定されるようにします。
適切な値。 GNU Autoconf マニュアルでは、.pc ファイルなどのファイルを次の場所で生成することを推奨しています。
構成時間ではなくビルド時間なので、.pc ファイルをいつビルドするかは好みの問題です
そして好み。

ファイルには XNUMX 種類の行があります。キーワード行はキーワードとコロンで始まります。
変数定義は、英数字の文字列と等号で始まります。 キーワードは
事前に定義されており、特別な意味を持つ パッケージ構成; 変数はそうではありませんが、変数を持つことはできます
必要な変数 (ただし、ユーザーは通常のディレクトリを取得することを期待する場合があります)
変数に名前を付けます)。

変数参照は「${foo}」と書かれることに注意してください。 リテラルの「${」は「$${」としてエスケープできます。

お名前： このフィールドは、人間が判読できるパッケージ名にする必要があります。 ではないことに注意してください。
引数として渡される名前 パッケージ構成.

説明:
これはパッケージの簡単な説明です

URL： パッケージに関する詳細情報を入手してダウンロードできる URL

バージョン：
これは、可能な限り最も具体的なパッケージ バージョン文字列である必要があります。

必要なもの：
これは、パッケージに必要なパッケージのカンマ区切りのリストです。 フラグ
依存パッケージのフラグは、パッケージに対して報告されたフラグにマージされます。
オプションで、必要なパッケージのバージョンを指定できます (
演算子 =、<、>、>=、<=); バージョンを指定すると、 パッケージ構成 追加のパフォーマンスをする
正気度チェック。 同じパッケージについて言及できるのは XNUMX 回だけです 必要なもの：
ライン。 パッケージのバージョンが指定されていない場合は、任意のバージョンが使用されます。
チェック。

Requires.private:
このパッケージに必要なパッケージのリスト。 との違い 必要 つまり
以下にリストされているパッケージ Requires.private フラグが立っているときは考慮されません。
リストは動的にリンクされた実行可能ファイルに対して計算されます (つまり、 --static が指定されていない場合)
指定された）。 各 .pc ファイルがライブラリに対応する状況では、
Requires.private 間の依存関係を指定するためにのみ使用されます。
ライブラリ。

競合：
このオプションの行により、 パッケージ構成 主に追加の健全性チェックを実行するため
壊れたユーザー インストールを検出します。 構文は次と同じです 必要なもの： 以下は除く
ここでは同じパッケージを複数回リストできます。たとえば、「foobar =
1.2.3、foobar = 1.2.5、foobar >= 1.3" (理由がある場合)。
が指定されていない場合、パッケージは前述のすべてのバージョンと競合します。
パッケージ。 ユーザーがあなたのパッケージと競合するパッケージを同時に使用しようとした場合
時間、それでは パッケージ構成 不平を言うでしょう。

Libs： この行には、パッケージに固有のリンク フラグが指定されます。 フラグを追加しないでください
必要なパッケージ用。 パッケージ構成 それらは自動的に追加されます。

Libs.private:
この行には、使用中のプライベート ライブラリがリストされます。 私立図書館は、
ライブラリを通じて公開されていないが、次の場合に必要となるライブラリ
静的リンク。 これは、 Requires.private ライブラリを参照するという点で
パッケージファイルがインストールされていないもの。

フラグ:
この行には、パッケージに固有のコンパイル フラグがリストされます。 何も追加しないでください
必要なパッケージのフラグ。 パッケージ構成 それらは自動的に追加されます。

onworks.net サービスを使用してオンラインで i686-w64-mingw32-pkg-config を使用する