.\" Sindex manpage by Alexey Gladkov
.TH semind "1"
.
.SH "نام (NAME)"
semind \- نمایه‌ساز معنایی برای C
.
.SH "خلاصه دستور (SYNOPSIS)"
.B semind
[\fIoptions\fR]
.br
.B semind
[\fIoptions\fR] \fIadd\fR [\fIcommand options\fR] [\fI--\fR] [\fIcompiler options\fR] [\fIfiles...\fR]
.br
.B semind
[\fIoptions\fR] \fIrm\fR [\fIcommand options\fR] \fIpattern\fR
.br
.B semind
[\fIoptions\fR] \fIsearch\fR [\fIcommand options\fR] [\fIpattern\fR]
.br
.B semind [\fIoptions\fR] \fIsearch\fR [\fIcommand options\fR] (\fI-e\fR|\fI-l\fR) \fIfilename\fR:\fIlinenr\fR:\fIcolumn\fR
.br
.SH "توضیحات (DESCRIPTION)"
.P
برنامهٔ semind ابزاری ساده و مشابه cscope است که بر پایهٔ sparse/dissect کار می‌کند. بر خلاف cscope، این ابزار پس از پیش‌پردازنده اجرا می‌شود و بنابراین نمی‌تواند کدهایی را که توسط ifdefها فیلتر شده‌اند نمایه کند، اما از سوی دیگر، متوجه نحوهٔ استفاده از نمادها می‌شود و می‌تواند کاربرد اعضای ساختارها (struct) را ردیابی کند.
.
.SH "زیرفرمان‌ها (SUBCOMMANDS)"
.TP
\fBadd\fR
تولید یا به‌روزرسانی فایل نمایه‌ی معنایی.
.TP
\fBrm\fR
حذف فایل‌ها از نمایه بر اساس \fIpattern\fR. آرگومان \fIpattern\fR یک الگوی عامه‌نما (wildcard) منطبق با
.BR glob (7)
است.
.TP
\fBsearch\fR
پرس‌وجوی اطلاعات مربوط به نماد بر اساس \fIpattern\fR. آرگومان \fIpattern\fR یک الگوی عامه‌نما (wildcard) منطبق با
.BR glob (7)
است.
.
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.TP
\fB-D\fR, \fB--database=FILE\fR
مشخص کردن فایل پایگاه‌داده (پیش‌فرض: ./semind.sqlite).
.TP
\fB-v\fR, \fB--verbose\fR
نمایش اطلاعات دربارهٔ کارهای در حال انجام.
.TP
\fB-h\fR, \fB--help\fR
نمایش این راهنما و خروج.
.
.SH "گزینه‌های ADD (ADD OPTIONS)"
.TP
\fB--include-local-syms\fR
گنجاندن نمادهای محلی در نمایه.
.
.SH "گزینه‌های SEARCH (SEARCH OPTIONS)"
.TP
\fB-f\fR, \fB--format=STRING\fR
مشخص کردن قالب خروجی. پیش‌فرض: '(%m) %f\\t%l\\t%c\\t%C\\t%s' (بخش
.BR FORMAT
در زیر را ببینید).
.TP
\fB-p\fR, \fB--path=PATTERN\fR
جستجوی نمادها تنها در دایرکتوری‌های مشخص‌شده.
.TP
\fB-m\fR, \fB--mode=MODE\fR
جستجو تنها بر اساس نوع دسترسی مشخص‌شده (بخش
.BR MODE
در زیر را ببینید).
.TP
\fB-k\fR, \fB--kind=KIND\fR
مشخص کردن نوع نماد (بخش
.BR KIND
در زیر را ببینید).
.TP
\fB-e\fR, \fB--explain\fR
نمایش آنچه در موقعیت مشخص‌شده در فایل رخ می‌دهد؛
.TP
\fB-l\fR, \fB--location\fR
نمایش کاربرد نمادها از یک موقعیت مشخص در فایل؛
.TP
\fB-v\fR, \fB--verbose\fR
نمایش اطلاعات دربارهٔ کارهای در حال انجام؛
.TP
\fB-h\fR, \fB--help\fR
نمایش این راهنما و خروج.
.
.SH "قالب (FORMAT)"
.TP
\fB%m\fR
حالت دسترسی در قالبی خوانا برای انسان (بخش
.BR MODE
در زیر را ببینید).
.TP
\fB%f\fR
نام فایل.
.TP
\fB%l\fR
شماره خط.
.TP
\fB%c\fR
شماره ستون.
.TP
\fB%C\fR
نام تابعی که نماد در آن به کار رفته است.
.TP
\fB%n\fR
نام نماد.
.TP
\fB%s\fR
خط کد منبع. نمایه‌ساز خطوط کد منبع را ذخیره نمی‌کند؛ آن‌ها در حین جستجو از فایل خوانده می‌شوند.
.
.SH "نوع (KIND)"
.TP
\fBf\fR
تابع (function)
.TP
\fBs\fR
strict
.TP
\fBm\fR
عضو ساختار (struct member)
.
.SH "حالت (MODE)"
مقدار \fBMODE\fR به صورت یک رشتهٔ ۳ حرفی نمایش داده می‌شود. حرف اول نشان‌دهندهٔ آدرس بخش، دومی دسترسی از طریق مقدار (by value)، و سومی دسترسی از طریق اشاره‌گر (by pointer) است. مقدار ویژهٔ '\fIdef\fR' به معنی تعریف نماد است.
.TP
\fBr\fR
خواندن (read)
.TP
\fBw\fR
نوشتن (write)
.TP
\fBm\fR
خواندن و نوشتن (read and write)
.
.SH "همچنین ببینید (SEE ALSO)"
.BR sparse (1)
.
.SH "صفحه اصلی (HOMEPAGE)"
https://sparse.docs.kernel.org
.
.SH "فهرست پستی (MAILING LIST)"
linux-sparse@vger.kernel.org
.