.de Sp
.if n .sp
.if t .sp 0.4
..
.TH  fwb_pf  1 "" FWB "Firewall Builder"
.SH "نام (NAME)"
fwb_pf \- کامپایلر خط‌مشی برای فیلتر بسته‌ی «pf» در OpenBSD
.SH "خلاصه دستور (SYNOPSIS)"

.B fwb_pf
.B [-vVx]
.B [-d wdir]
.B [-o output.fw]
.B [-i]
.B -f data_file.xml
object_name

.SH "توضیحات (DESCRIPTION)"

برنامهٔ
.B fwb_pf
یکی از مؤلفه‌های کامپایلر خط‌مشی دیوار آتش در Firewall Builder است (به
fwbuilder(1)
مراجعه کنید). این کامپایلر برای فیلتر بسته‌ی OpenBSD موسوم به (pf) کد تولید می‌کند. کامپایلر تعاریف اشیاء و توضیحات دیوار آتش را از فایل داده‌ی مشخص‌شده با گزینهٔ «-f» خوانده و فایل‌های پیکربندی pf و اسکریپت فعال‌سازی دیوار آتش را تولید می‌کند.

نام تمام فایل‌های تولید‌شده با نام شیءِ دیوار آتش آغاز می‌شود. اسکریپت فعال‌سازی دیوار آتش دارای پسوند «.fw» بوده و یک اسکریپت شل ساده است که خط‌مشی فعلی را پاک (flush) کرده، قواعد جدید پالایش و nat را بارگذاری می‌کند و سپس pf را فعال می‌سازد. نام فایل پیکربندی PF با نام شیءِ دیوار آتش به‌همراه «-pf.conf» شروع می‌شود. نام فایل پیکربندی NAT نیز با نام شیءِ دیوار آتش به‌همراه «-nat.conf» آغاز می‌گردد. برای مثال، اگر شیءِ دیوار آتش دارای نام «myfirewall» باشد، کامپایلر سه فایل ایجاد خواهد کرد: «myfirewall.fw»، «myfirewall-pf.conf» و «myfirewall-nat.conf».

فایل داده و نام شیء دیوار آتش باید در خط فرمان مشخص شوند. سایر پارامترهای خط فرمان اختیاری هستند.


.SH "گزینه‌ها (OPTIONS)"
.IP "-f FILE"
مشخص کردن نام فایل داده‌ای که باید پردازش شود.

.IP "-o output.fw"
مشخص کردن نام فایل خروجی.

.IP "-d wdir"
مشخص کردن دایرکتوری کاری. کامپایلر اسکریپت فعال‌سازی دیوار آتش و فایل‌های پیکربندی PF را در این دایرکتوری ایجاد می‌کند. اگر این پارامتر تعیین نشود، تمام فایل‌ها در دایرکتوری کاری فعلی قرار خواهند گرفت.

.IP "-v"
حالت پرگویی: کامپایلر هنگام کار پیام‌های عیب‌یابی را چاپ می‌کند.

.IP "-V"
چاپ شماره نسخه و خروج.

.IP "-i"
هنگامی که این گزینه ارائه شود، آخرین آرگومان خط فرمان به‌جای نام شیءِ دیوار آتش، شناسهٔ شیء (ID) در نظر گرفته می‌شود.

.IP "-x"
تولید اطلاعات اشکال‌زدایی حین کار. این گزینه فقط برای اشکال‌زدایی در نظر گرفته شده و ممکن است پیام‌های مبهم و فراوانی تولید کند.

.SH "نکات (NOTES)"
پشتیبانی از PF در نگارش 1.0.1 از Firewall Builder اضافه شد.


ویژگی‌های پشتیبانی‌شده:

.IP o
هر دو فایل pf.conf و nat.conf تولید می‌شوند

.IP o
نقیض (negation) در قواعد خط‌مشی و NAT

.IP o
گروه‌بندی در «from»، «to» و پورت‌ها با استفاده از نحو '{' '}'

.IP o
اگر جعبه‌علامت «Scrub» در پنجرهٔ گزینه‌های قاعده فعال باشد و عمل قاعده Accept باشد، کامپایلر دو قاعده (تقریباً) همسان تولید می‌کند: اولی با عمل 'scrub' و دومی با عمل 'pass quick'

.IP o
بازرسی وابسته به وضعیت (stateful inspection) در تک‌تک قواعد را می‌توان در پنجرهٔ گزینه‌های قاعده خاموش کرد. به‌طور پیش‌فرض کامپایلر "keep state" یا "modulate state" را به هر قاعده با عمل 'pass' اضافه می‌کند

.IP o
پنجرهٔ گزینه‌های قاعده گزینه‌ای برای پاسخ‌های icmp یا tcp rst برای قواعدی با عمل «Reject» فراهم می‌کند

.IP o
اگر تطابق روی گزینه‌های ip نیاز باشد، کامپایلر پرچم "allow-opts" را می‌افزاید

.IP o
کامپایلر می‌تواند قواعدی منطبق بر پرچم‌های TCP تولید کند

.IP o
کامپایلر می‌تواند اسکریپتی برای افزودن نام‌های مستعار ip برای قواعد NAT با استفاده از نشانی‌هایی که متعلق به هیچ رابطی از دیوار آتش نیستند، تولید کند

.IP o
کامپایلر همواره قاعدهٔ "block quick all" را در انتهای اسکریپت اضافه می‌کند تا خط‌مشی «مسدودسازی همه به‌طور پیش‌فرض» حتی در صورت خالی بودن خط‌مشی تضمین شود.

.IP o
محدوده‌های نشانی (Address ranges) در هر دو بخش خط‌مشی و NAT


.PP 
ویژگی‌هایی که (هنوز) پشتیبانی نمی‌شوند:

.IP o
سرویس‌های سفارشی (custom services)


.PP 
آنچه پشتیبانی نخواهد شد (دست‌کم به این زودی‌ها):

.IP o
مسیریابی خط‌مشی (policy routing)

.SH "نشانی وب (URL)"
صفحهٔ اصلی Firewall Builder در نشانی زیر قرار دارد:
.B http://www.fwbuilder.org

.SH "گزارش باگ‌ها (BUGS)"
لطفاً باگ‌ها را با استفاده از سامانهٔ ردیابی باگ در SourceForge گزارش دهید:

.BR http://sourceforge.net/tracker/?group_id=5314&atid=105314


.SH "همچنین ببینید (SEE ALSO)"
.BR fwbuilder(1),
.BR fwb_ipt(1),
.BR fwb_ipf(1)

.P