.\" -*- mode: troff; coding: utf-8 -*-
.TH "mmdblookup" "1" ""
.SH "نام (NAME)"
.LP
mmdblookup \- ابزاری برای جستجوی یک نشانی IP در فایل MaxMind DB
.SH "خلاصه دستور (SYNOPSIS)"
.LP
mmdblookup --file [FILE PATH] --ip [IP ADDRESS] [DATA PATH]
.SH "توضیحات (DESCRIPTION)"
.LP
دستور \f(CRmmdblookup\fR یک نشانی IP را در فایل MaxMind DB مشخص‌شده جستجو می‌کند. رکورد مربوط به نشانی IP با استفاده از \f(CR{}\fR برای مشخص کردن نگاشت‌ها و \f(CR[]\fR برای مشخص کردن آرایه‌ها نمایش داده می‌شود. در ادامه مقادیر، یادداشت‌های نوع داده مشخص شده‌اند. این خروجی JSON \fIنیست\fR و برای چنین استفاده‌ای در نظر گرفته نشده است. اگر به خروجی JSON نیاز دارید، لطفاً به
.UR https://github.com/maxmind/mmdbinspect
\f(CRmmdbinspect\fR
.UE \c
\& مراجعه کنید.
.PP
اگر مدخل داده‌های یک IP به یک نگاشت یا آرایه ختم شود، می‌توانید برای نمایش تنها بخشی از آن داده‌ها، یک مسیر جستجو (lookup path) تعیین کنید.
.PP
برای نمونه، ساختار JSON زیر را در نظر بگیرید:
.LP
.EX
{
    \(dqnames\(dq: {
        \(dqen\(dq: \(dqGermany\(dq,
        \(dqde\(dq: \(dqDeutschland\(dq
    },
    \(dqcities\(dq: [ \(dqBerlin\(dq, \(dqFrankfurt\(dq ]
}
.EE
.PP
می‌توانید تنها با فراخوانی mmdblookup به همراه مسیر جستجوی زیر، فقط نام انگلیسی را جستجو کنید:
.LP
.EX
mmdblookup --file ... --ip ... names en
.EE
.PP
یا می‌توانید شهر دوم موجود در فهرست را با دستور زیر جستجو کنید:
.LP
.EX
mmdblookup --file ... --ip ... cities 1
.EE
.PP
شماره‌گذاری آرایه‌ها از صفر (0) آغاز می‌شود.
.PP
اگر مسیری برای جستجو ارائه نکنید، تمامی اطلاعات مربوط به IP داده‌شده نمایش داده خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.LP
این برنامه گزینه‌های زیر را می‌پذیرد:
.TP 3
-f, --file
مسیر فایل MMDB. الزامی است.
.TP 3
-i, --ip
نشانی IP برای جستجو. الزامی است.
.TP 3
-v, --verbose
خروجی پرگو (verbose) را فعال می‌کند. به‌طور مشخص، این گزینه باعث می‌شود که برنامه فراداده‌های پایگاه‌داده را چاپ کند.
.TP 3
--version
شماره نسخه برنامه را چاپ کرده و خارج می‌شود.
.TP 3
-h, -?, --help
اطلاعات نحوه استفاده را نشان می‌دهد.
.SH "گزارش باگ‌ها و پول‌ریکوئست‌ها (BUG REPORTS AND PULL REQUESTS)"
.LP
لطفاً تمام مشکلات را به
.UR https://github.com/maxmind/libmaxminddb/issues
ردیاب اشکالات گیت‌هاب ما
.UE \c
\& گزارش دهید. ما از گزارش‌های اشکال و پول‌ریکوئست‌ها استقبال می‌کنیم. لطفاً توجه داشته باشید که پول‌ریکوئست‌ها به‌مراتب بر وصله‌ها (patches) ترجیح داده می‌شوند.
.SH "نویسندگان (AUTHORS)"
.LP
این ابزار توسط Boris Zentner (\c
.MT bzentner@maxmind.com
.ME \c
) و Dave Rolsky (\c
.MT drolsky@maxmind.com
.ME \c
) نوشته شده است.
.SH "کپی‌رایت و مجوز (COPYRIGHT AND LICENSE)"
.LP
حق نشر 2013-2026 MaxMind, Inc.
.PP
تحت مجوز Apache، نسخه 2.0 (مجوز یا «\(dqLicense\(dq») منتشر شده است؛ شما مجاز به استفاده از این فایل نیستید مگر با رعایت مفاد مجوز. می‌توانید نسخه‌ای از این مجوز را در نشانی زیر دریافت کنید:
.LP
.EX
https://www.apache.org/licenses/LICENSE-2.0
.EE
.PP
مگر در مواردی که طبق قانون لازم باشد یا به‌صورت کتبی با آن موافقت شده باشد، نرم‌افزار توزیع‌شده بر اساس این مجوز «همان‌گونه که هست» (AS IS)، بدون هیچ‌گونه ضمانت یا شرایطی از هر نوع، چه صریح و چه ضمنی توزیع می‌شود. برای آگاهی از زبان دقیق حاکم بر مجوزها و محدودیت‌های تحت این مجوز، به متن مجوز مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.LP
libmaxminddb(3)