.\"     # DS - begin display
.de DS
.RS
.nf
.sp
..
.\"     # DE - end display
.de DE
.fi
.RE
.sp
..
.TH rlm_counter 5 "13 March 2004" "" "FreeRADIUS Module"
.SH "نام (NAME)"
rlm_counter \- ماژول شمارندهٔ FreeRADIUS
.SH "توضیحات (DESCRIPTION)"
ماژول
\fIrlm_counter\fP
یک چارچوب کلی برای مجاز کردن دسترسی بر اساس میزان مصرف انباشته‌شده از یک منبع (مانند کل زمان آنلاین بودن در یک دورهٔ مشخص، کل داده‌های منتقل‌شده در یک دورهٔ مشخص و غیره) فراهم می‌کند. این قابلیت در سناریوهای «سرویس‌های پیش‌پرداخت» بسیار مفید است؛ جایی که کاربر برای مقدار محدودی از مصرف هزینه پرداخت کرده است و نباید اجازه داشته باشد فراتر از آن سرویس استفاده کند. جمع‌آوری، نظارت و شارژ مجدد سرویس‌های پیش‌پرداخت خارج از محدودهٔ وظایف این ماژول است.
.PP
مهم‌ترین موارد پیکربندی که باید از آن‌ها آگاه باشید عبارتند از:
.IP filename
نام فایلی که داده‌های مصرف در آن ذخیره می‌شوند.
.IP key
مشخصه‌ای که در
Access\-Request
وجود خواهد داشت تا به‌عنوان مقدار «شاخص» (index) برای شمارنده استفاده شود. برای هر کلید یکتا یک ورودی شمارنده رهگیری می‌شود. محتمل‌ترین کلیدی که مایل به استفاده از آن خواهید بود
.B User\-Name
است.
.IP count_attribute
مشخصه‌ای که برای افزایش مقدار شمارنده استفاده خواهد شد. اگر این مشخصه
.B Acct\-Session\-Time
یا یک مقدار عدد صحیح باشد، داده‌های شمارنده به اندازهٔ مقدار آن مشخصه افزایش می‌یابند. برای تمام انواع دیگر مشخصه‌ها، شمارنده یک واحد افزایش می‌یابد.
.IP reset
بازهٔ زمانی که پس از آن داده‌های شمارنده باید مجدداً به ۰ بازنشانی شوند. مقادیر معتبر برای این متغیر عبارتند از:
.BR hourly ،
.BR daily ،
.BR weekly ،
.BR monthly
یا
.BR never .
به‌عنوان روش جایگزین، می‌تواند توسط کاربر و به فرم
\fBnum[hdwm]\fP
تعریف شود.
\fBnum\fP
یک مقدار عددی است که با یک یا هیچ‌یک از حروف زیر دنبال می‌شود:
.B h
(ساعت)،
.B d
(روز)،
.B w
(هفته)،
.B m
(ماه).
.IP check_name
این گزینه نام مشخصه‌ای را تعیین می‌کند که توسط ماژول شمارنده ثبت خواهد شد و می‌تواند برای تعیین حداکثر مقدار مجاز شمارنده استفاده شود که پس از عبور از آن، کاربر رد (reject) می‌شود. اگر
.B Daily\-Session\-Time
تنظیم شده باشد، می‌توانید از نحو زیر در فایل Users برای تعیین سقف ۳۶۰۰ ثانیه (۸ ساعت) استفاده کنید:
.PP
.DS
DEFAULT Max\-Daily\-Session := 3600
.DE
.PP
.IP reply_name
این نام مشخصه‌ای است که هنگام احراز هویت و صدور مجوز موفق برای کاربر، مقدار باقیماندهٔ شمارنده را در بستهٔ پاسخ نگه‌داری می‌کند. نام پیش‌فرض این مشخصه
"Session\-Timeout"
است.
.IP allowed_service_type
از این گزینه می‌توان برای اعمال محدودیت‌ها تنها روی انواع خاصی از نشست‌ها (sessions) استفاده کرد. برای مثال، تنظیم این متغیر روی
.B Framed\-User
تنها ماژول شمارنده را بر روی نشست‌های Framed اعمال می‌کند و انواع دیگر مانند Telnet یا Rlogin را نادیده می‌گیرد.
.IP cache_size
حداکثر اندازهٔ حافظهٔ موقت (کَش) مورد استفاده توسط ماژول. مقدار پیش‌فرض ۱۰۰۰ است.
.SH "نکات (NOTES)"
این ماژول یک مشخصه را ثبت می‌کند، بنابراین باید به بخش
.B instantiate
اضافه شود تا هنگام بالا آمدن سرور فراخوانی گردد. در صورت استفاده در بخش
.BR authorize ،
باید بعد از هر ماژولی قرار گیرد که مشخصهٔ
.B check_name
را تنظیم می‌کند.
.PP
.SH "بخش‌ها (SECTIONS)"
.BR instantiate ،
.BR authorize ،
.BR accounting
.PP
.SH "فایل‌ها (FILES)"
.I /etc/raddb/radiusd.conf
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR radiusd (8),
.BR radiusd.conf (5),
.BR rlm_sqlcounter (5)
.SH "نویسنده (AUTHOR)"
Chris Parker, cparker@segv.org