نام (NAME)

sconsign - چاپ اطلاعات فایل امضای SCons

خلاصه دستور (SYNOPSIS)

sconsign [options...] [file...]

توضیحات (DESCRIPTION)

محتویات یک یا چند فایل sconsign را نمایش می‌دهد؛ پایگاه‌دادهٔ امضا/وابستگی که توسط ابزار ساخت SCons استفاده می‌شود. این پایگاه‌داده شامل تمامی گره‌هایی (Nodes) است که برای فرایند ساخت شناخته‌شده هستند؛ چه از طریق اعلان در پیکربندی ساخت، چه به عنوان اثر جانبی تولید شده باشند و چه از طریق بازرسی شناسایی شده باشند.

به‌طور پیش‌فرض، sconsign تمام محتویات فایل(های) sconsign را تخلیه (dump) می‌کند. بدون گزینه‌ها، مدخل‌های وابستگی جداگانه با قالب زیر چاپ می‌شوند:

depfile: content-signature timestamp length
        implicit-dependency-1: content-signature timestamp size
        implicit-dependency-2: content-signature timestamp size
        ...
        build-signature [action-string]

content-signature (که در حالت پرگو به صورت csig نمایش داده می‌شود) هش محتوای فایل است. build-signature هش خط فرمان یا عمل ساخت دیگری است که برای ساخت یک هدف به کار رفته است. در صورت وجود، action-string رشتهٔ عمل بسط‌نیافته یا تابع فراخوانی‌شده است. عبارت None به جای هر برچسب زمانی یا امضای ناموجود چاپ می‌شود. اگر مدخل فاقد وابستگی‌های ضمنی یا عمل ساخت باشد، خطوط مربوطه حذف می‌شوند.

یک خط نشانگر برای هر دایرکتوری چاپ می‌شود، زیرا دایرکتوری‌ها در پایگاه‌داده امضایی ندارند و در غیر این صورت نمایش داده نمی‌شدند.

به‌طور پیش‌فرض، sconsign فرض می‌کند هر آرگومان file که با پسوند .dblite ختم می‌شود، حاوی مدخل‌های امضا برای بیش از یک دایرکتوری است (یعنی توسط تابع SConsignFile در SCons مشخص شده است). هر آرگومان file بدون پسوند، به عنوان یک فایل sconsign سبک قدیمی (منسوخ‌شده) در نظر گرفته می‌شود که شامل مدخل‌های امضا برای یک دایرکتوری واحد است. اگر هیچ‌یک از این دو برقرار نباشد، sconsign تلاش می‌کند قالب را حدس بزند. در صورتی که این کار ناموفق باشد، می‌توان با استفاده از گزینه‌های -f یا --format= یک قالب صریح را مشخص کرد.

اگر هیچ آرگومان file داده نشود، نام .sconsign.dblite به‌طور پیش‌فرض در نظر گرفته می‌شود.

از نسخهٔ 4.11.0 منسوخ شده است: حالت قدیمی «یک فایل امضا به ازای هر دایرکتوری» منسوخ شده است.

گزینه‌ها (OPTIONS)

گزینه‌های مختلف مشخص می‌کنند چه اطلاعاتی و با چه قالبی چاپ شود:

-a, --act, --action

-c, --csig

-d DIRECTORY, --dir=DIRECTORY

-e ENTRY, --entry=ENTRY

-f FORMAT, --format=FORMAT

-h, --help

-i, --implicit

--raw

-r, --readable

-t, --timestamp

-v, --verbose

محیط (ENVIRONMENT)

SCONS_LIB_DIR

همچنین ببینید (SEE ALSO)

مرجع SCons (صفحهٔ راهنما) در https://scons.org/doc/production/HTML/scons-man.html، راهنمای کاربر SCons در https://scons.org/doc/production/HTML/scons-user.html، کد منبع SCons در GitHub[1].

نویسندگان (AUTHORS)

در ابتدا: Steven Knight knight@baldmt.com و Anthony Roach aroach@electriceyeball.com.

از ۲۰۱۰ تاکنون: The SCons Development Team scons-dev@python.org.

نکات (NOTES)

1.

در GitHub