.TH RLM_SQLIPPOOL_TOOL 8 .SH "نام (NAME)" rlm_sqlippool_tool \- مدیریت استخرهای آدرس IP در پایگاه‌داده SQL .SH "خلاصه دستور (SYNOPSIS)" .B rlm_sqlippool_tool .RB \-p .IR pool_name .RB \-s .IR range_start .RB \-e .IR range_end .RB \-t .IR table_name .RB \-d .IR dialect .RB \-f .IR raddb_dir .RB \-i .IR instance .RB [ \-c .IR capacity ] .RB [ \-x .IR existing_ips_file ] .B rlm_sqlippool_tool .RB \-y .IR pool_defs_yaml_file .RB \-t .IR table_name .RB \-d .IR dialect .RB \-f .IR raddb_dir .RB \-i .IR instance .RB [ \-x .IR existing_ips_file ] .SH "توضیحات (DESCRIPTION)" ابزار \fBrlm_sqlippool_tool\fP برای مدیریت نشانی‌های IP در استخرهای IP پایگاه‌داده SQL به کار می‌رود که توسط FreeRADIUS استفاده می‌شوند. این ابزار یا دستورات SQL مناسب برای دستکاری پایگاه‌داده را در خروجی چاپ می‌کند، یا مستقیماً با پایگاه‌داده ارتباط برقرار کرده و جدول استخر IP را مقداردهی و پر می‌کند. .PP قالب خروجی SQL یا دستوراتی که روی پایگاه‌داده اجرا می‌شوند، بر اساس طرح‌واره‌های (schemas) پیش‌فرض ippool در FreeRADIUS هستند. فیلدهایی که پر می‌شوند شامل \fIpool_name\fP و \fIframedipaddress\fP هستند. سایر فیلدها رها می‌شوند تا با مقادیر پیش‌فرض پایگاه‌داده پر شوند. .SH "گزینه‌ها (OPTIONS)" .IP \-c\ \fIcapacity\fP تعداد نشانی‌های IP برای پر کردن استخر. مقدار پیش‌فرض ۶۵۵۳۶ یا بیشترین تعداد قابل تخصیص میان ابتدا و انتهای بازه است. .IP \-d\ \fIdialect\fP گویش (dialect) پایگاه‌داده SQL برای تولید خروجی. .IP \-e\ \fIrange_end\fP نشانی IP انتهای بازه استخر. استفاده از نشانی‌های IPv4 یا IPv6 مجاز است. .IP \-f\ \fIraddb_dir\fP پوشه حاوی پیکربندی FreeRADIUS. در صورت مشخص شدن این گزینه، ابزار \fBrlm_sqlippool_tool\fP پیکربندی را تجزیه کرده و تلاش می‌کند مستقیماً با سرور پایگاه‌داده مشخص‌شده در پیکربندی FreeRADIUS ارتباط برقرار کند. .IP \-i\ \fIinstance\fP همراه با گزینه \fB\-f\fP به کار می‌رود. نام نمونه (instance) ماژول sql در پیکربندی FreeRADIUS را برای تجزیه مشخص می‌کند. مقدار پیش‌فرض \fIsql\fP است. .IP \-p\ \fIpool_name\fP نام استخر برای مقداردهی و پر کردن. .IP \-s\ \fIrange_start\fP نشانی IP ابتدای بازه استخر. استفاده از نشانی‌های IPv4 یا IPv6 مجاز است. .IP \-t\ \fItable_name\fP نام جدول در پایگاه‌داده برای پر کردن. .IP \-x\ \fIexisting_ips_file\fP فایلی حاوی نشانی‌های IP موجود در استخر. استفاده از این گزینه امکان رشد کنترل‌شده‌تر استخرهای پراکنده (sparse) را فراهم می‌کند. .IP \-y\ \fIpool_defs_yaml_file\fP فایلی با قالب YAML حاوی مشخصات چندین استخر. .SH "مثال‌ها (EXAMPLES)" برای تولید خروجی SQL با قالب MySQL برای استخری به نام \fIlocal\fP که با نشانی‌های 10.0.0.1 تا 10.0.0.199 پر شده باشد: .PP .nf .RS $ rlm_sqlippool_tool \-p local \-s 10.0.0.1 \-e 10.0.0.199 \\ \-t dhcpippool \-d mysql .RE .fi .PP برای انجام همین کار ولی از طریق ارتباط مستقیم با ماژول SQL پیکربندی‌شده در FreeRADIUS زیر مسیر \fI/etc/raddb\fP: .PP .nf .RS $ rlm_sqlippool_tool \-p local \-s 10.0.0.1 \-e 10.0.0.199 \\ \-t dhcpippool \-f /etc/raddb .RE .fi .PP برای استفاده از یک فایل YAML جهت مشخص کردن بازه‌های استخر و تولید خروجی SQL با قالب PostgreSQL: .PP .nf .RS $ rlm_sqlippool_tool \-y pools.yaml \-t dhcpippool \-d postgresql .RE .fi .SH "قالب YAML (YAML FORMAT)" یک فایل YAML برای پر کردن چندین استخر باید به این صورت قالب‌بندی شود: .PP .nf .RS pool_with_a_single_contiguous_range: - start: 192.0.2.3 end: 192.0.2.250 pool_with_a_single_sparse_range: - start: 10.10.10.0 end: 10.10.20.255 capacity: 200 pool_with_multiple_ranges: - start: 10.10.10.1 end: 10.10.10.253 - start: 10.10.100.0 end: 10.10.199.255 capacity: 1000 v6_pool_with_contiguous_range: - start: '2001:db8:1:2:3:4:5:10' end: '2001:db8:1:2:3:4:5:7f' v6_pool_with_sparse_range: - start: '2001:db8:1:2::' end: '2001:db8:1:2:ffff:ffff:ffff:ffff' capacity: 200 .RE .fi .SH "پیش‌نیازها (PREREQUISITES)" برای تولید خروجی SQL قالب‌بندی‌شده، ماژول Perl Template::Toolkit مورد نیاز است. .PP ارتباط مستقیم با پایگاه‌های داده با استفاده از Perl DBI انجام می‌شود. برای فعال شدن این قابلیت باید درایور Perl DBD متناسب نصب شده باشد. .SH "همچنین ببینید (SEE ALSO)" radiusd.conf(5), raddb/mods-available/sql .SH "نویسندگان (AUTHORS)" Nick Porter