pkg-config - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

pkg-config - Trả về siêu thông tin về các thư viện đã cài đặt

SYNOPSIS

pkg-config [--modversion] [--version] [--help] [--atleast-pkgconfig-version = VERSION]
[- print-error] [--short-error] [--silence-error] [--errors-to-stdout] [--debug]
[--cflags] [--libs] [--libs-only-L] [--libs-only-l] [--cflags-only-I] [--libs-only-other]
[--cflags-only-other] [--variable = VARIABLENAME] [--define-
biến = VARIABLENAME = VARIABLEVALUE] [- print-variable] [--uninstalled] [--exists]
[--atleast-version = VERSION] [--exact-version = VERSION] [--max-version = VERSION] [--validate]
[--list-all] [--print-cung cấp] [--print-Request] [--print-Request-private]
[THƯ VIỆN ...]

MÔ TẢ

Sản phẩm pkg-config chương trình được sử dụng để truy xuất thông tin về các thư viện đã cài đặt trong
hệ thống. Nó thường được sử dụng để biên dịch và liên kết với một hoặc nhiều thư viện. Đây là
một kịch bản sử dụng điển hình trong Makefile:

chương trình: program.c
cc program.c $ (pkg-config --cflags --libs gnomeui)

pkg-config truy xuất thông tin về các gói từ các tệp siêu dữ liệu đặc biệt. Những tệp này
được đặt tên theo gói và có .máy tính gia hạn. Trên hầu hết các hệ thống, pkg-config nhìn
in / usr / lib / pkgconfig, / usr / share / pkgconfig, / usr / local / lib / pkgconfig và
/ usr / local / share / pkgconfig cho các tệp này. Nó cũng sẽ nhìn trong dấu hai chấm-
được phân tách (trên Windows, được phân tách bằng dấu chấm phẩy) danh sách các thư mục được chỉ định bởi
Biến môi trường PKG_CONFIG_PATH.

Tên gói được chỉ định trên pkg-config dòng lệnh được xác định là tên của
tệp siêu dữ liệu, trừ đi .máy tính gia hạn. Nếu một thư viện có thể cài đặt nhiều phiên bản
đồng thời, nó phải đặt tên riêng cho từng phiên bản (ví dụ: GTK 1.2 có thể có
tên gói "gtk +" trong khi GTK 2.0 có "gtk + -2.0").

Ngoài việc chỉ định tên gói trên dòng lệnh, đường dẫn đầy đủ đến một .máy tính
tệp có thể được cung cấp thay thế. Điều này cho phép người dùng truy vấn trực tiếp một .máy tính tập tin.

LỰA CHỌN

Các tùy chọn sau được hỗ trợ:

- chuyển đổi
Yêu cầu thông tin phiên bản của các thư viện được chỉ định trên lệnh
dòng được hiển thị. Nếu như pkg-config có thể tìm thấy tất cả các thư viện trên dòng lệnh,
mỗi chuỗi phiên bản của thư viện được in ra stdout, một phiên bản trên mỗi dòng. Trong này
trường hợp pkg-config thoát thành công. Nếu một hoặc nhiều thư viện không xác định, pkg-config
thoát với mã khác không và nội dung của stdout là không xác định.

--phiên bản
Hiển thị phiên bản của pkg-config và chấm dứt.

--atleast-pkgconfig-version = VERSION
Yêu cầu ít nhất phiên bản pkg-config đã cho.

--Cứu giúp Hiển thị thông báo trợ giúp và kết thúc.

- lỗi in
Nếu một hoặc nhiều mô-đun trên dòng lệnh, hoặc các phần phụ thuộc của chúng, không
được tìm thấy hoặc nếu lỗi xảy ra khi phân tích cú pháp .máy tính tệp, sau đó tùy chọn này sẽ gây ra
lỗi giải thích vấn đề được in. Với các tùy chọn "vị ngữ" chẳng hạn như
"- tồn tại" pkg-config chạy im lặng theo mặc định, vì nó thường được sử dụng trong
tập lệnh muốn kiểm soát những gì đầu ra. Tùy chọn này có thể được sử dụng một mình (để chỉ
lỗi in gặp phải mô-đun định vị trên dòng lệnh) hoặc với các mô-đun khác
tùy chọn. Biến môi trường PKG_CONFIG_DEBUG_SPEW ghi đè tùy chọn này.

--short-error
In thông báo lỗi ngắn.

--silence-error
Nếu một hoặc nhiều mô-đun trên dòng lệnh, hoặc các phần phụ thuộc của chúng, không
tìm thấy hoặc nếu lỗi xảy ra trong phân tích cú pháp aa .máy tính tệp, sau đó tùy chọn này sẽ giữ
lỗi giải thích sự cố từ khi được in. Với các tùy chọn "vị ngữ" chẳng hạn như
"- tồn tại" pkg-config chạy im lặng theo mặc định, vì nó thường được sử dụng trong
tập lệnh muốn kiểm soát những gì đầu ra. Vì vậy, tùy chọn này chỉ hữu ích với
các tùy chọn như "--cflags" hoặc "--modversion" in lỗi theo mặc định. Các
Biến môi trường PKG_CONFIG_DEBUG_SPEW ghi đè tùy chọn này.

--lỗi-đến-thiết bị xuất chuẩn
Nếu in lỗi, hãy in chúng ra stdout thay vì stderr mặc định

--gỡ lỗi
In thông tin gỡ lỗi. Điều này hơi khác so với
Biến môi trường PKG_CONFIG_DEBUG_SPEW, cũng cho phép "- lỗi in".

Các tùy chọn sau được sử dụng để biên dịch và liên kết các chương trình:

--cflags
Điều này in cờ bộ xử lý trước và biên dịch cần thiết để biên dịch các gói trên
dòng lệnh, bao gồm các cờ cho tất cả các phụ thuộc của chúng. Cờ được "nén" nên
rằng mỗi cờ giống hệt nhau chỉ xuất hiện một lần. pkg-config thoát với một mã khác nếu
nó không thể tìm thấy siêu dữ liệu cho một hoặc nhiều gói trên dòng lệnh.

--cflags-chỉ-tôi
Điều này sẽ in phần I của "--cflags". Đó là, nó xác định đường dẫn tìm kiếm tiêu đề
nhưng không chỉ định bất cứ điều gì khác.

--cflags-chỉ-khác
Thao tác này in các phần của "--cflags" không được bao phủ bởi "--cflags-only-I".

--libs Tùy chọn này giống với "--cflags", chỉ nó in các cờ liên kết. Như với
"--cflags", cờ trùng lặp được hợp nhất (duy trì thứ tự phù hợp) và cờ cho
phụ thuộc được bao gồm trong đầu ra.

--libs-chỉ-L
Thao tác này sẽ in phần -L / -R của "--libs". Đó là, nó xác định đường dẫn tìm kiếm thư viện
nhưng không chỉ định thư viện nào để liên kết với.

--libs-chỉ-l
Thao tác này in phần -l của "--libs" cho các thư viện được chỉ định trên lệnh
hàng. Lưu ý rằng sự kết hợp của "--libs-only-l" và "--libs-only-L" có thể nhỏ hơn
hơn "--libs", do các cờ như -rdynamic.

--libs-chỉ-khác
Thao tác này sẽ in các phần của "--libs" không được bao phủ bởi "--libs-only-L" và "--libs-only-
l ", chẳng hạn như" --pthread ".

--variable = VARIABLENAME
Điều này trả về giá trị của một biến được xác định trong một gói .máy tính tập tin. Hầu hết các gói
chẳng hạn như xác định biến "tiền tố", vì vậy bạn có thể nói:
$ pkg-config --variable = tiền tố glib-2.0
/ usr /

--define-variable = VARIABLENAME = VARIABLEVALUE
Điều này đặt giá trị toàn cục cho một biến, ghi đè giá trị trong bất kỳ .máy tính các tập tin.
Ví dụ, hầu hết các gói đều xác định biến "tiền tố", vì vậy bạn có thể nói:
$ pkg-config --print-error --define-variable = prefix = / foo \
--variable = tiền tố glib-2.0
/ foo

- biến-in
Trả về danh sách tất cả các biến được xác định trong gói.

- gỡ cài đặt
Thông thường, nếu bạn yêu cầu gói "foo" và gói "foo-uninstalled" tồn tại,
pkg-config sẽ thích biến thể "-uninstalled" hơn. Điều này cho phép biên dịch / liên kết
chống lại các gói đã gỡ cài đặt. Nếu bạn chỉ định tùy chọn "- Uninstalled", pkg-config
sẽ trả về thành công nếu có bất kỳ gói "-gỡ cài đặt" nào đang được sử dụng và trả về
thất bại (sai) ngược lại. (Môi trường PKG_CONFIG_DISABLE_UNINSTALLED
biến giữ pkg-config từ việc chọn ngầm các gói "-cài đặt", vì vậy nếu
biến đó đã được đặt, chúng sẽ chỉ được sử dụng nếu bạn chuyển một tên như "foo-
đã gỡ cài đặt "trên dòng lệnh một cách rõ ràng.)

- tồn tại

--atleast-version = VERSION

--exact-version = VERSION

--max-version = VERSION
Các tùy chọn này kiểm tra xem gói hoặc danh sách các gói trên dòng lệnh có
được biết đến pkg-configvà tùy chọn xem số phiên bản của một gói có đáp ứng hay không
những ràng buộc nhất định. Nếu tất cả các gói đều tồn tại và đáp ứng phiên bản được chỉ định
hạn chế, pkg-config thoát thành công. Nếu không, nó thoát không thành công. Chỉ một
tùy chọn so sánh VERSION đầu tiên sẽ được áp dụng. Các tùy chọn tiếp theo của loại này
sẽ bị bỏ qua.

Thay vì sử dụng các tùy chọn kiểm tra phiên bản, bạn có thể chỉ cần đưa ra một phiên bản
ràng buộc sau mỗi tên gói, ví dụ:
$ pkg-config - tồn tại 'glib-2.0> = 1.3.4 libxml = 1.8.3'
Hãy nhớ sử dụng - print-error nếu bạn muốn thông báo lỗi. Khi không có tùy chọn đầu ra
được cung cấp cho pkg-config, - tồn tại được ngụ ý.

- xác thực
Kiểm tra cú pháp của gói .máy tính hồ sơ cho hợp lệ. Điều này cũng giống như
- tồn tại ngoại trừ rằng các phụ thuộc không được xác minh. Điều này có thể hữu ích cho gói
các nhà phát triển để kiểm tra .máy tính tệp trước khi phát hành:
$ pkg-config --validate ./my-package.pc

--msvc-cú pháp
Tùy chọn này chỉ có sẵn trên Windows. Điều đó gây ra pkg-config để xuất -l và -L
cờ ở dạng được trình biên dịch dòng lệnh Microsoft Visual C ++ công nhận, cl.
Cụ thể, thay vì -Lx: / some / path nó in / libpath: x / some / pathvà thay vào đó
of -lfoo nó in foo.lib. Lưu ý rằng đầu ra --libs bao gồm các cờ cho
trình liên kết, và phải được đặt trên dòng lệnh cl sau khi chuyển đổi liên kết /.

--define-tiền tố
--dont-xác định-tiền tố
Các tùy chọn này kiểm soát xem pkg-config ghi đè giá trị của biến tiếp đầu ngữ
trong mỗi tệp .pc. Với tiền tố --define, pkg-config sử dụng vị trí đã cài đặt của
tệp .pc để xác định tiền tố. --dont-define-prefix ngăn chặn hành vi này.
Giá trị mặc định thường là --define-prefix.

Khi tính năng này được bật và tệp .pc được tìm thấy trong thư mục có tên
pkgconfig, tiền tố cho gói đó được giả định là ông bà của
thư mục nơi tệp được tìm thấy và tiếp đầu ngữ biến bị ghi đè cho điều đó
tập tin phù hợp.

Nếu giá trị của một biến trong tệp .pc bắt đầu bằng giá trị ban đầu, không bị ghi đè,
giá trị của tiếp đầu ngữ biến, sau đó là giá trị được ghi đè của tiếp đầu ngữ được sử dụng thay thế.
Điều này cho phép tính năng hoạt động ngay cả khi các biến đã được mở rộng trong
tệp .pc.

--prefix-variable = PREFIX
Đặt tên của biến mà pkg-config ghi đè thay vì tiếp đầu ngữ khi sử dụng
tính năng --define-prefix.

- đứng yên
Thư viện đầu ra thích hợp cho liên kết tĩnh. Điều đó có nghĩa là bao gồm bất kỳ
thư viện trong đầu ra. Điều này phụ thuộc vào việc gắn thẻ thích hợp trong các tệp .pc, nếu không
số lượng thư viện quá lớn thường sẽ được xuất ra.

--liệt kê tất cả
Liệt kê tất cả các mô-đun được tìm thấy trong pkg-config con đường.

- print-cung cấp
Liệt kê tất cả các mô-đun mà các gói nhất định cung cấp.

- yêu cầu in
Liệt kê tất cả các mô-đun mà các gói nhất định yêu cầu.

- print-request-private
Liệt kê tất cả các mô-đun mà các gói nhất định yêu cầu cho liên kết tĩnh (xem --static).

MÔI TRƯỜNG BIẾN

PKG_CONFIG_PATH
Danh sách thư mục được phân tách bằng dấu hai chấm (trên Windows, được phân tách bằng dấu chấm phẩy) để tìm kiếm
cho các tệp .pc. Thư mục mặc định sẽ luôn được tìm kiếm sau khi tìm kiếm
con đường; mặc định là libdir /pkgcấu hình:thư mục dữ liệu/ pkgconfig ở đâu thư viện là libdir
cho pkg-config và thư mục dữ liệu là datadir cho pkg-config khi nó được cài đặt.

PKG_CONFIG_DEBUG_SPEW
Nếu được đặt, nguyên nhân pkg-config để in tất cả các loại thông tin gỡ lỗi và báo cáo
tất cả các lỗi.

PKG_CONFIG_TOP_BUILD_DIR
Một giá trị để đặt cho biến ma thuật pc_top_builddir có thể xuất hiện trong .máy tính
các tập tin. Nếu biến môi trường không được đặt, giá trị mặc định '$ (top_builddir)'
sẽ được sử dụng. Biến này nên tham chiếu đến builddir trên cùng của Makefile, nơi
các cờ biên dịch / liên kết được báo cáo bởi pkg-config sẽ được sử dụng. Điều này chỉ quan trọng khi
biên dịch / liên kết với một gói chưa được cài đặt.

PKG_CONFIG_DISABLE_UNINSTALLED
Thông thường, nếu bạn yêu cầu gói "foo" và gói "foo-uninstalled" tồn tại,
pkg-config sẽ thích biến thể "-uninstalled" hơn. Điều này cho phép biên dịch / liên kết
chống lại các gói đã gỡ cài đặt. Nếu biến môi trường này được đặt, nó sẽ vô hiệu hóa
hành vi nói.

PKG_CONFIG_ALLOW_SYSTEM_CFLAGS
Đừng loại bỏ -I / usr / include ra khỏi cflags.

PKG_CONFIG_ALLOW_SYSTEM_LIBS
Đừng loại bỏ L / usr / lib hoặc -L / lib ra khỏi libs.

PKG_CONFIG_SYSROOT_DIR
Sửa đổi -I và -L để sử dụng các thư mục nằm trong sysroot đích. tùy chọn này là
hữu ích khi biên dịch chéo các gói sử dụng pkg-config để xác định CFLAGS và
LDFLAGS. -I và -L được sửa đổi để trỏ đến gốc hệ thống mới. điều này có nghĩa là một
-I / usr / include / libfoo sẽ trở thành -I / var / target / usr / include / libfoo với một
PKG_CONFIG_SYSROOT_DIR bằng / var / target (áp dụng quy tắc tương tự cho -L)

PKG_CONFIG_LIBDIR
Thay thế mặc định pkg-config thư mục tìm kiếm, thường là
/ usr / lib / pkgconfig:/ usr / share / pkgconfig.

PKG_CONFIG_ $ PACKAGE_ $ VARIABLE
Ghi đè biến VARIABLE trong gói PACKAGE. Biến môi trường
nên có tên gói và biến gói được viết hoa chữ cái, không phải chữ và số
các ký tự được chuyển đổi thành dấu gạch dưới. Ví dụ, thiết lập
PKG_CONFIG_GLADEUI_2_0_CATALOGDIR sẽ ghi đè biến "catalogdir" trong
gói "gladeui-2.0".

PKG-CẤU HÌNH NGUỒN GỐC BIẾN

pkg-config đặt một vài biến siêu dữ liệu có thể được sử dụng trong tệp .pc hoặc được truy vấn tại
thời gian chạy.

đường dẫn máy tính
Đường dẫn tìm kiếm mặc định được sử dụng bởi pkg-config khi tìm kiếm tệp .pc. Cái này có thể
được sử dụng trong một truy vấn cho pkg-config mô-đun chính nó:
$ pkg-config --biến pc_path pkg-config

pcfiledir
Vị trí đã cài đặt của tệp .pc. Điều này có thể được sử dụng để truy vấn vị trí của
tệp .pc cho một mô-đun cụ thể, nhưng nó cũng có thể được sử dụng để tạo tệp .pc
có thể di dời. Ví dụ:
tiền tố = $ {pcfiledir}/../ ..
executive_prefix = $ {prefix}
libdir = $ {execute_prefix}/ lib
includeir = $ {prefix} / bao gồm

pc_sysrootdir
Thư mục sysroot do người dùng đặt. Khi chưa đặt thư mục sysroot,
giá trị này là /. Xem PKG_CONFIG_SYSROOT_DIR biến môi trường để biết thêm
chi tiết.

pc_top_builddir
Vị trí của thư mục bản dựng hàng đầu của người dùng khi gọi pkg-config. Cái này hữu ích
để đặt động các đường dẫn trong các tệp .pc đã gỡ cài đặt. Xem PKG_CONFIG_TOP_BUILD_DIR
biến môi trường để biết thêm chi tiết.

CÁC CỬA SỔ ĐẶC BIỆT

Sản phẩm pkg-config đường dẫn tìm kiếm mặc định bị bỏ qua trên Windows. Thay vào đó, đường dẫn tìm kiếm là
được xây dựng bằng cách sử dụng thư mục đã cài đặt của pkg-config và sau đó nối tiếp
lib \ pkgconfig và chia sẻ \ pkgconfig. Điều này có thể được tăng cường hoặc thay thế bằng cách sử dụng tiêu chuẩn
các biến môi trường được mô tả ở trên.

TỰ ĐỘNG MACRO

PKG_CHECK_MODULES (VARIABLE-PREFIX, MODULES [, ACTION-IF-FOUND [, ACTION-IF-NOT-FOUND]])

Macro PKG_CHECK_MODULES có thể được sử dụng trong config.ac để kiểm tra xem các mô-đun
hiện hữu. Một cách sử dụng điển hình sẽ là:
PKG_CHECK_MODULES ([MYSTUFF], [gtk + -2.0> = 1.3.5 libxml = 1.8.4])

Điều này sẽ dẫn đến các biến thay thế MYSTUFF_LIBS và MYSTUFF_CFLAGS, được đặt thành
lib và cflags cho danh sách mô-đun đã cho. Nếu một mô-đun bị thiếu hoặc có
phiên bản sai, theo cấu hình mặc định sẽ hủy bỏ bằng một thông báo. Để thay thế
hành động mặc định, chỉ định HÀNH ĐỘNG-NẾU-KHÔNG-TÌM HIỂU. PKG_CHECK_MODULES sẽ không in
bất kỳ thông báo lỗi nào nếu bạn chỉ định ACTION-IF-NOT-FOUND của riêng bạn. Tuy nhiên, nó sẽ
đặt biến MYSTUFF_PKG_ERRORS mà bạn có thể sử dụng để hiển thị những gì đã xảy ra.

Lưu ý rằng nếu có khả năng, cuộc gọi đầu tiên tới PKG_CHECK_MODULES có thể không
xảy ra, bạn nên đảm bảo bao gồm một lệnh gọi rõ ràng tới PKG_PROG_PKG_CONFIG trong
config.ac của bạn.

Cũng lưu ý rằng không nên sử dụng lặp lại VARIABLE-PREFIX. Sau
lần sử dụng thành công đầu tiên, các cuộc gọi tiếp theo với cùng một VARIABLE-PREFIX sẽ đơn giản
sử dụng các biến _LIBS và _CFLAGS được đặt từ lần sử dụng trước mà không cần gọi
pkg-config một lần nữa.

PKG_PREREQ (PHIÊN BẢN MIN)
Kiểm tra để đảm bảo rằng phiên bản của macro pkg-config autoconf đang được sử dụng ít nhất là MIN-
PHIÊN BẢN. Điều này có thể được sử dụng để đảm bảo một macro pkg-config cụ thể sẽ
có sẵn.

PKG_PROG_PKG_CONFIG ([MIN-VERSION])

Xác định biến PKG_CONFIG thành pkg-config tốt nhất hiện có, hữu ích nếu bạn
cần pkg-config nhưng không muốn sử dụng PKG_CHECK_MODULES.

PKG_CHECK_MODULES_STATIC (VARIABLE-PREFIX, MODULES [, ACTION-IF-FOUND [, HÀNH ĐỘNG-NẾU-KHÔNG-
TÌM]])
Bật liên kết tĩnh thông qua --static trước khi gọi PKG_CHECK_MODULES.

PKG_CHECK_EXISTS (MODULES, [HÀNH ĐỘNG NẾU TÌM THẤY], [HÀNH ĐỘNG-NẾU-KHÔNG-TÌM HIỂU])

Kiểm tra xem có tồn tại một tập hợp mô-đun cụ thể hay không. Tương tự với
PKG_CHECK_MODULES (), nhưng không đặt biến hoặc lỗi in.

Tương tự như PKG_CHECK_MODULES, hãy đảm bảo rằng phiên bản đầu tiên của điều này hoặc
PKG_CHECK_MODULES được gọi hoặc đảm bảo gọi PKG_CHECK_EXISTS theo cách thủ công.

PKG_INSTALLDIR (TRỰC TIẾP)

Thay thế biến pkgconfigdir làm vị trí mà mô-đun sẽ cài đặt
tệp pkg-config .pc. Theo mặc định, thư mục là $ libdir / pkgconfig, nhưng
mặc định có thể được thay đổi bằng cách chuyển DIRECTORY. Người dùng có thể ghi đè thông qua
Tham số --with-pkgconfigdir.

PKG_NOARCH_INSTALLDIR (TRỰC TIẾP)

Thay thế biến noarch_pkgconfigdir làm vị trí mà mô-đun sẽ
cài đặt các tệp pkg-config .pc không phụ thuộc vào vòm. Theo mặc định, thư mục là
$ datadir / pkgconfig, nhưng có thể thay đổi giá trị mặc định bằng cách chuyển DIRECTORY. Người dùng
có thể ghi đè thông qua tham số --with-noarch-pkgconfigdir.

PKG_CHECK_VAR (VARIABLE, MÔ-ĐUN, CONFIG-BIẾN, [HÀNH ĐỘNG NẾU TÌM THẤY], [HÀNH ĐỘNG-NẾU-KHÔNG-TÌM HIỂU])

Lấy giá trị của biến pkg-config CONFIG-VARIABLE từ MODULE và
lưu trữ nó trong VARIABLE. Lưu ý rằng không nên sử dụng lặp lại VARIABLE vì
việc kiểm tra sẽ bị bỏ qua nếu biến đã được đặt.

METADATA FILE TỔNG HỢP

Để thêm thư viện vào tập hợp các gói pkg-config biết về, chỉ cần cài đặt một .máy tính tập tin.
Bạn nên cài đặt tệp này để thư viện/ pkgconfig.

Đây là một tệp ví dụ:
# Đây là một nhận xét
tiền tố = / home / hp / un # điều này xác định một biến
execute_prefix = $ {prefix} # xác định một biến khác theo điều kiện đầu tiên
libdir = $ {execute_prefix}/ lib
includeir = $ {prefix} / bao gồm

Tên: GObject # tên con người có thể đọc được
Mô tả: Hệ thống đối tượng / loại cho mô tả GLib # con người có thể đọc được
Version: 1.3.1
URL: http://www.gtk.org
Yêu cầu: glib-2.0 = 1.3.1
Xung đột: foobar <= 4.5
Lib: -L $ {libdir} -lgobject-1.3
Libs.private: -lm
Cflags: -I $ {includeir} /glib-2.0 -I $ {libdir} / glib / include

Thông thường, bạn sẽ tạo tệp bằng cấu hình, để tiền tố, v.v. được đặt thành
các giá trị thích hợp. Sổ tay GNU Autoconf khuyến nghị tạo các tệp như tệp .pc tại
thời gian xây dựng hơn là định cấu hình thời gian, vì vậy khi bạn xây dựng tệp .pc là một vấn đề quan trọng
và sở thích.

Tệp có hai loại dòng: dòng từ khóa bắt đầu bằng từ khóa cộng với dấu hai chấm, và
định nghĩa biến bắt đầu bằng một chuỗi chữ và số cộng với một dấu bằng. Từ khóa là
được xác định trước và có ý nghĩa đặc biệt đối với pkg-config; biến không, bạn có thể có
bất kỳ biến nào bạn muốn (tuy nhiên, người dùng có thể mong đợi truy xuất thư mục thông thường
tên biến).

Lưu ý rằng các tham chiếu biến được viết "$ {foo}"; bạn có thể thoát "$ {" theo nghĩa đen là "$$ {".

Tên: Trường này phải là tên mà con người có thể đọc được cho gói. Lưu ý rằng nó không phải là
tên được chuyển làm đối số cho pkg-config.

Sự miêu tả:
Đây phải là một mô tả ngắn gọn về gói

URL: URL nơi mọi người có thể biết thêm thông tin về và tải xuống gói

Phiên bản:
Đây phải là chuỗi phiên bản gói cụ thể nhất có thể.

Đòi hỏi:
Đây là danh sách các gói được phân tách bằng dấu phẩy mà gói của bạn yêu cầu. Cờ
từ các gói phụ thuộc sẽ được hợp nhất vào các cờ được báo cáo cho gói của bạn.
Theo tùy chọn, bạn có thể chỉ định phiên bản của gói yêu cầu (sử dụng
các toán tử =, <,>,> =, <=); chỉ định một phiên bản cho phép pkg-config để thực hiện thêm
kiểm tra sự tỉnh táo. Bạn chỉ có thể đề cập đến cùng một gói một lần trên Đòi hỏi:
hàng. Nếu phiên bản của một gói không được chỉ định, thì bất kỳ phiên bản nào sẽ được sử dụng với
kiểm tra.

Yêu cầu. Riêng tư:
Một danh sách các gói theo yêu cầu của gói này. Sự khác biệt từ Yêu cầu là
các gói được liệt kê dưới Yêu cầu.private không được tính đến khi một lá cờ
danh sách được tính toán cho tệp thực thi được liên kết động (nghĩa là khi --static không
chỉ định). Trong trường hợp mỗi tệp .pc tương ứng với một thư viện,
Yêu cầu.private sẽ được sử dụng riêng để xác định sự phụ thuộc giữa
thư viện.

Xung đột:
Dòng tùy chọn này cho phép pkg-config để thực hiện kiểm tra sự tỉnh táo bổ sung, chủ yếu
để phát hiện cài đặt của người dùng bị hỏng. Cú pháp giống như Đòi hỏi: ngoại trừ
mà bạn có thể liệt kê nhiều lần cùng một gói tại đây, ví dụ: "foobar =
1.2.3, foobar = 1.2.5, foobar> = 1.3 ", nếu bạn có lý do để làm như vậy. Nếu một phiên bản
không được chỉ định, khi đó gói của bạn xung đột với tất cả các phiên bản của
Bưu kiện. Nếu người dùng cố gắng sử dụng gói của bạn và một gói xung đột cùng một lúc
thời gian, sau đó pkg-config sẽ phàn nàn.

Lib: Dòng này sẽ cung cấp các cờ liên kết cụ thể cho gói của bạn. Không thêm bất kỳ cờ nào
cho các gói yêu cầu; pkg-config sẽ tự động thêm chúng.

Libs.riêng tư:
Dòng này sẽ liệt kê bất kỳ thư viện tư nhân nào đang được sử dụng. Thư viện tư nhân là
thư viện không được hiển thị thông qua thư viện của bạn, nhưng cần thiết trong trường hợp
liên kết tĩnh. Điều này khác với Yêu cầu.private trong đó nó tham chiếu đến các thư viện
không có tệp gói được cài đặt.

Dấu gạch ngang:
Dòng này sẽ liệt kê các cờ biên dịch cụ thể cho gói của bạn. Không thêm bất kỳ
cờ cho các gói bắt buộc; pkg-config sẽ tự động thêm chúng.

Sử dụng pkg-config trực tuyến bằng các dịch vụ onworks.net