LOCATION(1)   LOCATION(1)

location - پرس‌وجوی پایگاه داده موقعیت جغرافیایی

location export --directory=DIR [--format=FORMAT] [--family=ipv6|ipv4] [ASN|CC ...]
location get-as ASN [ASN...]
location list-countries [--show-name] [--show-continent]
location list-networks-by-as ASN
location list-networks-by-cc COUNTRY_CODE
location list-networks-by-flags [--anonymous-proxy|--satellite-provider|--anycast|--drop]
location lookup ADDRESS [ADDRESS...]
location search-as STRING
location update [--cron=daily|weekly|monthly]
location verify
location version

دستور location اطلاعات را از پایگاه داده موقعیت جغرافیایی بازیابی می‌کند. از این داده‌ها می‌توان برای تعیین موقعیت مکانی افراد در اینترنت و ایجاد مجموعه‌قوانین فایروال جهت مسدودسازی دسترسی از ASها یا کشورهای خاص استفاده کرد.

--database FILE, -d FILE

مسیر پایگاه داده‌ای که باز می‌شود.

اگر این گزینه مشخص نشود، پایگاه داده سیستم باز خواهد شد.

--quiet

فعال‌سازی حالت بی‌صدا

--debug

فعال‌سازی حالت اشکال‌زدایی

export [--directory=DIR] [--format=FORMAT] [--family=ipv6|ipv4] [ASN|CC ...]

این دستور کل پایگاه داده را در دایرکتوری داده‌شده صادر می‌کند (export می‌کند).

خروجی را می‌توان با صدور تنها یک خانواده آدرس خاص، یا با ارسال فهرستی از کدهای کشور و/یا ASNها فیلتر کرد. پیش‌فرض بر این است که تمامی کشورهای شناخته‌شده صادر شوند.

قالب خروجی را می‌توان با پارامتر --format انتخاب کرد. برای مشاهده قالب‌های ممکن، لطفاً بخش زیر را ببینید.

اگر گزینه --directory مشخص نشود، خروجی در stdout نوشته خواهد شد که این مورد هنگامی که بخواهید خروجی‌های سفارشی را مستقیماً در nftables یا ipset بارگذاری کنید مفید است.

get-as ASN [ASN...]

این دستور نام سازمان مالک سیستم خودمختار (Autonomous System) را بازمی‌گرداند.

list-countries [--show-name] [--show-continent]

فهرست تمامی کشورهای شناخته‌شده در پایگاه داده را نمایش می‌دهد.

با پارامترهای اختیاری --show-name و --show-continent، نام و کد قاره نیز چاپ خواهند شد.

list-networks-by-as [--family=[ipv6|ipv4]] [--format=FORMAT] ASN

فهرست تمامی شبکه‌های متعلق به این سیستم خودمختار (Autonomous System) را نمایش می‌دهد.

از پارامتر --family می‌توان برای فیلتر کردن خروجی و محدود کردن آن به آدرس‌های IPv6 یا IPv4 استفاده کرد.

پارامتر --format می‌تواند قالب خروجی را تغییر دهد تا مستقیماً در نرم‌افزارهای دیگر قابل بارگذاری باشد. برای جزئیات به بخش زیر مراجعه کنید.

list-networks-by-cc [--family=[ipv6|ipv4]] [--format=FORMAT] COUNTRY_CODE

تمامی شبکه‌های متعلق به یک کشور را فهرست می‌کند.

کد کشور باید در قالب نمادگذاری ISO3166 Alpha-2 مشخص شود.

برای نحوه استفاده از پارامترهای --family و --format به توضیحات بالا مراجعه کنید.

list-networks-by-flags [--family=[ipv6|ipv4]] [--format=FORMAT] [--anonymous-proxy|--satellite-provider|--anycast|--drop]

تمامی شبکه‌های دارای یک پرچم (flag) مشخص را فهرست می‌کند.

برای نحوه استفاده از پارامترهای --family و --format به توضیحات بالا مراجعه کنید.

list-bogons [--family=[ipv6|ipv4]] [--format=FORMAT]

تمامی بوگان‌ها (یعنی شبکه‌هایی که برای پایگاه داده ناشناخته هستند) را فهرست می‌کند.

برای نحوه استفاده از پارامترهای --family و --format به توضیحات بالا مراجعه کنید.

lookup ADDRESS [ADDRESS...]

این دستور شبکه‌ای را که آدرس IP داده‌شده در آن پیدا شده و همچنین سیستم خودمختار آن را (در صورت در دسترس بودن اطلاعات) بازمی‌گرداند.

search-as STRING

تمامی سیستم‌های خودمختاری را که با رشته داده‌شده مطابقت دارند فهرست می‌کند.

جستجو بدون حساسیت به بزرگی و کوچکی حروف انجام می‌شود.

update

این دستور تلاش می‌کند پایگاه داده محلی را به‌روزرسانی کند.

در صورت به‌روزرسانی موفقیت‌آمیز پایگاه داده، با کد خروج صفر خاتمه می‌یابد. در صورت بروز خطا با 1، در صورت فراخوانی نامعتبر با 2، و اگر پایگاه داده از قبل آخرین نسخه باشد با 3 خارج می‌شود.

گزینه --cron امکان محدود کردن به‌روزرسانی‌ها به روزی یک بار (daily)، هفته‌ای یک بار (weekly) یا ماهی یک بار (monthly) را فراهم می‌کند. اگر این دستور فراخوانی شود اما پایگاه داده اخیراً به‌روزرسانی شده باشد، از به‌روزرسانی صرف‌نظر خواهد شد.

verify

صحت پایگاه داده بارگیری‌شده را بررسی و تأیید می‌کند.

version

اطلاعات نسخه پایگاه داده بارگیری‌شده را نمایش می‌دهد.

--help

متن راهنمای کوتاهی درباره نحوه استفاده از این برنامه نمایش می‌دهد.

--version

نسخه برنامه را نمایش داده و خارج می‌شود.

دستور location در حالت عادی با کد خروج صفر به پایان می‌رسد. اگر مشکلی رخ داده باشد و عملیات درخواستی انجام‌پذیر نباشد، کد خروج مقداری غیر از صفر خواهد داشت.

برخی دستورها امکان تعیین قالب خروجی را فراهم می‌کنند. این قابلیت به عنوان مثال هنگامی که داده‌های صادرشده باید در یک فیلتر بسته وارد شوند، بسیار کاربردی است. قالب‌های زیر پشتیبانی می‌شوند:

•list (پیش‌فرض): صرفاً تمامی شبکه‌ها را، یک مورد در هر خط، فهرست می‌کند
•ipset: برای ipset
•nftables: برای nftables
•xt_geoip: فهرستی از شبکه‌ها را برای بارگذاری در ماژول هسته xt_geoip بازمی‌گرداند

بخش بارگیری، یک رکورد DNS را برای بررسی آخرین نسخه پایگاه داده بررسی می‌کند. سپس تلاش می‌کند فایلی با آن نسخه را از یک سرور آینه‌ای بارگیری کند. اگر فایل بارگیری‌شده قدیمی باشد، سرور آینه‌ای بعدی بررسی خواهد شد تا زمانی که فایلی به‌اندازه کافی جدید پیدا شود.

لطفاً تمام باگ‌ها را به سامانه ردیابی باگ در https://bugzilla.ipfire.org گزارش دهید؛ برای جزئیات به https://wiki.ipfire.org/devel/bugzilla مراجعه کنید.

Michael Tremer