LOCATION(1)                                                        LOCATION(1)

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

خلاصه دستور (SYNOPSIS)
       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

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

گزینه‌ها (OPTIONS)
       --database FILE, -d FILE
           مسیر پایگاه داده‌ای که باز می‌شود.

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

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

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

دستورها (COMMANDS)
       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
           نسخه برنامه را نمایش داده و خارج می‌شود.

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

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

       •   list (پیش‌فرض): صرفاً تمامی شبکه‌ها را، یک مورد در هر خط، فهرست می‌کند

       •   ipset: برای ipset

       •   nftables: برای nftables

       •   xt_geoip: فهرستی از شبکه‌ها را برای بارگذاری در ماژول هسته xt_geoip
           بازمی‌گرداند

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

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

نویسندگان (AUTHORS)
       Michael Tremer

                                                                   LOCATION(1)