نام (NAME)

semind - نمایه‌ساز معنایی برای C

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

semind [options]
semind [options] add [command options] [--] [compiler options] [files...]
semind [options] rm [command options] pattern
semind [options] search [command options] [pattern]
semind [options] search [command options] (-e|-l) filename:linenr:column

توضیحات (DESCRIPTION)

برنامهٔ semind ابزاری ساده و مشابه cscope است که بر پایهٔ sparse/dissect کار می‌کند. بر خلاف cscope، این ابزار پس از پیش‌پردازنده اجرا می‌شود و بنابراین نمی‌تواند کدهایی را که توسط ifdefها فیلتر شده‌اند نمایه کند، اما از سوی دیگر، متوجه نحوهٔ استفاده از نمادها می‌شود و می‌تواند کاربرد اعضای ساختارها (struct) را ردیابی کند.

زیرفرمان‌ها (SUBCOMMANDS)

add: تولید یا به‌روزرسانی فایل نمایه‌ی معنایی.
rm: حذف فایل‌ها از نمایه بر اساس pattern. آرگومان pattern یک الگوی عامه‌نما (wildcard) منطبق با glob(7) است.
search: پرس‌وجوی اطلاعات مربوط به نماد بر اساس pattern. آرگومان pattern یک الگوی عامه‌نما (wildcard) منطبق با glob(7) است.

گزینه‌های عمومی (COMMON OPTIONS)

-D, --database=FILE: مشخص کردن فایل پایگاه‌داده (پیش‌فرض: ./semind.sqlite).
-v, --verbose: نمایش اطلاعات دربارهٔ کارهای در حال انجام.
-h, --help: نمایش این راهنما و خروج.

گزینه‌های ADD (ADD OPTIONS)

--include-local-syms: گنجاندن نمادهای محلی در نمایه.

گزینه‌های SEARCH (SEARCH OPTIONS)

-f, --format=STRING: مشخص کردن قالب خروجی. پیش‌فرض: '(%m) %f\t%l\t%c\t%C\t%s' (بخش FORMAT در زیر را ببینید).
-p, --path=PATTERN: جستجوی نمادها تنها در دایرکتوری‌های مشخص‌شده.
-m, --mode=MODE: جستجو تنها بر اساس نوع دسترسی مشخص‌شده (بخش MODE در زیر را ببینید).
-k, --kind=KIND: مشخص کردن نوع نماد (بخش KIND در زیر را ببینید).
-e, --explain: نمایش آنچه در موقعیت مشخص‌شده در فایل رخ می‌دهد؛
-l, --location: نمایش کاربرد نمادها از یک موقعیت مشخص در فایل؛
-v, --verbose: نمایش اطلاعات دربارهٔ کارهای در حال انجام؛
-h, --help: نمایش این راهنما و خروج.

قالب (FORMAT)

%m: حالت دسترسی در قالبی خوانا برای انسان (بخش MODE در زیر را ببینید).
%f: نام فایل.
%l: شماره خط.
%c: شماره ستون.
%C: نام تابعی که نماد در آن به کار رفته است.
%n: نام نماد.
%s: خط کد منبع. نمایه‌ساز خطوط کد منبع را ذخیره نمی‌کند؛ آن‌ها در حین جستجو از فایل خوانده می‌شوند.

نوع (KIND)

f: تابع (function)
s: strict
m: عضو ساختار (struct member)

حالت (MODE)

مقدار MODE به صورت یک رشتهٔ ۳ حرفی نمایش داده می‌شود. حرف اول نشان‌دهندهٔ آدرس بخش، دومی دسترسی از طریق مقدار (by value)، و سومی دسترسی از طریق اشاره‌گر (by pointer) است. مقدار ویژهٔ 'def' به معنی تعریف نماد است.

r: خواندن (read)
w: نوشتن (write)
m: خواندن و نوشتن (read and write)

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

sparse(1)

صفحه اصلی (HOMEPAGE)

https://sparse.docs.kernel.org

فهرست پستی (MAILING LIST)

linux-sparse@vger.kernel.org