.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "LLVM-EXTRACT" "1" "2026-07-15" "22" "LLVM"
.SH "نام (NAME)"
llvm-extract \- استخراج یک تابع از یک ماژول LLVM
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBllvm\-extract\fP [\fIoptions\fP] \fB\-\-func\fP \fIfunction\-name\fP [\fIfilename\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBllvm\-extract\fP نام یک تابع را دریافت کرده و آن را از فایل بیت‌کد (bitcode)
مشخص‌شدهٔ LLVM استخراج می‌کند. این دستور عمدتاً به عنوان ابزاری برای اشکال‌زدایی
جهت کوچک کردن نمونه‌های آزمایشی از برنامه‌های بزرگ‌تری که باگی را تحریک می‌کنند،
به کار می‌رود.
.sp
علاوه بر استخراج بیت‌کد تابع مشخص‌شده، \fBllvm\-extract\fP همچنین متغیرهای سراسری
غیرقابل‌دسترس، پیش‌نمونه‌ها (prototypes) و انواع استفاده‌نشده را حذف می‌کند.
.sp
دستور \fBllvm\-extract\fP ورودی خود را در صورتی که filename حذف شده باشد یا برابر
با \fB\-\fP\& باشد، از ورودی استاندارد می‌خواند. خروجی همیشه در خروجی استاندارد نوشته
می‌شود، مگر اینکه گزینهٔ \fB\-o\fP مشخص شده باشد (به ادامه مراجعه کنید).
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-\-alias\fP \fIalias\-name\fP
.INDENT 0.0
.INDENT 3.5
نام مستعار (alias) با نام \fIfunction\-name\fP را از بیت‌کد LLVM استخراج می‌کند. می‌تواند
چندین بار برای استخراج هم‌زمان چند نام مستعار مشخص شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-ralias\fP \fIalias\-regular\-expr\fP
.INDENT 0.0
.INDENT 3.5
نام‌های مستعار منطبق با \fIalias\-regular\-expr\fP را از بیت‌کد LLVM استخراج می‌کند.
تمام نام‌های مستعار منطبق با عبارت منظم استخراج خواهند شد. می‌تواند چندین بار
مشخص شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-bb\fP \fIbasic\-block\-specifier\fP
.INDENT 0.0
.INDENT 3.5
بلوک(های) پایهٔ مشخص‌شده در \fIbasic\-block\-specifier\fP\& را استخراج می‌کند. می‌تواند
چندین بار مشخص شود. هر جفت مشخص‌کنندهٔ <function:bb[;bb]> یک تابع ایجاد خواهد کرد.
اگر چندین بلوک پایه در یک جفت مشخص شوند، اولین بلوک در این دنباله باید بر بقیه
غالب (dominate) باشد.
.UNINDENT
.UNINDENT
.sp
\fB\-\-delete\fP
.INDENT 0.0
.INDENT 3.5
متغیرهای سراسری (Globals) مشخص‌شده را از ماژول حذف می‌کند.
.UNINDENT
.UNINDENT
.sp
\fB\-f\fP
.INDENT 0.0
.INDENT 3.5
فعال‌سازی خروجی باینری روی ترمینال‌ها. در حالت عادی، اگر جریان خروجی یک ترمینال
باشد، \fBllvm\-extract\fP از نوشتن خروجی خام بیت‌کد خودداری می‌کند. با این گزینه،
\fBllvm\-extract\fP خروجی خام بیت‌کد را بدون در نظر گرفتن دستگاه خروجی خواهد نوشت.
.UNINDENT
.UNINDENT
.sp
\fB\-\-func\fP \fIfunction\-name\fP
.INDENT 0.0
.INDENT 3.5
تابع با نام \fIfunction\-name\fP را از بیت‌کد LLVM استخراج می‌کند. می‌تواند چندین بار
برای استخراج هم‌زمان چند تابع مشخص شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-rfunc\fP \fIfunction\-regular\-expr\fP
.INDENT 0.0
.INDENT 3.5
تابع(های) منطبق با \fIfunction\-regular\-expr\fP را از بیت‌کد LLVM استخراج می‌کند.
تمام توابع منطبق با عبارت منظم استخراج خواهند شد. می‌تواند چندین بار مشخص شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-glob\fP \fIglobal\-name\fP
.INDENT 0.0
.INDENT 3.5
متغیر سراسری با نام \fIglobal\-name\fP را از بیت‌کد LLVM استخراج می‌کند. می‌تواند چندین
بار برای استخراج هم‌زمان چند متغیر سراسری مشخص شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-rglob\fP \fIglob\-regular\-expr\fP
.INDENT 0.0
.INDENT 3.5
متغیر(های) سراسری منطبق با \fIglobal\-regular\-expr\fP را از بیت‌کد LLVM استخراج می‌کند.
تمام متغیرهای سراسری منطبق با عبارت منظم استخراج خواهند شد. می‌تواند چندین بار
مشخص شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-keep\-const\-init\fP
.INDENT 0.0
.INDENT 3.5
مقادیر متغیرهای سراسری ثابت (constant globals) را حفظ می‌کند.
.UNINDENT
.UNINDENT
.sp
\fB\-\-recursive\fP
.INDENT 0.0
.INDENT 3.5
استخراج بازگشتی تمام توابع فراخوانی‌شده.
.UNINDENT
.UNINDENT
.sp
\fB\-help\fP
.INDENT 0.0
.INDENT 3.5
چاپ خلاصه‌ای از گزینه‌های خط فرمان.
.UNINDENT
.UNINDENT
.sp
\fB\-o\fP \fIfilename\fP
.INDENT 0.0
.INDENT 3.5
نام فایل خروجی را مشخص می‌کند. اگر filename برابر \(dq\-\(dq باشد (پیش‌فرض)، آنگاه
\fBllvm\-extract\fP خروجی خود را به خروجی استاندارد می‌فرستد.
.UNINDENT
.UNINDENT
.sp
\fB\-S\fP
.INDENT 0.0
.INDENT 3.5
نوشتن خروجی در زبان میانی LLVM (به جای بیت‌کد).
.UNINDENT
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
اگر \fBllvm\-extract\fP با موفقیت اجرا شود، با کد 0 خارج می‌شود. در غیر این صورت،
اگر خطایی رخ دهد، با مقداری غیر صفر خارج خواهد شد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBbugpoint(1) \%<bugpoint\:.html>\fP
.SH "نویسندگان (AUTHORS)"
توسط تیم LLVM نگهداری می‌شود (<https://llvm.org>).
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2003-2026, LLVM Project
.\" End of generated man page.