.TH getc_putc 8
.SH "نام (NAME)"
getc_putc \- برنامه سنجش عملکرد با توابع getc و putc

.SH "خلاصه دستور (SYNOPSIS)"
.B getc_putc
.I [\-d dir] [\-s size(KiB)] [\-m machine\-name]
.I [\-u uid\-to\-use:gid\-to\-use] [\-g gid\-to\-use]

.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما به‌طور خلاصه برنامه
.B getc_putc
را معرفی می‌کند.
.PP
این ابزار یک مکمل ساده برای محک عملکرد (بنچمارک)
.B bonnie++
است. از آن برای سنجش روش‌های مختلف انجام ورودی/خروجی (I/O) به‌صورت بایت‌به‌بایت استفاده می‌شود؛ معمولاً نیازی به انجام مکرر این کار نیست تا به یک مسئله عملکردی تبدیل شود و تفاوت چندانی در شیوه انجام آن احساس گردد. با این حال گاهی اوقات این امر ضروری است (برای نمونه، هنگام تحلیل و خواندن ورودی/خروجی از ترمینال و سپس اجرای فرآیند دیگر که تمام ورودی/خروجی را بر عهده می‌گیرد، مانند یک پوسته ساده).
.PP
مزیت واقعی این ابزار کمک به پایان دادن به برخی مباحثات درباره کارایی این‌گونه موارد و آموزش افراد تازه‌کار در خصوص کندی شدید ورودی/خروجی بایت‌به‌بایت است.

.SH "گزینه‌ها (OPTIONS)"
در
.B getc_putc
هر گزینه به شکل یک خط تیره و به دنبال آن یک حرف است و پارامتر بعدی شامل مقدار آن می‌باشد.
.TP
.B \-d
دایرکتوری مورد استفاده برای آزمایش‌ها.
.TP
.B \-s
اندازه فایل برای سنجش عملکرد ورودی/خروجی بایتی بر حسب کیلوبایت. نکته: در صورت افزودن 'm' به انتهای عدد، می‌توانید اندازه را بر حسب مگابایت مشخص کنید.
.IP
حالت پیش‌فرض، انجام آزمون با یک فایل ۵۱۲ مگابایتی (512MiB) است. از این فایل تنها ۱/۶۴ آن برای فراخوانی‌های سیستمی
.B write()
و
.B read()
استفاده می‌شود (هر مقداری بیش از این بسیار زمان‌بر خواهد بود).

.TP
.B \-m
نام ماشین \- صرفاً برای نمایش در خروجی.

.TP
.B \-u
شناسه کاربری (UID) مورد استفاده. هنگام اجرا به عنوان ریشه، شناسه کاربری مورد استفاده برای آزمایش‌ها را مشخص می‌کند. اجرای این برنامه با دسترسی ریشه توصیه نمی‌شود؛ بنابراین در صورت نیاز قطعی به اجرا در حالت ریشه، از
.B \-u root
استفاده کنید. همچنین در صورت تمایل به تعیین گروه کاری، قالب
.B user:group
را به کار ببرید. اگر نام کاربر را بدون گروه وارد کنید، گروه اولیه همان کاربر انتخاب می‌شود. در صورت وارد کردن شناسه عددی کاربر بدون تعیین گروه، گروه کاری
.B nogroup
خواهد بود.

.TP
.B \-g
شناسه گروهی (GID) مورد استفاده. این گزینه مانند به‌کارگیری
.B :group
برای پارامتر
.B \-u
است و صرفاً روشی دیگر جهت سازگاری با سایر برنامه‌ها به شمار می‌رود.

.TP
.B \-q
حالت بی‌صدا (quiet). در صورت تعیین این گزینه، برخی از پیام‌های اطلاعاتی اضافی حذف می‌شوند. همچنین داده‌های CSV تنها خروجی در خروجی استاندارد خواهند بود و متن ساده به خروجی خطای استاندارد فرستاده می‌شود. این بدان معناست که برای ذخیره داده‌های CSV می‌توانید دستور
.B getc_putc \-q >> file.csv
را اجرا کنید.

.SH "خروجی (OUTPUT)"
خروجی اصلی به صورت متن ساده در ۸۰ ستون طراحی شده تا به راحتی در ایمیل جا گیرد و همچنین با نمایشگرهای بریل به خوبی کار کند.
.PP
نوع دوم خروجی به قالب CSV (مقادیر جداشده با کاما) است. این خروجی به آسانی در هر نرم‌افزار صفحه‌گسترده یا پایگاه داده قابل واردسازی است.
.PP
برای هر آزمایش، نتیجه به صورت سرعت بر حسب KiB/s گزارش می‌شود. زمان پردازنده (CPU) نمایش داده نمی‌شود زیرا فرض بر این است که ۹۹٪ از توان یک پردازنده (یا مقداری بسیار نزدیک به آن) را مصرف می‌کند.

.SH "نویسندگان (AUTHORS)"
این برنامه، صفحه راهنما و بسته دبیان آن توسط Russell Coker <russell@coker.com.au> نوشته شده است.
.PP
مستندات، اسکریپت‌های Perl و تمامی کدهای آزمون ایجاد هزاران فایل توسط Russell Coker نگاشته شده‌اند، اما کل بسته تحت حق‌نشر مشترک با Tim Bray قرار دارد.

.SH "سیگنال‌ها (SIGNALS)"
سیگنال SIGINT را پردازش کرده و پاک‌سازی انجام می‌دهد (که ممکن است کمی طول بکشد)؛ دریافت سیگنال دوم SIGINT یا یک SIGQUIT بلافاصله برنامه را متوقف خواهد کرد.
.PP
سیگنال‌های SIGXCPU و SIGXFSZ رفتاری مشابه SIGINT دارند.
.PP
سیگنال SIGHUP نادیده گرفته می‌شود.

.SH "در دسترس بودن (AVAILABILITY)"
کد منبع در آدرس http://www.coker.com.au/bonnie++ در دسترس است.
.PP
برای اطلاعات بیشتر به آدرس http://etbe.coker.com.au/category/benchmark مراجعه فرمایید.

.SH "همچنین ببینید (SEE ALSO)"
.BR bonnie++ (8),
.BR zcav (8)