.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "deb-symbols 5"
.TH deb-symbols 5 2026-03-06 1.23.7-dirty "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
deb\-symbols \- فایل اطلاعات گسترش‌یافته کتابخانه مشترک دبیان
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBDEBIAN/symbols\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
فایل‌های نماد (symbols files) در بسته‌های باینری دبیان عرضه می‌شوند و قالب آن‌ها زیرمجموعه‌ای از فایل‌های الگوی نماد است که توسط \fBdpkg\-gensymbols\fR\|(1) در بسته‌های منبع دبیان استفاده می‌شود؛ به \fBdeb\-src\-symbols\fR\|(5) مراجعه کنید.
.PP
قالب یک مدخل اطلاعات وابستگی کتابخانه مشترک گسترش‌یافته در این فایل‌ها به شرح زیر است:
.PP

 \fIlibrary\-soname\fR \fImain\-dependency\-template\fR
 [| \fIalternative\-dependency\-template\fR]
 [...]
 [* \fIfield\-name\fR: \fIfield\-value\fR]
 [...]
  \fIsymbol\fR \fIminimal\-version\fR [\fIid\-of\-dependency\-template\fR]
.PP
مقدار \fIlibrary\-soname\fR دقیقاً همان مقدار فیلد SONAME است که توسط \fBobjdump\fR\|(1) صادر (export) شده است. یک \fIdependency\-template\fR یک وابستگی است که در آن \fI#MINVER#\fR به صورت پویا با یک بررسی نسخه مانند \(lq(>= \fIminimal\-version\fR)\(rq یا با هیچ‌چیز (در صورتی که وابستگی بدون نسخه کافی تشخیص داده شود) جایگزین می‌شود.
.PP
هر \fIsymbol\fR صادرشده (که به صورت \fIname\fR@\fIversion\fR فهرست می‌شود، و اگر کتابخانه نسخه‌بندی نشده باشد \fIversion\fR برابر \(lqBase\(rq خواهد بود) با یک \fIminimal\-version\fR از الگوی وابستگی‌اش مرتبط است (الگوی وابستگی اصلی همیشه استفاده می‌شود و در صورت وجود با الگوی وابستگی ارجاع‌شده توسط \fIid\-of\-dependency\-template\fR ترکیب خواهد شد). نخستین الگوی وابستگی جایگزین با شماره ۱، دومی با ۲ و به همین ترتیب شماره‌گذاری می‌شود. هر ستون دقیقاً با یک نویسه فاصله جدا شده است.
.PP
هر مدخل برای یک کتابخانه همچنین می‌تواند فیلدهایی از فراداده (meta\-information) داشته باشد. این فیلدها در خطوطی که با علامت ستاره آغاز می‌شوند ذخیره می‌گردند. در حال حاضر، تنها فیلدهای معتبر عبارتند از:
.IP \fBBuild\-Depends\-Package\fR 4
.IX Item "Build-Depends-Package"
نام بسته \(lq\-dev\(rq مرتبط با کتابخانه را مشخص می‌کند و توسط \fBdpkg\-shlibdeps\fR استفاده می‌شود تا اطمینان حاصل شود وابستگی تولیدشده حداقل به اندازه وابستگی ساخت (build dependency) متناظر سخت‌گیرانه است (از dpkg 1.14.13 به بعد).
.IP \fBBuild\-Depends\-Packages\fR 4
.IX Item "Build-Depends-Packages"
مشابه \fBBuild\-Depends\-Package\fR است اما فهرستی از نام‌های بسته‌ها را که با کاما از هم جدا شده‌اند می‌پذیرد (از dpkg 1.20.0 به بعد). این فیلد هر فیلد \fBBuild\-Depends\-Package\fR موجود را بازنویسی (override) خواهد کرد و بیشتر برای بسته‌های \(lq\-dev\(rq و فرابسته‌هایی (metapackages) که به آن‌ها وابسته هستند، مثلاً در طول یک دوره گذار، کاربرد دارد.
.IP \fBAllow\-Internal\-Symbol\-Groups\fR 4
.IX Item "Allow-Internal-Symbol-Groups"
مشخص می‌کند که کدام گروه‌های نماد داخلی باید نادیده گرفته شوند، به صورت فهرستی که با فاصله از هم جدا شده‌اند، تا نمادهای موجود در آن گروه‌ها در فایل خروجی گنجانده شوند (از dpkg 1.20.1 به بعد). این مورد تنها باید برای بسته‌های زنجیره ابزار (toolchain) که آن نمادهای داخلی را ارائه می‌دهند ضروری باشد. گروه‌های موجود وابسته به سیستم هستند؛ برای سیستم‌های مبتنی بر ELF و GNU این گروه‌ها شامل \fBaeabi\fR و \fBgomp\fR می‌شوند.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
.SS "فایل نمادهای ساده (Simple symbols file)"
.IX Subsection "Simple symbols file"
.Vb 4
\& libftp.so.3 libftp3 #MINVER#
\&  DefaultNetbuf@Base 3.1\-1\-6
\&  FtpAccess@Base 3.1\-1\-6
\&  [...]
.Ve
.SS "فایل نمادهای پیشرفته (Advanced symbols file)"
.IX Subsection "Advanced symbols file"
.Vb 7
\& libGL.so.1 libgl1
\& | libgl1\-mesa\-glx #MINVER#
\& * Build\-Depends\-Package: libgl1\-mesa\-dev
\&  publicGlSymbol@Base 6.3\-1
\&  [...]
\&  implementationSpecificSymbol@Base 6.5.2\-7 1
\&  [...]
.Ve
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>,
\&\fBdeb\-src\-symbols\fR\|(5),
\&\fBdpkg\-shlibdeps\fR\|(1),
\&\fBdpkg\-gensymbols\fR\|(1).