'\" t
.\"     Title: SCONSIGN
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net>
.\"      Date: 08/26/2026
.\"    Manual: SCons 4.11.1
.\"    Source: SCons 4.11.1
.\"  Language: Persian
.\"
.TH "SCONSIGN" "1" "08/26/2026" "SCons 4\&.11\&.1" "SCons 4\&.11\&.1"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
sconsign \- چاپ اطلاعات فایل امضای SCons
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsconsign\fR\ 'u
\fBsconsign\fR [\fIoptions\fR...] [\fIfile\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
محتویات یک یا چند فایل
sconsign
را نمایش می‌دهد؛ پایگاه‌دادهٔ امضا/وابستگی که توسط ابزار ساخت
SCons
استفاده می‌شود\&. این پایگاه‌داده شامل تمامی گره‌هایی (Nodes) است که برای فرایند ساخت شناخته‌شده هستند؛ چه از طریق اعلان در پیکربندی ساخت، چه به عنوان اثر جانبی تولید شده باشند و چه از طریق بازرسی شناسایی شده باشند\&.
.PP
به‌طور پیش‌فرض،
\fBsconsign\fR
تمام محتویات فایل(های) sconsign را تخلیه (dump) می‌کند\&. بدون گزینه‌ها، مدخل‌های وابستگی جداگانه با قالب زیر چاپ می‌شوند:
.sp
.if n \{\
.RS 4
.\}
.nf
depfile: content\-signature timestamp length
        implicit\-dependency\-1: content\-signature timestamp size
        implicit\-dependency\-2: content\-signature timestamp size
        \&.\&.\&.
        build\-signature [action\-string]
.fi
.if n \{\
.RE
.\}
.PP

\fBcontent\-signature\fR
(که در حالت پرگو به صورت
csig
نمایش داده می‌شود) هش محتوای فایل است\&.
\fBbuild\-signature\fR
هش خط فرمان یا عمل ساخت دیگری است که برای ساخت یک هدف به کار رفته است\&. در صورت وجود،
\fBaction\-string\fR
رشتهٔ عمل بسط‌نیافته یا تابع فراخوانی‌شده است\&.
عبارت
\fBNone\fR
به جای هر برچسب زمانی یا امضای ناموجود چاپ می‌شود\&. اگر مدخل فاقد وابستگی‌های ضمنی یا عمل ساخت باشد، خطوط مربوطه حذف می‌شوند\&.
.PP
یک خط نشانگر برای هر دایرکتوری چاپ می‌شود، زیرا دایرکتوری‌ها در پایگاه‌داده امضایی ندارند و در غیر این صورت نمایش داده نمی‌شدند\&.
.PP
به‌طور پیش‌فرض،
\fBsconsign\fR
فرض می‌کند هر آرگومان
\fIfile\fR
که با پسوند
\&.dblite
ختم می‌شود، حاوی مدخل‌های امضا برای بیش از یک دایرکتوری است (یعنی توسط تابع
\fBSConsignFile\fR
در
SCons
مشخص شده است)\&. هر آرگومان
\fIfile\fR
بدون پسوند، به عنوان یک فایل sconsign سبک قدیمی (منسوخ‌شده) در نظر گرفته می‌شود که شامل مدخل‌های امضا برای یک دایرکتوری واحد است\&. اگر هیچ‌یک از این دو برقرار نباشد،
\fBsconsign\fR
تلاش می‌کند قالب را حدس بزند\&. در صورتی که این کار ناموفق باشد، می‌توان با استفاده از گزینه‌های
\fB\-f\fR
یا
\fB\-\-format=\fR
یک قالب صریح را مشخص کرد\&.
.PP
اگر هیچ آرگومان
\fIfile\fR
داده نشود، نام
\&.sconsign\&.dblite
به‌طور پیش‌فرض در نظر گرفته می‌شود\&.
.PP

\fIاز نسخهٔ 4\&.11\&.0 منسوخ شده است\fR: حالت قدیمی «یک فایل امضا به ازای هر دایرکتوری» منسوخ شده است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های مختلف مشخص می‌کنند چه اطلاعاتی و با چه قالبی چاپ شود:
.PP
\fB\-a\fR, \fB\-\-act\fR, \fB\-\-action\fR
.RS 4
فقط اطلاعات عمل ساخت را برای تمام مدخل‌ها یا مدخل‌های مشخص‌شده چاپ می‌کند\&.
.RE
.PP
\fB\-c\fR, \fB\-\-csig\fR
.RS 4
فقط اطلاعات امضای محتوا (csig) را برای تمام مدخل‌ها یا مدخل‌های مشخص‌شده چاپ می‌کند\&.
.RE
.PP
\fB\-d \fR\fB\fIDIRECTORY\fR\fR, \fB\-\-dir=\fR\fB\fIDIRECTORY\fR\fR
.RS 4
هنگامی که امضاها از یک فایل
\&.dblite
خوانده می‌شوند، یا از گزینه‌های
\fB\-f dblite\fR
یا
\fB\-\-format=dblite\fR
استفاده شده باشد، فقط اطلاعات مربوط به امضاهای مدخل‌های موجود در
\fIDIRECTORY\fR
مشخص‌شده را چاپ می‌کند\&.
.RE
.PP
\fB\-e \fR\fB\fIENTRY\fR\fR, \fB\-\-entry=\fR\fB\fIENTRY\fR\fR
.RS 4
فقط اطلاعات مربوط به
\fIENTRY\fR
مشخص‌شده را چاپ می‌کند\&. می‌توان چندین گزینهٔ
\fB\-e\fR
را به کار برد که در این صورت اطلاعات هر
\fIENTRY\fR
به همان ترتیبی که گزینه‌ها در خط فرمان مشخص شده‌اند، چاپ می‌شود\&.
.RE
.PP
\fB\-f \fR\fB\fIFORMAT\fR\fR, \fB\-\-format=\fR\fB\fIFORMAT\fR\fR
.RS 4
فایل(های) مورد نظر برای چاپ در
\fIFORMAT\fR
مشخص‌شده هستند\&. مقادیر مجاز عبارتند از
\fBdblite\fR
(قالب SCons\&.dblite که به‌طور پیش‌فرض استفاده می‌شود و همچنین هنگامی که تابع
\fBSConsignFile\fR
فراخوانی شود، مگر زمانی که آرگومان نام فایل برابر
\fBNone\fR
باشد) و
\fBsconsign\fR
(قالبی که برای یک فایل منفرد
\&.sconsign
در هر دایرکتوری استفاده می‌شود)\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
پیام راهنما را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-i\fR, \fB\-\-implicit\fR
.RS 4
فهرست وابستگی‌های ضمنی کش‌شده را برای تمام مدخل‌ها یا مدخل‌های مشخص‌شده چاپ می‌کند\&.
.RE
.PP
\fB\-\-raw\fR
.RS 4
نمایشی ساختاریافته و مرتب از دیکشنری خام پایتون را که حاوی اطلاعات ساخت مدخل‌های منفرد است (هم خود مدخل و هم وابستگی‌های ضمنی آن) چاپ می‌کند\&. عمل ساخت مدخل همچنان در قالب معمول خود چاپ می‌شود\&.
.RE
.PP
\fB\-r\fR, \fB\-\-readable\fR
.RS 4
برچسب‌های زمانی را در یک رشتهٔ خوانا برای انسان، درون کوتیشن‌های تکی چاپ می‌کند\&.
.RE
.PP
\fB\-t\fR, \fB\-\-timestamp\fR
.RS 4
اطلاعات برچسب زمانی را برای تمام مدخل‌ها یا مدخل‌های مشخص‌شده چاپ می‌کند\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
برچسب‌های مشخص‌کنندهٔ هر فیلد در حال چاپ را نمایش می‌دهد\&.
.RE
.SH "محیط (ENVIRONMENT)"
.PP
\fBSCONS_LIB_DIR\fR
.RS 4
دایرکتوری حاوی دایرکتوری ماژول پایتون SCons را مشخص می‌کند (مانند
/home/aroach/scons\-src/SCons)\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
مرجع
SCons
(صفحهٔ راهنما) در
\m[blue]\fB\%https://scons.org/doc/production/HTML/scons-man.html\fR\m[]، راهنمای کاربر SCons در
\m[blue]\fB\%https://scons.org/doc/production/HTML/scons-user.html\fR\m[]، کد منبع SCons
\m[blue]\fBدر GitHub\fR\m[]\&\s-2\u[1]\d\s+2\&.
.SH "نویسندگان (AUTHORS)"
.PP
در ابتدا: Steven Knight
knight@baldmt\&.com
و Anthony Roach
aroach@electriceyeball\&.com\&.
.PP
از ۲۰۱۰ تاکنون: The SCons Development Team
scons\-dev@python\&.org\&.
.SH "نکات (NOTES)"
.IP " 1." 4
در GitHub
.RS 4
\%https://github.com/SCons/scons
.RE