'\" t
.\"     Title: lscpu
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: دستورات کاربر
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "LSCPU" "1" "2026-09-02" "util\-linux 2.42.3" "دستورات کاربر"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
lscpu \- نمایش اطلاعات مربوط به معماری پردازنده (CPU)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBlscpu\fP [گزینه‌ها]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBlscpu\fP اطلاعات مربوط به معماری پردازنده را از \fIsysfs\fP، \fI/proc/cpuinfo\fP و هرگونه کتابخانه مختص معماری کاربردی (مانند \fBlibrtas\fP در Powerpc) جمع‌آوری می‌کند. خروجی دستور را می‌توان برای تجزیه خودکار (parsing) یا برای خوانایی آسان توسط انسان بهینه‌سازی کرد. این اطلاعات برای مثال شامل تعداد پردازنده‌ها، ریسه‌ها (threads)، هسته‌ها، سوکت‌ها و گره‌های NUMA (دسترسی به حافظه غیریکنواخت) است. همچنین اطلاعاتی درباره حافظه‌های پنهان (cache) پردازنده و اشتراک‌گذاری آن‌ها، خانواده، مدل، bogoMIPS، ترتیب بایت‌ها (byte order)، گام/استپینگ (stepping) و نسخه میکروکد (microcode) ارائه می‌شود.
.sp
قالب‌بندی خروجی پیش‌فرض در ترمینال ممکن است تغییر کند و احتمالاً برای خوانایی بهتر بهینه‌سازی شود. خروجی‌های غیرترمینالی (مانند لوله‌ها یا پایپ‌ها) هرگز تحت تأثیر این بهینه‌سازی قرار نمی‌گیرند و همیشه در قالب "Field: data\(rsn" خواهند بود. برای مثال از "\fBlscpu | less\fP" برای مشاهده خروجی پیش‌فرض بدون بهینه‌سازی‌ها استفاده کنید.
.sp
در محیط‌های مجازی‌سازی‌شده، اطلاعات معماری پردازنده نمایش‌داده‌شده بیانگر پیکربندی سیستم‌عامل مهمان (guest) است که معمولاً با سیستم فیزیکی (میزبان یا host) تفاوت دارد. در معماری‌هایی که از بازیابی اطلاعات توپولوژی فیزیکی پشتیبانی می‌کنند، \fBlscpu\fP همچنین تعداد سوکت‌ها، تراشه‌ها و هسته‌های فیزیکی در سیستم میزبان را نمایش می‌دهد.
.sp
گزینه‌هایی که یک جدول خروجی تولید می‌کنند، یک آرگومان اختیاری به صورت \fIlist\fP (فهرست) می‌پذیرند. این آرگومان \fIlist\fP رشته‌ای از برچسب‌های ستون است که با کاما از هم جدا شده‌اند تا جدول را تنها به ستون‌های مشخص‌شده و به همان ترتیب تعیین‌شده محدود کند. برای دیدن فهرستی از برچسب‌های ستون معتبر از \fB\-\-help\fP استفاده کنید. برچسب‌ها به بزرگی و کوچکی حروف حساس نیستند. همه ستون‌ها در تمام معماری‌ها پشتیبانی نمی‌شوند. اگر ستونی پشتیبانی‌نشده مشخص شود، \fBlscpu\fP ستون را چاپ می‌کند اما هیچ داده‌ای برای آن ارائه نمی‌دهد.
.sp
اندازه‌های حافظه پنهان (cache) به عنوان خلاصه‌ای از تمام پردازنده‌ها گزارش می‌شوند. نسخه‌های پیش از v2.34 اندازه‌ها را به ازای هر هسته گزارش می‌کردند، اما این خروجی به دلیل توپولوژی پیچیده پردازنده و نحوه اشتراک‌گذاری حافظه‌های پنهان بین پردازنده‌ها گیج‌کننده بود. برای جزئیات بیشتر درباره حافظه‌های پنهان به \fB\-\-caches\fP مراجعه کنید. از نسخه v2.37 به بعد، \fBlscpu\fP از شناسه‌های حافظه پنهان مطابق با آنچه توسط هسته لینوکس ارائه می‌شود پیروی می‌کند و این شناسه‌ها همیشه از صفر شروع نمی‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-a\fP، \fB\-\-all\fP
.RS 4
گنجاندن خطوط مربوط به پردازنده‌های برخط (online) و برون‌خط (offline) در خروجی (پیش‌فرض برای \fB\-e\fP). این گزینه تنها می‌تواند همراه با گزینه \fB\-e\fP یا \fB\-p\fP مشخص شود.
.RE
.sp
\fB\-B\fP، \fB\-\-bytes\fP
.RS 4
چاپ اندازه‌ها بر حسب بایت به جای قالب خوانا برای انسان.
.sp
به طور پیش‌فرض، اندازه‌ها با واحدهایی از توان‌های ۱۰۲۴ بایت نمایش داده می‌شوند. اختصارات رسمی این واحدها (KiB، MiB، GiB، .\|.\|.) سپس تنها با حرف اول آن‌ها خلاصه می‌شوند: K، M، G، .\|.\|..
.RE
.sp
\fB\-b\fP، \fB\-\-online\fP
.RS 4
محدود کردن خروجی به پردازنده‌های برخط (پیش‌فرض برای \fB\-p\fP). این گزینه تنها می‌تواند همراه با گزینه \fB\-e\fP یا \fB\-p\fP مشخص شود.
.RE
.sp
\fB\-C\fP، \fB\-\-caches\fP[\fB=\fP\fIlist\fP]
.RS 4
نمایش جزئیات درباره حافظه‌های پنهان پردازنده. برای جزئیات درباره اطلاعات موجود، خروجی \fB\-\-list\-columns\fP را ببینید.
.sp
اگر آرگومان \fIlist\fP حذف شود، تمام ستون‌هایی که داده‌ای برای آن‌ها موجود است در خروجی دستور گنجانده می‌شوند.
.sp
هنگام مشخص کردن آرگومان \fIlist\fP، رشته گزینه، علامت مساوی (=) و \fIlist\fP نباید حاوی هیچ فاصله خالی (whitespace) باشند. مثال‌ها: \fB\-C=NAME,ONE\-SIZE\fP یا \fB\-\-caches=NAME,ONE\-SIZE\fP.
.sp
فهرست پیش‌فرض ستون‌ها را می‌توان در صورتی که فهرست در قالب +list مشخص شود گسترش داد (به عنوان مثال، \fBlscpu \-C=+ALLOC\-POLICY\fP).
.RE
.sp
\fB\-c\fP، \fB\-\-offline\fP
.RS 4
محدود کردن خروجی به پردازنده‌های برون‌خط. این گزینه تنها می‌تواند همراه با گزینه \fB\-e\fP یا \fB\-p\fP مشخص شود.
.RE
.sp
\fB\-e\fP، \fB\-\-extended\fP[\fB=\fP\fIlist\fP]
.RS 4
نمایش اطلاعات پردازنده در قالب خوانا برای انسان.
.sp
اگر آرگومان \fIlist\fP حذف شود، ستون‌های پیش‌فرض در خروجی دستور گنجانده می‌شوند. خروجی پیش‌فرض ممکن است تغییر کند.
.sp
هنگام مشخص کردن آرگومان \fIlist\fP، رشته گزینه، علامت مساوی (=) و \fIlist\fP نباید حاوی هیچ فاصله خالی باشند. مثال‌ها: \fB\-e=cpu,node\fP یا \fB\-\-extended=cpu,node\fP.
.sp
فهرست پیش‌فرض ستون‌ها را می‌توان در صورتی که فهرست در قالب +list مشخص شود گسترش داد (به عنوان مثال، \fBlscpu \-e=+MHZ\fP).
.RE
.sp
\fB\-H\fP، \fB\-\-list\-columns\fP
.RS 4
فهرست کردن ستون‌هایی که می‌توان با گزینه‌های \fB\-\-extended\fP، \fB\-\-parse\fP و \fB\-\-caches\fP مشخص کرد. می‌توان آن را همراه با \fB\-\-json\fP یا \fB\-\-raw\fP برای دریافت فهرست در قالبی خوانا برای ماشین استفاده کرد.
.RE
.sp
\fB\-\-hierarchic\fP[\fB=\fP\fIwhen\fP]
.RS 4
استفاده از زیربخش‌ها در خروجی خلاصه. برای سازگاری با گذشته، حالت پیش‌فرض این است که زیربخش‌ها تنها هنگام خروجی در ترمینال استفاده شوند و در خروجی‌های غیرترمینالی از خروجی مسطح (تخت) استفاده شود. آرگومان اختیاری \fIwhen\fP می‌تواند \fBnever\fP، \fBalways\fP یا \fBauto\fP باشد. اگر آرگومان \fIwhen\fP حذف شود، مقدار پیش‌فرض آن \fBalways\fP است.
.RE
.sp
\fB\-J\fP، \fB\-\-json\fP
.RS 4
استفاده از قالب خروجی JSON برای خلاصه پیش‌فرض یا خروجی گسترش‌یافته (نگاه کنید به \fB\-\-extended\fP). برای سازگاری با گذشته، خروجی JSON از رفتار خلاصه پیش‌فرض در خروجی‌های غیرترمینالی پیروی می‌کند که در آن زیربخش‌ها وجود ندارند. همچنین نگاه کنید به \fB\-\-hierarchic\fP.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
خروجی دادن تمام ستون‌های موجود. این گزینه باید با یکی از گزینه‌های \fB\-\-extended\fP، \fB\-\-parse\fP یا \fB\-\-caches\fP ترکیب شود.
.RE
.sp
\fB\-p\fP، \fB\-\-parse\fP[\fB=\fP\fIlist\fP]
.RS 4
بهینه‌سازی خروجی دستور برای تجزیه خودکار (parsing) آسان.
.sp
اگر آرگومان \fIlist\fP حذف شود، خروجی دستور با نسخه‌های پیشین \fBlscpu\fP سازگار خواهد بود. در این قالب سازگار، از دو کاما برای جداسازی ستون‌های حافظه پنهان پردازنده استفاده می‌شود. اگر هیچ حافظه پنهانی برای پردازنده شناسایی نشود، ستون حافظه پنهان حذف می‌شود. اگر از آرگومان \fIlist\fP استفاده شود، ستون‌های حافظه پنهان با دو نقطه (:) از هم جدا می‌شوند.
.sp
هنگام مشخص کردن آرگومان \fIlist\fP، رشته گزینه، علامت مساوی (=) و \fIlist\fP نباید حاوی هیچ فاصله خالی باشند. مثال‌ها: \fB\-p=cpu,online,mhz\fP یا \fB\-\-parse=cpu,online,mhz\fP.
.sp
فهرست پیش‌فرض ستون‌ها را می‌توان در صورتی که فهرست در قالب +list مشخص شود گسترش داد (به عنوان مثال، \fBlscpu \-p=+MHZ\fP).
.RE
.sp
\fB\-r\fP، \fB\-\-raw\fP
.RS 4
تولید خروجی در قالب خام آن. این گزینه فقط برای خروجی‌های \fB\-\-extended\fP، \fB\-\-parse\fP و \fB\-\-caches\fP کاربرد دارد.
.RE
.sp
\fB\-s\fP، \fB\-\-sysroot\fP \fIdirectory\fP
.RS 4
جمع‌آوری داده‌های پردازنده برای یک نمونه لینوکس غیر از نمونه‌ای که دستور \fBlscpu\fP از آن اجرا شده است. \fIdirectory\fP مشخص‌شده، ریشه سیستم (system root) نمونه لینوکسی است که باید بررسی شود.
.RE
.sp
\fB\-x\fP، \fB\-\-hex\fP
.RS 4
استفاده از ماسک‌های هگزادسیمال (شانزده‌شانزدهی) برای مجموعه‌های پردازنده (به عنوان مثال "ff"). حالت پیش‌فرض، چاپ مجموعه‌ها در قالب فهرست است (به عنوان مثال 0,1). توجه داشته باشید که پیش از نسخه 2.30، ماسک با پیشوند 0x چاپ می‌شد.
.RE
.sp
\fB\-y\fP، \fB\-\-physical\fP
.RS 4
نمایش شناسه‌های فیزیکی برای تمام ستون‌های دارای عناصر توپولوژی (هسته، سوکت، و غیره). بر خلاف شناسه‌های منطقی که توسط \fBlscpu\fP تخصیص می‌یابند، شناسه‌های فیزیکی مقادیر مختص به پلتفرم هستند که توسط هسته ارائه می‌شوند. شناسه‌های فیزیکی لزوماً یکتا نیستند و ممکن است به صورت متوالی مرتب نشده باشند. اگر هسته نتواند شناسه فیزیکی یک عنصر را بازیابی کند، \fBlscpu\fP نویسه خط پیوند (\-) را چاپ می‌کند.
.sp
شماره‌های منطقی پردازنده تحت تأثیر این گزینه قرار نمی‌گیرند.
.RE
.sp
\fB\-\-arm\-id\fP[\fB=\fP\fIlist\fP]
.RS 4
چاپ فهرستی از پیاده‌سازان (سازندگان) شناخته‌شده هسته‌های ARM و نام‌های خوانا برای انسان آن‌ها.
.sp
اگر آرگومانی داده شود، فهرستی از شناسه‌های هسته‌های مجزا و نام‌های آن‌ها برای پیاده‌ساز مشخص‌شده چاپ می‌شود.
.RE
.sp
\fB\-\-arm\-model\fP \fIid\fP
.RS 4
چاپ نام این مدل خاص از هسته. این گزینه نیازمند ارسال \fB\-\-arm\-id=\fIid\fR برای مشخص کردن شناسه پیاده‌ساز نیز هست.
.RE
.sp
\fB\-\-annotate\fP[\fB=\fP\fIwhen\fP]
.RS 4
افزودن حاشیه‌نویسی (annotation) به نام سرایند هر ستون. این حاشیه‌نویسی می‌تواند به صورت یک راهنمای متنی (tooltip) توسط ترمینال‌هایی که از این ویژگی پشتیبانی می‌کنند نمایش داده شود. آرگومان اختیاری \fIwhen\fP می‌تواند \fBalways\fP، \fBnever\fP یا \fBauto\fP باشد. اگر این آرگومان حذف شود، به طور پیش‌فرض روی \fBauto\fP تنظیم می‌شود، به این معنی که حاشیه‌نویسی‌ها فقط زمانی که خروجی به یک ترمینال ارسال می‌شود استفاده خواهند شد.
.RE
.sp
\fB\-h\fP، \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP، \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "محیط (ENVIRONMENT)"
.sp
LSCPU_COLUMNS=
.RS 4
فهرستی از ستون‌های خروجی جداشده با کاما را برای چاپ مشخص می‌کند. تمام ستون‌های فهرست‌شده توسط \fB\-\-list\-columns\fP را می‌توان برای گزینه‌های \fB\-e\fP و \fB\-p\fP استفاده کرد.
.RE
.sp
LSCPU_CACHES_COLUMNS=
.RS 4
مشابه \fBLSCPU_COLUMNS\fP، با این تفاوت که تنها ستون‌های فهرست‌شده را می‌توان برای گزینه \fB\-C\fP استفاده کرد.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
خروجی اشکال‌زدایی libsmartcols را فعال می‌کند.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
از نویسه‌های فاصله‌گذاری مرئی (visible padding) استفاده می‌کند.
.RE
.SH "ستون‌ها (COLUMNS)"
.sp
فهرستی از برچسب‌های ستون معتبر را می‌توان با استفاده از گزینه \fB\-\-list\-columns\fP نمایش داد.
.SH "نکات (NOTES)"
.sp
خروجی پیش‌فرض ممکن است تغییر کند. بنابراین تا جای ممکن باید از استفاده از خروجی پیش‌فرض در اسکریپت‌های خود خودداری کنید.
.SH "اشکالات (BUGS)"
.sp
نمای کلی اولیه مدل‌های پردازنده بر اساس روش‌های اکتشافی (heuristic) است و تفاوت‌هایی مانند نام مدل پردازنده و شناسه‌های پیاده‌ساز را در نظر می‌گیرد. در برخی موارد (غیرعادی)، ممکن است پردازنده‌ها در پرچم‌ها (flags) یا BogoMIPS تفاوت داشته باشند، اما این تفاوت‌ها در نمای کلی lscpu نادیده گرفته می‌شوند.
.sp
گاهی اوقات در Xen Dom0، هسته داده‌های نادرست گزارش می‌دهد.
.sp
در ماشین‌های مجازی، تعداد هسته‌ها به ازای هر سوکت و غیره ممکن است نادرست باشد.
.SH "نویسندگان (AUTHORS)"
.sp
.MTO "qcai\(atredhat.com" "Cai Qian" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ","
.MTO "heiko.carstens\(atde.ibm.com" "Heiko Carstens" ","
.MTO "cgoesc2\(atwgu.edu" "Christian Goeschel Ndjomouo" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBchcpu\fP(8)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "ردیاب مشکلات" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBlscpu\fP بخشی از بسته util\-linux است که می‌تواند از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت شود.