.TH "LSHW" "1" "15 October 2020" "lshw" "دستورات کاربر"
.SH "نام (NAME)"
lshw \- فهرست کردن اطلاعات سخت‌افزار
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBlshw\fR [ \fB\-version\fR ]
.sp
\fBlshw\fR [ \fB\-help\fR ]
.sp
\fBlshw\fR [ \fB\-X\fR ]
.sp
\fBlshw\fR [ \fB [ \-html ]  [ \-short ]  [ \-xml ]  [ \-json ]  [ \-businfo ] \fR ]  [ \fB\-dump \fIfilename\fB\fR ]  [ \fB\-class \fIclass\fB\fR\fI...\fR ]  [ \fB\-disable \fItest\fB\fR\fI...\fR ]  [ \fB\-enable \fItest\fB\fR\fI...\fR ]  [ \fB\-sanitize\fR ]  [ \fB\-numeric\fR ]  [ \fB\-quiet\fR ]  [ \fB\-notime\fR ]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBlshw\fR
ابزاری کوچک برای استخراج اطلاعات دقیق در مورد پیکربندی سخت‌افزاری دستگاه است. این ابزار می‌تواند پیکربندی دقیق حافظه، نسخه سفت‌افزار (firmware)، پیکربندی برد اصلی (mainboard)، نسخه و سرعت پردازنده (CPU)، پیکربندی حافظه نهان (cache)، سرعت گذرگاه (bus) و موارد دیگر را در سیستم‌های مبتنی بر x86 یا IA-64 دارای قابلیت DMI و در برخی سیستم‌های PowerPC (دستگاه PowerMac G4 پشتیبانی می‌شود) گزارش دهد.
.PP
در حال حاضر این برنامه از DMI (فقط x86 و IA-64)، درخت دستگاه OpenFirmware (فقط PowerPC)، گذرگاه‌های PCI/AGP، شناسه پردازنده CPUID (در x86)، واسط‌های IDE/ATA/ATAPI، کارت‌های PCMCIA (فقط روی x86 آزمایش شده)، SCSI و USB پشتیبانی می‌کند\&.
.PP
.TP
\fB\-version\fR
نسخه \fBlshw\fR را نمایش داده و خارج می‌شود.
.TP
\fB\-help\fR
گزینه‌های خط فرمان موجود را نمایش داده و خارج می‌شود.
.TP
\fB\-X\fR
رابط کاربری گرافیکی X11 را اجرا می‌کند (در صورت در دسترس بودن).
.TP
\fB\-html\fR
درخت دستگاه‌ها را در قالب یک صفحه HTML خروجی می‌دهد.
.TP
\fB\-xml\fR
درخت دستگاه‌ها را در قالب یک درخت XML خروجی می‌دهد.
.TP
\fB\-json\fR
درخت دستگاه‌ها را در قالب یک شیء JSON (نشانه‌گذاری اشیاء جاوااسکریپت) خروجی می‌دهد.
.TP
\fB\-short\fR
درخت دستگاه‌ها را همراه با مسیرهای سخت‌افزاری نمایش می‌دهد؛ بسیار شبیه به خروجی ابزار \fBioscan\fR در سیستم‌عامل HP-UX\&.
.TP
\fB\-businfo\fR
فهرست دستگاه‌ها را همراه با اطلاعات گذرگاه با ذکر جزئیات آدرس‌های SCSI، USB، IDE و PCI خروجی می‌دهد.
.TP
\fB\-dump \fIfilename\fB\fR
خروجی را نمایش داده و اطلاعات جمع‌آوری‌شده را درون یک فایل (پایگاه‌داده SQLite) ذخیره می‌کند.
.TP
\fB\-class \fIclass\fB\fR
تنها کلاس مشخص‌شده سخت‌افزار را نمایش می‌دهد. مقدار \fIclass\fR را می‌توان با استفاده از \fBlshw \-short\fR یا \fBlshw \-businfo\fR پیدا کرد\&.
.TP
\fB\-C \fIclass\fB\fR
نام مستعار برای \fB\-class\fR \fIclass\fR\&.
.TP
\fB\-enable \fItest\fB\fR
.TP
\fB\-disable \fItest\fB\fR
یک آزمون را فعال یا غیرفعال می‌کند. مقدار \fItest\fR می‌تواند \fBdmi\fR (برای افزونه‌های DMI/SMBIOS)، \fBdevice-tree\fR (برای درخت دستگاه OpenFirmware)، \fBspd\fR (برای تشخیص حضور سریال حافظه یا Serial Presence Detect)، \fBmemory\fR (برای روش‌های حدس اندازه حافظه)، \fBcpuinfo\fR (برای شناسایی پردازنده گزارش‌شده توسط هسته)، \fBcpuid\fR (برای شناسایی پردازنده)، \fBpci\fR (برای دسترسی به PCI/AGP)، \fBisapnp\fR (برای افزونه‌های ISA PnP)، \fBpcmcia\fR (برای PCMCIA/PCCARD)، \fBide\fR (برای IDE/ATAPI)، \fBusb\fR (برای دستگاه‌های USB)، \fBscsi\fR (برای SCSI) یا \fBnetwork\fR (برای شناسایی رابط‌های شبکه) باشد.
.TP
\fB\-quiet\fR
عدم نمایش وضعیت (حالت بی‌صدا).
.TP
\fB\-sanitize\fR
اطلاعات بالقوه حساس را از خروجی حذف می‌کند (آدرس‌های IP، شماره سریال‌ها و غیره).
.TP
\fB\-numeric\fR
شناسه‌های عددی را نیز نمایش می‌دهد (برای دستگاه‌های PCI و USB).
.TP
\fB\-notime\fR
ویژگی‌های ناپایدار (برچسب‌های زمان) را از خروجی حذف می‌کند.
.SH "اشکالات (BUGS)"
.PP
در حال حاضر \fBlshw\fR دستگاه‌های فایروایر (Firewire یا IEEE1394) را شناسایی نمی‌کند.
.PP
تمام معماری‌های پشتیبانی‌شده توسط گنو/لینوکس به طور کامل پشتیبانی نمی‌شوند (مانند شناسایی پردازنده).
.PP
رابط‌های SCSI «مجازی» که برای شبیه‌سازی SCSI روی IDE استفاده می‌شوند، هنوز به‌درستی گزارش داده نمی‌شوند.
.SH "نکات (NOTES)"
.PP
دستور \fBlshw\fR باید توسط کاربر ارشد (مدیر سیستم یا ریشه) اجرا شود، در غیر این صورت تنها اطلاعات ناقصی را گزارش خواهد داد.
.SH "فایل‌ها (FILES)"
.PP
.TP
\fB/usr/local/share/pci.ids\fR
.TP
\fB/usr/share/pci.ids\fR
.TP
\fB/etc/pci.ids\fR
.TP
\fB/usr/share/hwdata/pci.ids\fR
فهرستی از تمام شناسه‌های شناخته‌شده PCI (تولیدکنندگان، دستگاه‌ها، کلاس‌ها و زیرکلاس‌ها).
اگر برنامه با پشتیبانی از zlib کامپایل شده باشد، lshw ابتدا به دنبال \fIpci.ids.gz\fR و سپس به دنبال \fIpci.ids\fR خواهد گشت\&.
.TP
\fB/proc/bus/pci/*\fR
برای دسترسی به پیکربندی گذرگاه‌ها و دستگاه‌های PCI نصب‌شده استفاده می‌شود.
.TP
\fB/proc/ide/*\fR
برای دسترسی به پیکربندی گذرگاه‌ها و دستگاه‌های IDE نصب‌شده استفاده می‌شود.
.TP
\fB/proc/scsi/*, /dev/sg*\fR
برای دسترسی به پیکربندی دستگاه‌های SCSI نصب‌شده استفاده می‌شود.
.TP
\fB/dev/cpu/*/cpuid\fR
در پلتفرم‌های x86 برای دسترسی به پیکربندی اختصاصی پردازنده (CPU) استفاده می‌شود.
.TP
\fB/proc/device-tree/*\fR
در پلتفرم‌های PowerPC برای دسترسی به پیکربندی OpenFirmware استفاده می‌شود.
.TP
\fB/proc/bus/usb/*\fR
برای دسترسی به پیکربندی گذرگاه‌ها و دستگاه‌های USB نصب‌شده استفاده می‌شود.
.TP
\fB/sys/*\fR
در هسته‌های نگارش ۲٫۶ به بالا برای دسترسی به اطلاعات پیکربندی سخت‌افزار/راه‌انداز استفاده می‌شود.
.SH "مثال‌ها (EXAMPLES)"
.PP
.TP
\fBlshw \-short\fR
فهرست کردن سخت‌افزار در قالبی فشرده.
.TP
\fBlshw \-class disk \-class storage\fR
فهرست کردن تمام دیسک‌ها و کنترل‌کننده‌های ذخیره‌سازی موجود در سیستم.
.TP
\fBlshw \-html \-class network\fR
فهرست کردن تمام رابط‌های شبکه در قالب HTML.
.TP
\fBlshw \-disable dmi\fR
عدم استفاده از DMI برای شناسایی سخت‌افزار.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fI/proc/*\fR, \fBlinuxinfo\fR(1), \fBlspci\fR(8), \fBlsusb\fR(8)
.SH "حق نشر (COPYING)"
.PP
برنامه \fBlshw\fR تحت مجوز عمومی همگانی گنو (GPL) نسخه ۲ توزیع می‌شود.
.SH "نویسنده (AUTHOR)"
.PP
برنامه \fBlshw\fR توسط لیونل وینسنت (Lyonel Vincent)
<lyonel@ezix.org>\& نگهداری می‌شود.
.SH "سایر اطلاعات (OTHER INFO)"
.PP
صفحه وب مربوط به \fBlshw\fR در نشانی زیر در دسترس است:
<URL:http://lshw.ezix.org>