.TH "IP\-ADDRESS" 8 "20 Dec 2011" "iproute2" "Linux" .SH "نام (NAME)" ip-address \- مدیریت آدرسهای پروتکل (IP یا IPv6) روی دستگاههای شبکه .SH "خلاصه دستور (SYNOPSIS)" .sp .ad l .in +8 .ti -8 .B ip .RI "[ " OPTIONS " ]" .B address .RI " { " COMMAND " | " .BR help " }" .sp .ti -8 .BR "ip address" " { " add " | " change " | " replace " } " .IB IFADDR " dev " IFNAME .RI "[ " LIFETIME " ] [ " CONFFLAG-LIST " ]" .ti -8 .BR "ip address delete" .IB IFADDR " dev " IFNAME " [ " mngtmpaddr " ]" .ti -8 .BR "ip address" " { " save " | " flush " } [ " dev .IR IFNAME " ] [ " .B scope .IR SCOPE-ID " ] [ " .B metric .IR METRIC " ] [ " .B to .IR PREFIX " ] [ " FLAG-LIST " ] [ " .B label .IR PATTERN " ] [ { " up " | " down " } ]" .ti -8 .BR "ip address" " [ " show " [ " dev .IR IFNAME " ] [ " .B scope .IR SCOPE-ID " ] [ " .B to .IR PREFIX " ] [ " FLAG-LIST " ] [ " .B label .IR PATTERN " ] [ " .B master .IR DEVICE " ] [ " .B type .IR TYPE " ] [ " .B vrf .IR NAME " ] [ { " .BR up " | " down " } ] [" .BR nomaster " ]" .B proto .IR ADDRPROTO " ] ]" .ti -8 .BR "ip address" " { " showdump " | " restore " }" .ti -8 .IR IFADDR " := " PREFIX " | " ADDR .B peer .IR PREFIX " [ " .B broadcast .IR ADDR " ] [ " .B anycast .IR ADDR " ] [ " .B label .IR LABEL " ] [ " .B scope .IR SCOPE-ID " ] [ " .B proto .IR ADDRPROTO " ]" .ti -8 .IR SCOPE-ID " := " .RB "[ " host " | " link " | " global " | " .IR NUMBER " ]" .ti -8 .IR ADDRPROTO " := [ " .IR NAME " | " NUMBER " ]" .ti -8 .IR FLAG-LIST " := [ " FLAG-LIST " ] " FLAG .ti -8 .IR FLAG " := [" .RB [ - ] permanent " |" .RB [ - ] dynamic " |" .RB [ - ] secondary " |" .RB [ - ] primary " |" .RB [ - ] tentative " |" .RB [ - ] deprecated " |" .RB [ - ] dadfailed " |" .RB [ - ] temporary " |" .IR CONFFLAG-LIST " ]" .ti -8 .IR CONFFLAG-LIST " := [ " CONFFLAG-LIST " ] " CONFFLAG .ti -8 .IR CONFFLAG " := " .RB "[ " home " | " mngtmpaddr " | " nodad " | " optimistic " | " noprefixroute " | " autojoin " ]" .ti -8 .IR LIFETIME " := [ " .BI valid_lft " LFT" .RB "] [ " preferred_lft .IR LFT " ]" .ti -8 .IR LFT " := [ " .BR forever " |" .IR SECONDS " ]" .ti -8 .IR TYPE " := [ " .BR bridge " | " .BR bridge_slave " |" .BR bond " | " .BR bond_slave " |" .BR can " | " .BR dummy " | " .BR hsr " | " .BR ifb " | " .BR ipoib " |" .BR macvlan " | " .BR macvtap " | " .BR vcan " | " .BR veth " | " .BR vlan " | " .BR vxlan " |" .BR ip6tnl " |" .BR ipip " |" .BR sit " |" .BR gre " |" .BR gretap " |" .BR erspan " |" .BR ip6gre " |" .BR ip6gretap " |" .BR ip6erspan " |" .BR vti " |" .BR vrf " |" .BR nlmon " |" .BR ipvlan " |" .BR lowpan " |" .BR geneve " |" .BR macsec " |" .BR netkit " ]" .SH "توضیحات (DESCRIPTION)" یک .B address یک آدرس پروتکل (IPv4 یا IPv6) متصل‌شده به یک دستگاه شبکه است. هر دستگاه باید دست‌کم یک آدرس داشته باشد تا از پروتکل متناظر استفاده کند. امکان اتصال چندین آدرس مختلف به یک دستگاه وجود دارد. میان این آدرس‌ها هیچ تفاوتی گذاشته نمی‌شود، به‌گونه‌ای که اصطلاح .B alias (نام مستعار) چندان برای آن‌ها مناسب نیست و ما از آن در این سند استفاده نمی‌کنیم. .sp دستور .B ip address آدرس‌ها و ویژگی‌های آن‌ها را نمایش می‌دهد، آدرس‌های جدید اضافه می‌کند و آدرس‌های قدیمی را حذف می‌کند. .SS "ip address add \- افزودن آدرس پروتکل جدید" .TP .BI dev " IFNAME " نام دستگاهی که قرار است آدرس به آن اضافه شود. .TP .BI local " ADDRESS " (پیش‌فرض) آدرس رابط شبکه. قالب آدرس به پروتکل بستگی دارد. برای IP به‌صورت چهار عدد دهدهی نقطه‌دار (dotted quad) و برای IPv6 دنباله‌ای از نیم‌کلمه‌های هگزادسیمال جداشده با دونقطه است. پس از .I ADDRESS می‌تواند یک اسلش و یک عدد دهدهی بیاید که طول پیشوند شبکه را مشخص می‌کند. .TP .BI peer " ADDRESS" آدرس نقطه پایانی دوردست برای رابط‌های نقطه به نقطه (point-to-point). در اینجا نیز پس از .I ADDRESS می‌تواند یک اسلش و یک عدد دهدهی بیاید که طول پیشوند شبکه را مشخص می‌کند. اگر یک آدرس همتا (peer) مشخص شده باشد، آدرس محلی نمی‌تواند طول پیشوند داشته باشد. پیشوند شبکه به‌جای آدرس محلی با آدرس همتا پیوند داده می‌شود. .TP .BI broadcast " ADDRESS" آدرس همگانی (broadcast) روی رابط. .sp امکان استفاده از نمادهای ویژه .B '+' و .B '\-' به‌جای آدرس همگانی وجود دارد. در این حالت، آدرس همگانی از طریق تنظیم یا صفر کردن بیت‌های میزبان در پیشوند رابط به دست می‌آید. .TP .BI label " LABEL" هر آدرس می‌تواند با یک رشته برچسب نشانه‌گذاری شود. حداکثر طول مجاز کل برچسب ۱۵ کاراکتر است. .TP .BI scope " SCOPE_VALUE" دامنه محدوده‌ای که این آدرس در آن معتبر است. دامنه‌های موجود در .BR /usr/share/iproute2/rt_scopes " یا " /etc/iproute2/rt_scopes (در صورت وجود دارای اولویت است) فهرست شده‌اند. مقادیر پیش‌تعریف‌شده دامنه عبارتند از: .in +8 .B global \- آدرس به‌صورت سراسری معتبر است. .sp .B site \- (فقط در IPv6، منسوخ‌شده) آدرس محلی سایت است، یعنی درون این سایت معتبر است. .sp .B link \- آدرس محلی پیوند (link-local) است، یعنی تنها روی این دستگاه معتبر است. .sp .B host \- آدرس تنها درون این میزبان معتبر است. .in -8 .TP .BI metric " NUMBER" اولویت مسیر پیشوندی مرتبط با آدرس. .TP .BI valid_lft " LFT" طول عمر معتبر (valid lifetime) این آدرس؛ بخش 5.5.4 از RFC 4862 را ببینید. هنگام انقضای آن، آدرس توسط هسته حذف می‌شود. مقدار پیش‌فرض .BR forever (همیشگی) است. .TP .BI preferred_lft " LFT" طول عمر ترجیحی (preferred lifetime) این آدرس؛ بخش 5.5.4 از RFC 4862 را ببینید. هنگام انقضای آن، دیگر از این آدرس برای اتصالات خروجی جدید استفاده نمی‌شود. مقدار پیش‌فرض .BR forever (همیشگی) است. .TP .B home (فقط در IPv6) این آدرس را طبق تعریف RFC 6275 به عنوان «آدرس خانه» (home address) تعیین می‌کند. .TP .B mngtmpaddr (فقط در IPv6) به هسته دستور می‌دهد آدرس‌های موقتی ایجادشده از این آدرس به عنوان الگو را از طرف افزونه‌های حریم خصوصی (RFC 3041) مدیریت کند. برای فعال شدن این ویژگی، تنظیم sysctl مربوط به \fBuse_tempaddr\fP باید روی مقداری بزرگ‌تر از صفر قرار گیرد. آدرس داده‌شده باید دارای طول پیشوند ۶۴ باشد. این فلگ امکان استفاده از افزونه‌های حریم خصوصی را در یک شبکه پیکربندی‌شده دستی فراهم می‌کند، درست مانند زمانی که پیکربندی خودکار بدون حالت (SLAAC) فعال باشد. .TP .B nodad (فقط در IPv6) هنگام افزودن این آدرس، بررسی تشخیص آدرس تکراری یا DAD (طبق RFC 4862) را انجام نده. .TP .B optimistic (فقط در IPv6) هنگام انجام تشخیص آدرس تکراری، از روش خوش‌بینانه (optimistic) طبق RFC 4429 استفاده کن. .TP .B noprefixroute به‌طور خودکار برای پیشوند شبکه آدرس اضافه‌شده یک مسیر (route) ایجاد نکن، و هنگام حذف آدرس نیز به دنبال مسیری برای حذف نگرد. تغییر یک آدرس برای افزودن این فلگ، مسیر پیشوندی که به‌صورت خودکار اضافه شده بود را حذف می‌کند، و تغییر آن برای برداشتن این فلگ، مسیر پیشوند را به‌طور خودکار ایجاد خواهد کرد. .TP .B autojoin پیوستن به گروه‌های چندپخشی (multicast) در سطح اترنت از طریق دستور .B "ip maddr" در صورت اتصال به سوئیچ اترنتی که مجهز به IGMP snooping است کار نمی‌کند، زیرا سوئیچ بسته‌های چندپخشی را روی درگاه‌هایی که فاقد گزارش‌های IGMP برای آدرس‌های چندپخشی هستند تکثیر نمی‌کند. رابط‌های لینوکسی VXLAN که از طریق دستور .B "ip link add vxlan" ایجاد می‌شوند، دارای گزینه .B group هستند که به آن‌ها امکان می‌دهد عمل پیوستن مورد نیاز را انجام دهند. استفاده از فلگ .B autojoin هنگام افزودن یک آدرس چندپخشی، قابلیتی مشابه را برای رابط‌های Openvswitch VXLAN و همچنین سایر سازوکارهای تونل‌زنی که نیاز به دریافت ترافیک چندپخشی دارند فعال می‌سازد. .TP .BI proto " ADDRPROTO" شناسه پروتکل این مسیر. .I ADDRPROTO می‌تواند یک عدد یا یک رشته از پرونده .BR /usr/share/iproute2/rt_addrprotos " یا " /etc/iproute2/rt_addrprotos (در صورت وجود دارای اولویت است) باشد. همچنین پوشه‌ای به نام .BR rt_addrprotos.d در هر دو مسیر جستجو می‌شود. اگر شناسه پروتکل مشخص نشود، .B ip پروتکل 0 را فرض می‌کند. چندین مقدار پروتکل دارای تفسیر ثابت هستند؛ به‌ویژه: .in +8 .B kernel_lo \- آدرس ::1 که هسته روی دستگاه شبکه لوپ‌بک (loopback) نصب می‌کند دارای این مقدار پروتکل است. .sp .B kernel_ra \- آدرس‌های IPv6 که در پاسخ به پیام‌های اعلان رهیاب (router advertisement) نصب شده‌اند. .sp .B kernel_ll \- آدرس‌های محلی پیوند (link-local) دارای این مقدار پروتکل هستند. .sp .in -8 .sp سایر مقادیر رزرو نشده‌اند و مدیر سیستم می‌تواند برچسب‌های پروتکل را آزادانه اختصاص دهد (یا اختصاص ندهد). .SS "ip address delete \- حذف آدرس پروتکل" .B آرگومان‌ها: مشابه آرگومان‌های دستور .B ip address add هستند. .sp نام دستگاه یک آرگومان الزامی است. .SS "ip address show \- مشاهده آدرس‌های پروتکل" .TP .BI dev " IFNAME " (پیش‌فرض) نام دستگاه شبکه. .TP .BI scope " SCOPE_VAL" فقط آدرس‌های دارای این دامنه (scope) را فهرست می‌کند. .TP .BI to " PREFIX" فقط آدرس‌های منطبق با این پیشوند را فهرست می‌کند. .TP .BI label " PATTERN" فقط آدرس‌هایی با برچسب منطبق بر .I PATTERN را فهرست می‌کند. .I PATTERN یک الگوی معمول به سبک پوسته (shell pattern) است. .TP .BI master " DEVICE" فقط رابط‌های زیرمجموعه این دستگاه ارشد (master) را فهرست می‌کند. .TP .BI vrf " NAME " فقط رابط‌های زیرمجموعه این vrf را فهرست می‌کند. .TP .BI type " TYPE" فقط رابط‌های از نوع مشخص‌شده را فهرست می‌کند. .sp توجه داشته باشید که نام نوع با فهرست انواع پشتیبانی‌شده بررسی نمی‌شود؛ بلکه همان‌طور که هست به هسته ارسال می‌گردد. بعداً در صورتی که هسته قبلاً فیلتر نکرده باشد، با مقایسه آن با ویژگی مربوطه برای فیلتر کردن فهرست رابط‌های بازگردانده‌شده استفاده می‌شود. بنابراین هر رشته‌ای پذیرفته می‌شود، اما ممکن است به خروجی خالی منجر شود. .TP .B up فقط رابط‌های فعال و در حال اجرا را فهرست می‌کند. .TP .B down فقط رابط‌های غیرفعال را فهرست می‌کند. .TP .B nomaster فقط رابط‌های بدون دستگاه ارشد را فهرست می‌کند. .TP .BR dynamic " و " permanent (فقط در IPv6) فقط آدرس‌های نصب‌شده بر اساس پیکربندی خودکار آدرس بدون حالت را فهرست می‌کند، یا فقط آدرس‌های دائمی (غیرپویا) را فهرست می‌کند. این دو فلگ معکوس یکدیگر هستند، بنابراین .BR \-dynamic " معادل " permanent " و " .BR \-permanent " معادل " dynamic است. .TP .B tentative (فقط در IPv6) فقط آدرس‌هایی را که هنوز بررسی تشخیص آدرس تکراری (DAD) را نگذرانده‌اند فهرست می‌کند. .TP .B \-tentative (فقط در IPv6) فقط آدرس‌هایی را فهرست می‌کند که در حال حاضر در فرآیند تشخیص آدرس تکراری نیستند. .TP .B deprecated (فقط در IPv6) فقط آدرس‌های منسوخ‌شده را فهرست می‌کند. .TP .B \-deprecated (فقط در IPv6) فقط آدرس‌هایی را که در حال منسوخ شدن نیستند فهرست می‌کند. .TP .B dadfailed (فقط در IPv6) فقط آدرس‌هایی را فهرست می‌کند که در فرآیند تشخیص آدرس تکراری با شکست مواجه شده‌اند. .TP .B \-dadfailed (فقط در IPv6) فقط آدرس‌هایی را فهرست می‌کند که در تشخیص آدرس تکراری شکست نخورده‌اند. .TP .BR temporary " یا " secondary فقط آدرس‌های موقت IPv6 یا فرعی (secondary) IPv4 را فهرست می‌کند. هسته لینوکس یک بیت واحد برای آن‌ها به اشتراک می‌گذارد، بنابراین در عمل نام‌های مستعار یکدیگر هستند اگرچه معنای آن‌ها بسته به خانواده آدرس متفاوت است. .TP .BR \-temporary " یا " \-secondary این فلگ‌ها نام‌های مستعاری برای .B primary هستند. .TP .B primary فقط آدرس‌های اصلی (primary) را فهرست می‌کند و در IPv6 آدرس‌های موقت را کنار می‌گذارد. این فلگ معکوس .BR temporary " و " secondary است. .TP .B \-primary این فلگ یک نام مستعار برای .BR temporary " یا " secondary است. .TP .BI proto " ADDRPROTO" فقط آدرس‌های دارای پروتکل مشخص‌شده، یا آدرس‌هایی را نشان می‌دهد که پاسخ هسته برای آن‌ها شامل پروتکل نبوده است. برای جزئیات مربوط به پروتکل‌های آدرس، آرگومان متناظر در .B ip address add را ببینید. .SS "ip address flush \- پاکسازی آدرس‌های پروتکل" این دستور آدرس‌های پروتکل انتخاب‌شده طبق معیارهای خاص را پاکسازی و تخلیه (flush) می‌کند. .PP این دستور همان آرگومان‌های دستور .B show را دارد، با این تفاوت که انتخاب‌کننده‌های .B type و .B master پشتیبانی نمی‌شوند. تفاوت دیگر این است که در صورت ارائه نشدن هیچ آرگومانی اجرا نمی‌شود. .PP .B هشدار: این دستور و سایر دستورات .B flush بسیار بی‌رحمانه و بدون اغماض عمل می‌کنند. آن‌ها بی‌رحمانه تمامی آدرس‌ها را پاک خواهند کرد. .PP با گزینه .BR \-statistics ، دستور حالت پرگویی به خود می‌گیرد. این گزینه تعداد آدرس‌های حذف‌شده و تعداد دورهای طی‌شده برای پاکسازی فهرست آدرس‌ها را چاپ می‌کند. در صورتی که این گزینه دو بار داده شود، .B ip address flush همچنین تمامی آدرس‌های حذف‌شده را در قالبی که در زیربخش پیشین شرح داده شد نمایش می‌دهد. .SH "مثال‌ها (EXAMPLES)" .PP ip address show .RS 4 نمایش آدرس‌های IPv4 و IPv6 اختصاص‌یافته به تمام رابط‌های شبکه. زیردستور 'show' را می‌توان حذف کرد. .RE .PP ip address show up .RS 4 مشابه مورد بالا، با این تفاوت که فقط آدرس‌های اختصاص‌یافته به رابط‌های فعال شبکه نمایش داده می‌شوند. .RE .PP ip address show dev eth0 .RS 4 نمایش آدرس‌های IPv4 و IPv6 اختصاص‌یافته به رابط شبکه eth0. .RE .PP ip address add 2001:0db8:85a3::0370:7334/64 dev eth1 .RS 4 افزودن یک آدرس IPv6 به رابط شبکه eth1. .RE .PP ip address delete 2001:0db8:85a3::0370:7334/64 dev eth1 .RS 4 حذف آدرس IPv6 اضافه‌شده در بالا. .RE .PP ip address flush dev eth4 scope global .RS 4 حذف تمامی آدرس‌های سراسری (global) پروتکل‌های IPv4 و IPv6 از دستگاه eth4. بدون 'scope global' تمامی آدرس‌ها از جمله آدرس‌های محلی پیوند (link-local) مربوط به IPv6 حذف خواهند شد. .RE .SH "همچنین ببینید (SEE ALSO)" .br .BR ip (8) .SH "نویسنده (AUTHOR)" صفحه راهنمای اصلی توسط Michail Litvak نوشته شده است.