.\" Copyright (c) 2018-2020 Robin Getz
.\" Copyright (c) 2018-2020 Analog Devices Inc.
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, see
.\" <http://www.gnu.org/licenses>.
.\" %%%LICENSE_END
.\"
.TH iio_stresstest 1 "24 December 2025" "libiio-0.26" "LibIIO Utilities"
.IX iio_stresstest
.SH "نام (NAME)"
iio_stresstest \- برنامه آزمون فشار برای Libiio
.SH "خلاصه دستور (SYNOPSIS)"
.B iio_stresstest
[
.I options
]
-u <uri>
.SH "توضیحات (DESCRIPTION)"
برنامه
.B iio_stresstest
یک ابزار تست فشار (stress-test) است که برای یافتن باگ‌ها در کتابخانه Libiio یا در دیمن Libiio (یعنی IIOD) استفاده می‌شود.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h, \-\-help
به
.I iio_stresstest
اعلام می‌کند که راهنما را نمایش داده و سپس خارج شود.
.TP
.B \-V, \-\-version
اطلاعات نسخه این برنامه
.I iio_stresstest
و نسخه کتابخانه libiio مورد استفاده را چاپ می‌کند. این گزینه برای آگاهی از به‌روز بودن نسخه کتابخانه و
.I iio_stresstest
روی سیستم، و همچنین هنگام گزارش باگ‌ها کاربرد دارد.
.TP
.B \-S, \-\-scan [backends]
پویش برای بافت‌های (contexts) موجود IIO؛ آرگومان اختیاری شامل بک‌اند(های) خاص 'ip'، 'usb' یا 'ip:usb' است.
گزینه‌های ویژه USB شامل Vendor ID و Product ID برای محدود کردن پویش به دستگاه‌های مشخص مانند 'usb=0456,b673' می‌باشد.
شناسه‌های vid و pid اعدادی در مبنای ۱۶ (هگزادسیمال، بدون نیاز به پیشوند) هستند؛ "*" تنها برای تطابق با هر pid استفاده می‌شود.
اگر هیچ آرگومانی داده نشود، تمام گزینه‌های در دسترس بررسی می‌شوند.
.TP
.B \-u, \-\-uri
شناسه یکنواخت منبع
.I (uri)
برای اتصال به دستگاه‌ها، که می‌تواند یکی از موارد زیر باشد:
.RS
.IP ip:[address]
آدرس شبکه، به صورت عددی (192.168.0.1) یا نام هاست شبکه.
.IP ip:
خالی؛ در صورت کامپایل با پشتیبانی zeroconf، دستگاه IIO را روی شبکه پیدا می‌کند.
.IP usb:[device:port:instance]
معمولاً از خروجی دستور
.B iio_stresstest -S
به دست می‌آید.
.IP serial:[port],[baud],[settings]
که کنترل‌شده هستند و باید با iiod (یا tinyiiod) در طرف دیگر درگاه سریال مطابقت داشته باشند.
.RS
.IP [port]
موردی شبیه به '/dev/ttyUSB0' در لینوکس و 'COM4' در ویندوز است.
.IP [baud]
معمولاً یکی از مقادیر 110، 300، 600، 1200، 2400، 4800، 9600، 14400، 19200، 38400، 57600، 115200 [پیش‌فرض]، 128000 یا 256000 است، اما می‌تواند از سیستمی به سیستم دیگر متفاوت باشد.
.IP [settings]
به طور معمول به صورت '8n1' پیکربندی می‌شود و توسط موارد زیر کنترل می‌گردد:
.RS
.IP data_bits:
(5، 6، 7، 8 [پیش‌فرض] یا 9)
.IP parity_bits:
('n' بدون توازن [پیش‌فرض]، 'o' فرد، 'e' زوج، 'm' نشانه یا 's' فاصله)
.IP stop_bits:
(1 [پیش‌فرض] یا 2)
.IP flow_control:
('0' بدون کنترل جریان [پیش‌فرض]، 'x' نرم‌افزاری Xon Xoff، 'r' سخت‌افزاری RTSCTS یا 'd' سخت‌افزاری DTRDSR)
.RE
.RE
.IP local:
بدون بخش آدرس.
.RE
.TP
.B \-a, \-\-auto
پویش برای بافت‌های موجود و استفاده از آن در صورت وجود تنها یک بافت.
.TP
.B \-T, \-\-timeout <arg>
مدت‌زمان انتظار بافت (timeout) بر حسب میلی‌ثانیه. مقدار 0 به معنی بدون محدودیت زمانی است (انتظار نامحدود).
.TP
.B \-b, \-\-buffer\-size <arg>
اندازه بافر دریافت نمونه (capture buffer). مقدار پیش‌فرض 256 است.
.TP
.B \-s, \-\-samples <arg>
تعداد نمونه‌ها برای دریافت؛ 0 به معنی نامحدود است. مقدار پیش‌فرض 0 می‌باشد.
.TP
.B \-d, \-\-duration <arg>
زمان انتظار (به ثانیه) پیش از توقف تمام ریسه‌ها (threads).
.TP
.B \-t, \-\-threads <arg>
تعداد ریسه‌های (threads) مورد استفاده.
.TP
.B \-v, \-\-verbose
افزایش سطح جزئیات خروجی (استفاده از -vv و -vvv برای نمایش جزئیات بیشتر).

.SH "مقدار بازگشتی (RETURN VALUE)"
اگر دستگاه مشخص‌شده یافت نشود، یک کد خروج غیر صفر برگردانده می‌شود.

.SH "همچنین ببینید (SEE ALSO)"
.ad l
.BR iio_attr (1),
.BR iio_info (1),
.BR iio_readdev (1),
.BR iio_reg (1),
.BR iio_writedev (1),
.BR libiio (3)
.PP
صفحه خانگی libiio:
.BR \%https://wiki.analog.com/resources/tools-software/linux-software/libiio
.PP
کد منبع libiio:
.BR \%https://github.com/analogdevicesinc/libiio
.PP
مستندات Doxygen برای libiio:
.BR \%https://analogdevicesinc.github.io/libiio
.SH "گزارش باگ‌ها (REPORTING BUGS)"
تمام باگ‌ها در پیوند زیر پیگیری می‌شوند:
.BR \%https://github.com/analogdevicesinc/libiio/issues