.\" Guus Sliepen - 2001
.\" Completed and fixed up by Jean Tourrilhes - 2002-2003
.\" iwgetid.8
.\"
.TH IWGETID 8 "02 December 2003" "wireless-tools" "Linux Programmer's Manual"
.\"
.\" NAME part
.\"
.SH "نام (NAME)"
iwgetid \- گزارش ESSID، NWID یا نشانی AP/سلول شبکهٔ بی‌سیم
.\"
.\" SYNOPSIS part
.\"
.SH "خلاصه دستور (SYNOPSIS)"
.BI "iwgetid " [interface] " [--raw] [--scheme] [--ap] [--freq]"
.br
.BI "                   [--mode] [--protocol] [--channel]"
.br
.\"
.\" DESCRIPTION part
.\"
.SH "توضیحات (DESCRIPTION)"
ابزار
.B iwgetid
برای یافتن NWID، ESSID یا نشانی نقطه دسترسی/سلول (AP/Cell) شبکهٔ بی‌سیمی که در حال حاضر استفاده می‌شود، به کار می‌رود. اطلاعات گزارش‌شده همان اطلاعاتی است که توسط
.BR iwconfig " نمایش داده می‌شود، اما یکپارچه‌سازی " iwgetid
در اسکریپت‌های مختلف آسان‌تر است.
.br
به‌طور پیش‌فرض،
.B iwgetid
شناسهٔ
.I ESSID
دستگاه را چاپ می‌کند، و اگر دستگاه فاقد هرگونه ESSID باشد،
.IR NWID
آن را چاپ خواهد کرد.
.br
قالب‌بندی پیش‌فرض خروجی به صورت خوانا و آراسته (pretty-print) است.
.\"
.\" OPTIONS part
.\"
.SH "گزینه‌ها (OPTIONS)"
.TP
.B --raw
این گزینه قالب‌بندی آراسته (pretty-printing) اطلاعات را غیرفعال می‌کند. این گزینه با سایر گزینه‌ها (به‌جز
.BR --scheme )
مستقل و سازگار است؛ بنابراین با ترکیب مناسب گزینه‌ها می‌توانید مقدار خام ESSID، نشانی AP یا حالت (Mode) را چاپ کنید.
.br
این قالب زمانی ایده‌آل است که بخواهید نتیجهٔ iwgetid را به عنوان یک متغیر در اسکریپت‌های
.I Shell
یا
.I Perl
ذخیره کنید یا نتیجه را به عنوان آرگومان به خط فرمان
.BR iwconfig
ارسال نمایید.
.TP
.B --scheme
این گزینه مشابه گزینهٔ قبلی است؛ قالب‌بندی آراستهٔ اطلاعات را غیرفعال می‌کند و تمامی نویسه‌های غیرحرفی-عددی (مانند فاصله‌ها، نشانه‌های نگارشی و نویسه‌های کنترلی) را حذف می‌نماید.
.br
خروجی حاصل یک شناسهٔ معتبر طرح‌وارهٔ Pcmcia است (که می‌تواند به عنوان آرگومان برای دستور
.BR "cardctl scheme"
استفاده شود). این قالب همچنین هنگام استفاده از نتیجهٔ iwgetid به عنوان یک گزینش‌گر در اسکریپت‌های
.I Shell
یا
.I Perl
یا به عنوان نام یک فایل بسیار ایده‌آل است.
.TP
.B --ap
نمایش نشانی MAC نقطه دسترسی بی‌سیم (
.IR "Access Point" )
یا
.IR Cell .
.TP
.B --freq
نمایش
.I فرکانس
یا
.I کانال
فعلی مورد استفاده توسط رابط شبکه.
.TP
.B --channel
نمایش
.I کانال
فعلی مورد استفاده توسط رابط شبکه. کانال با استفاده از فرکانس فعلی و فهرست فرکانس‌های ارائه‌شده توسط رابط تعیین می‌شود.
.TP
.B --mode
نمایش
.I حالت (mode)
فعلی رابط شبکه.
.TP
.B --protocol
نمایش
.I نام پروتکل
رابط شبکه. این ویژگی امکان شناسایی تمامی کارت‌هایی را که با یکدیگر سازگار هستند و نوع پیکربندی یکسانی را می‌پذیرند فراهم می‌کند.
.br
همچنین می‌توان از این گزینه برای
.I بررسی پشتیبانی از Wireless Extension
روی رابط شبکه استفاده کرد، زیرا این ویژگی تنها مشخصه‌ای است که تمام راه‌اندازهای پشتیبانی‌کننده از Wireless Extension موظف به پشتیبانی از آن هستند.
.\"
.\" SEE ALSO part
.\"
.SH "همچنین ببینید (SEE ALSO)"
.BR iwconfig (8),
.BR ifconfig (8),
.BR iwspy (8),
.BR iwpriv (8).