'\" t
.\"     Title: location
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 07/14/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "LOCATION" "1" "" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
location \- پرس‌وجوی پایگاه داده موقعیت جغرافیایی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
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
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
دستور location اطلاعات را از پایگاه داده موقعیت جغرافیایی بازیابی می‌کند\&. از این داده‌ها می‌توان برای تعیین موقعیت مکانی افراد در اینترنت و ایجاد مجموعه‌قوانین فایروال جهت مسدودسازی دسترسی از ASها یا کشورهای خاص استفاده کرد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-\-database FILE, \-d FILE
.RS 4
مسیر پایگاه داده‌ای که باز می‌شود\&.

اگر این گزینه مشخص نشود، پایگاه داده سیستم باز خواهد شد\&.
.RE
.PP
\-\-quiet
.RS 4
فعال‌سازی حالت بی‌صدا
.RE
.PP
\-\-debug
.RS 4
فعال‌سازی حالت اشکال‌زدایی
.RE
.SH "دستورها (COMMANDS)"
.PP
\fIexport [\-\-directory=DIR] [\-\-format=FORMAT] [\-\-family=ipv6|ipv4] [ASN|CC \&...]\fR
.RS 4
این دستور کل پایگاه داده را در دایرکتوری داده‌شده صادر می‌کند (export می‌کند)\&.

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

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

اگر گزینه
\fI\-\-directory\fR
مشخص نشود، خروجی در stdout نوشته خواهد شد که این مورد هنگامی که بخواهید خروجی‌های سفارشی را مستقیماً در nftables یا ipset بارگذاری کنید مفید است\&.
.RE
.PP
\fIget\-as ASN [ASN\&...]\fR
.RS 4
این دستور نام سازمان مالک سیستم خودمختار (Autonomous System) را بازمی‌گرداند\&.
.RE
.PP
\fIlist\-countries [\-\-show\-name] [\-\-show\-continent]\fR
.RS 4
فهرست تمامی کشورهای شناخته‌شده در پایگاه داده را نمایش می‌دهد\&.

با پارامترهای اختیاری
\fI\-\-show\-name\fR
و
\fI\-\-show\-continent\fR،
نام و کد قاره نیز چاپ خواهند شد\&.
.RE
.PP
\fIlist\-networks\-by\-as [\-\-family=[ipv6|ipv4]]\ \&[\-\-format=FORMAT]\ \&ASN\fR
.RS 4
فهرست تمامی شبکه‌های متعلق به این سیستم خودمختار (Autonomous System) را نمایش می‌دهد\&.

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

پارامتر
\fI\-\-format\fR
می‌تواند قالب خروجی را تغییر دهد تا مستقیماً در نرم‌افزارهای دیگر قابل بارگذاری باشد\&. برای جزئیات به بخش زیر مراجعه کنید\&.
.RE
.PP
\fIlist\-networks\-by\-cc [\-\-family=[ipv6|ipv4]]\ \&[\-\-format=FORMAT] COUNTRY_CODE\fR
.RS 4
تمامی شبکه‌های متعلق به یک کشور را فهرست می‌کند\&.

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

برای نحوه استفاده از پارامترهای
\fI\-\-family\fR
و
\fI\-\-format\fR
به توضیحات بالا مراجعه کنید\&.
.RE
.PP
\fIlist\-networks\-by\-flags [\-\-family=[ipv6|ipv4]]\ \&[\-\-format=FORMAT] [\-\-anonymous\-proxy|\-\-satellite\-provider|\-\-anycast|\-\-drop]\fR
.RS 4
تمامی شبکه‌های دارای یک پرچم (flag) مشخص را فهرست می‌کند\&.

برای نحوه استفاده از پارامترهای
\fI\-\-family\fR
و
\fI\-\-format\fR
به توضیحات بالا مراجعه کنید\&.
.RE
.PP
\fIlist\-bogons [\-\-family=[ipv6|ipv4]] [\-\-format=FORMAT]\fR
.RS 4
تمامی بوگان‌ها (یعنی شبکه‌هایی که برای پایگاه داده ناشناخته هستند) را فهرست می‌کند\&.

برای نحوه استفاده از پارامترهای
\fI\-\-family\fR
و
\fI\-\-format\fR
به توضیحات بالا مراجعه کنید\&.
.RE
.PP
\fIlookup ADDRESS [ADDRESS\&...]\fR
.RS 4
این دستور شبکه‌ای را که آدرس IP داده‌شده در آن پیدا شده و همچنین سیستم خودمختار آن را (در صورت در دسترس بودن اطلاعات) بازمی‌گرداند\&.
.RE
.PP
\fIsearch\-as STRING\fR
.RS 4
تمامی سیستم‌های خودمختاری را که با رشته داده‌شده مطابقت دارند فهرست می‌کند\&.

جستجو بدون حساسیت به بزرگی و کوچکی حروف انجام می‌شود\&.
.RE
.PP
\fIupdate\fR
.RS 4
این دستور تلاش می‌کند پایگاه داده محلی را به‌روزرسانی کند\&.

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

گزینه
\fI\-\-cron\fR
امکان محدود کردن به‌روزرسانی‌ها به روزی یک بار (\fIdaily\fR)، هفته‌ای یک بار (\fIweekly\fR) یا ماهی یک بار (\fImonthly\fR) را فراهم می‌کند\&. اگر این دستور فراخوانی شود اما پایگاه داده اخیراً به‌روزرسانی شده باشد، از به‌روزرسانی صرف‌نظر خواهد شد\&.
.RE
.PP
\fIverify\fR
.RS 4
صحت پایگاه داده بارگیری‌شده را بررسی و تأیید می‌کند\&.
.RE
.PP
\fIversion\fR
.RS 4
اطلاعات نسخه پایگاه داده بارگیری‌شده را نمایش می‌دهد\&.
.RE
.PP
\fI\-\-help\fR
.RS 4
متن راهنمای کوتاهی درباره نحوه استفاده از این برنامه نمایش می‌دهد\&.
.RE
.PP
\fI\-\-version\fR
.RS 4
نسخه برنامه را نمایش داده و خارج می‌شود\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
دستور \fIlocation\fR در حالت عادی با کد خروج صفر به پایان می‌رسد\&. اگر مشکلی رخ داده باشد و عملیات درخواستی انجام‌پذیر نباشد، کد خروج مقداری غیر از صفر خواهد داشت\&.
.SH "قالب‌ها (FORMATS)"
.sp
برخی دستورها امکان تعیین قالب خروجی را فراهم می‌کنند\&. این قابلیت به عنوان مثال هنگامی که داده‌های صادرشده باید در یک فیلتر بسته وارد شوند، بسیار کاربردی است\&. قالب‌های زیر پشتیبانی می‌شوند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIlist\fR
(پیش‌فرض): صرفاً تمامی شبکه‌ها را، یک مورد در هر خط، فهرست می‌کند
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIipset\fR: برای ipset
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fInftables\fR: برای nftables
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIxt_geoip\fR: فهرستی از شبکه‌ها را برای بارگذاری در ماژول هسته xt_geoip بازمی‌گرداند
.RE
.SH "نحوه کارکرد (HOW IT WORKS)"
.sp
بخش بارگیری، یک رکورد DNS را برای بررسی آخرین نسخه پایگاه داده بررسی می‌کند\&. سپس تلاش می‌کند فایلی با آن نسخه را از یک سرور آینه‌ای بارگیری کند\&. اگر فایل بارگیری‌شده قدیمی باشد، سرور آینه‌ای بعدی بررسی خواهد شد تا زمانی که فایلی به‌اندازه کافی جدید پیدا شود\&.
.SH "گزارش باگ‌ها (BUGS)"
.sp
لطفاً تمام باگ‌ها را به سامانه ردیابی باگ در \m[blue]\fBhttps://bugzilla\&.ipfire\&.org\fR\m[] گزارش دهید؛ برای جزئیات به \m[blue]\fBhttps://wiki\&.ipfire\&.org/devel/bugzilla\fR\m[] مراجعه کنید\&.
.SH "نویسندگان (AUTHORS)"
.sp
Michael Tremer