.TH IP 8 "20 Dec 2011" "iproute2" "Linux" .SH "نام (NAME)" ip \- نمایش و دستکاری مسیریابی، دستگاه‌های شبکه، رابط‌ها و تونل‌ها .SH "خلاصه دستور (SYNOPSIS)" .ad l .in +8 .ti -8 .B ip .RI "[ " OPTIONS " ] " OBJECT " { " COMMAND " | " .BR help " }" .sp .ti -8 .B ip .RB "[ " -force " ] " .BI "-batch " filename .sp .ti -8 .IR OBJECT " := { " .BR address " | " addrlabel " | " fou " | " help " | " ila " | " ioam " | "\ l2tp " | " link " | " macsec " | " maddress " | " monitor " | " mptcp " | "\ mroute " | " mrule " | " neighbor " | " neighbour " | " netconf " | "\ netns " | " nexthop " | " ntable " | " ntbl " | " route " | " rule " | "\ sr " | " tap " | " tcpmetrics " | " token " | " tunnel " | " tuntap " | "\ vrf " | " xfrm " }" .sp .ti -8 .IR OPTIONS " := { " \fB\-V\fR[\fIersion\fR] | \fB\-h\fR[\fIuman-readable\fR] | \fB\-s\fR[\fItatistics\fR] | \fB\-d\fR[\fIetails\fR] | \fB\-r\fR[\fIesolve\fR] | \fB\-iec\fR | \fB\-f\fR[\fIamily\fR] { .BR inet " | " inet6 " | " link " } | " \fB-4\fR | \fB-6\fR | \fB-B\fR | \fB-0\fR | \fB-l\fR[\fIoops\fR] { \fBmaximum-addr-flush-attempts\fR } | \fB\-o\fR[\fIneline\fR] | \fB\-rc\fR[\fIvbuf\fR] [\fBsize\fR] | \fB\-t\fR[\fIimestamp\fR] | \fB\-ts\fR[\fIhort\fR] | \fB\-n\fR[\fIetns\fR] name | \fB\-N\fR[\fIumeric\fR] | \fB\-a\fR[\fIll\fR] | \fB\-c\fR[\fIolor\fR] | \fB\-br\fR[\fIief\fR] | \fB\-j\fR[son\fR] | \fB\-p\fR[retty\fR] } .SH "گزینه‌ها (OPTIONS)" .TP .BR "\-V" , " -Version" نسخه ابزار .B ip را چاپ کرده و خارج می‌شود. .TP .BR "\-h" , " \-human" , " \-human-readable" نمایش آمارها با مقادیر خوانا برای انسان به همراه پسوند. .TP .BR "\-b" , " \-batch " خواندن دستورات از فایل ارائه‌شده یا ورودی استاندارد و اجرای آن‌ها. نخستین شکست باعث توقف اجرای ip خواهد شد. .TP .BR "\-force" در صورت بروز خطا در حالت دسته‌ای، اجرای ip متوقف نمی‌شود. اگر در حین اجرای دستورات خطایی رخ دهد، کد خروج برنامه غیرصفر خواهد بود. .TP .BR "\-s" , " \-stats" , " \-statistics" نمایش اطلاعات بیشتر در خروجی. در صورتی که این گزینه دو بار یا بیشتر تکرار شود، میزان اطلاعات افزایش می‌یابد. به عنوان یک قاعده، این اطلاعات شامل آمارها یا برخی مقادیر زمانی است. .TP .BR "\-d" , " \-details" نمایش اطلاعات با جزئیات بیشتر در خروجی. .TP .BR "\-l" , " \-loops " حداکثر تعداد تلاش‌های منطق 'ip address flush' را قبل از انصراف تعیین می‌کند. مقدار پیش‌فرض ۱۰ است. مقدار صفر (0) به معنی تکرار حلقه تا حذف کامل تمام آدرس‌هاست. .TP .BR "\-f" , " \-family " خانواده پروتکل مورد استفاده را مشخص می‌کند. شناسه خانواده پروتکل می‌تواند یکی از مقادیر .BR "inet" ، .BR "inet6" ، .BR "bridge" ، .B "mpls" یا .B link باشد. در صورت عدم ذکر این گزینه، خانواده پروتکل از روی سایر آرگومان‌ها حدس زده می‌شود. اگر بقیه خط فرمان اطلاعات کافی برای تشخیص خانواده پروتکل نداشته باشد، .B ip به مقدار پیش‌فرض که معمولاً .B inet یا .B any است بازمی‌گردد. .B link یک شناسه ویژه از خانواده پروتکل است که نشان می‌دهد هیچ پروتکل شبکه‌ای درگیر نیست. .TP .B \-4 میانبری برای .BR "-family inet" . .TP .B \-6 میانبری برای .BR "\-family inet6" . .TP .B \-B میانبری برای .BR "\-family bridge" . .TP .B \-M میانبری برای .BR "\-family mpls" . .TP .B \-0 میانبری برای .BR "\-family link" . .TP .BR "\-o" , " \-oneline" هر رکورد را در یک خط نمایش می‌دهد و شکستگی‌های خط را با کاراکتر .B '\e' جایگزین می‌کند. این حالت هنگام شمارش رکوردها با .BR wc (1) یا پالایش خروجی با .BR grep (1) بسیار سودمند است. .TP .BR "\-r" , " \-resolve" استفاده از تحلیل‌گر نام سیستم برای چاپ نام‌های DNS به جای آدرس‌های میزبان. .TP .BR "\-n" , " \-netns " تغییر فضای نام شبکه .B ip به فضای نام .IR NETNS مشخص‌شده. این گزینه در واقع اجرای دستور: .B ip netns exec .IR NETNS .B ip .RI "[ " OPTIONS " ] " OBJECT " { " COMMAND " | " .BR help " }" را به صورت ساده‌تر زیر درمی‌آورد: .B ip .RI "-n[etns] " NETNS " [ " OPTIONS " ] " OBJECT " { " COMMAND " | " .BR help " }" .TP .BR "\-N" , " \-Numeric" چاپ مستقیم شماره پروتکل، حوزه (scope)، dsfield و غیره به جای تبدیل آن‌ها به نام‌های خوانا برای انسان. .TP .BR "\-a" , " \-all" دستور مشخص‌شده را روی تمامی اشیاء اجرا می‌کند؛ البته این به شرطی است که دستور مربوطه از این گزینه پشتیبانی کند. .TP .BR \-c [ color ][ = { always | auto | never } پیکربندی رنگ خروجی. اگر پارامتر حذف شود یا برابر با .B always باشد، خروجی رنگی صرف‌نظر از وضعیت stdout فعال می‌شود. اگر پارامتر برابر با .B auto باشد، وضعیت stdout بررسی می‌شود تا تنها در صورت متصل بودن به ترمینال خروجی رنگی فعال شود. اگر پارامتر .B never باشد، خروجی رنگی غیرفعال می‌شود. در صورت تکرار این گزینه، آخرین مقدار اعمال می‌شود. در صورت استفاده از گزینه .B \-json این فلگ نادیده گرفته می‌شود. .sp پالت رنگی مورد استفاده می‌تواند از متغیر محیطی .B COLORFGBG تأثیر بپذیرد (بخش .B "متغیرهای محیطی (ENVIRONMENT)" را ببینید). .TP .BR "\-t" , " \-timestamp" نمایش زمان جاری هنگام استفاده از گزینه monitor. .TP .BR "\-ts" , " \-tshort" مشابه .BR \-timestamp ، اما از قالب کوتاه‌تری استفاده می‌کند. .TP .BR "\-rc" , " \-rcvbuf" تنظیم اندازه بافر دریافت سوکت netlink؛ مقدار پیش‌فرض 1MB است. .TP .BR "\-iec" چاپ نرخ‌ها با واحدهای IEC به صورت خوانا برای انسان (مانند 1Ki = 1024). .TP .BR "\-br" , " \-brief" چاپ تنها اطلاعات پایه در قالب جدول برای خوانایی بهتر. این گزینه در حال حاضر تنها توسط دستورات .BR "ip addr show" ، .B "ip link show" و .B "ip neigh show" پشتیبانی می‌شود. .TP .BR "\-j", " \-json" نمایش نتایج در قالب نشانه‌گذاری شیء جاوااسکریپت (JSON). .TP .BR "\-p", " \-pretty" قالب پیش‌فرض JSON فشرده بوده و تجزیه آن کارآمدتر است اما خواندن آن برای بیشتر کاربران دشوار است. این فلگ تورفتگی‌هایی را جهت خوانایی بهتر می‌افزاید. .TP .BR "\-echo" درخواست از هسته برای بازگرداندن پیکربندی اعمال‌شده. .SH "ترکیب دستورات IP (IP - COMMAND SYNTAX)" .SS .I OBJECT .TP .B address \- آدرس پروتکل (IP یا IPv6) روی یک دستگاه. .TP .B addrlabel \- پیکربندی برچسب برای انتخاب آدرس پروتکل. .TP .B fou \- پیکربندی درگاه دریافت Foo-over-UDP. .TP .B ila \- مدیریت نشانی‌های تعیین‌کننده شناسه (ILA). .TP .B ioam \- مدیریت فضاهای نام IOAM و طرح‌واره‌های IOAM. .TP .B l2tp \- تونل اترنت روی IP (پروتکل L2TPv3). .TP .B link \- دستگاه شبکه. .TP .B macsec \- پیکربندی دستگاه MACsec. .TP .B maddress \- آدرس چندپخشی (multicast). .TP .B monitor \- پایش پیام‌های netlink. .TP .B mptcp \- مدیریت مدیر مسیر MPTCP. .TP .B mroute \- مدخل حافظه موقت مسیریابی چندپخشی. .TP .B mrule \- قانون در پایگاه‌داده سیاست مسیریابی چندپخشی. .TP .B neighbour \- مدیریت مدخل‌های حافظه موقت ARP یا NDISC. .TP .B netconf \- پایش پیکربندی شبکه. .TP .B netns \- مدیریت فضاهای نام شبکه. .TP .B nexthop \- مدیریت اشیاء گام بعدی (nexthop). .TP .B ntable \- مدیریت عملیات حافظه موقت همسایگی. .TP .B route \- مدخل جدول مسیریابی. .TP .B rule \- قانون در پایگاه‌داده سیاست مسیریابی. .TP .B sr \- مدیریت مسیریابی بخش‌های IPv6 (Segment Routing). .TP .B stats \- مدیریت و نمایش آمار رابط شبکه. .TP .B tcp_metrics/tcpmetrics \- مدیریت معیارهای TCP (TCP Metrics). .TP .B token \- مدیریت شناسه‌های نشانه‌دار رابط شبکه. .TP .B tunnel \- تونل روی IP. .TP .B tuntap \- مدیریت دستگاه‌های TUN/TAP. .TP .B vrf \- مدیریت دستگاه‌های هدایت و مسیریابی مجازی (VRF). .TP .B xfrm \- مدیریت سیاست‌های IPSec. .PP نام تمامی اشیاء می‌تواند به صورت کامل یا مخفف نوشته شود؛ برای نمونه .B address می‌تواند به صورت .B addr یا صرفاً .B a مخفف شود. .SS .I COMMAND عملیاتی را که باید روی شیء انجام گیرد مشخص می‌کند. مجموعه عملیات ممکن به نوع شیء بستگی دارد. به طور کلی، امکان .BR "add" ، .B "delete" و .B show (یا .BR list ) اشیاء وجود دارد، اما برخی اشیاء اجازه تمامی این عملیات را نمی‌دهند یا دستورات اضافه‌ای دارند. دستور .B help برای تمامی اشیاء در دسترس است. این دستور فهرستی از دستورات مجاز و قواعد نحوی آرگومان‌ها را چاپ می‌کند. .sp اگر دستوری مشخص نشود، دستور پیش‌فرضی در نظر گرفته می‌شود. معمولاً این دستور .B list است و در صورتی که نتوان اشیاء این رده را فهرست کرد، .B help خواهد بود. .SH "متغیرهای محیطی (ENVIRONMENT)" .TP .B COLORFGBG در صورت تنظیم، مقدار آن برای تشخیص تاریک یا روشن بودن پس‌زمینه و استفاده از رنگ‌های دارای کنتراست مناسب به کار می‌رود. .sp متغیر محیطی COLORFGBG معمولاً شامل دو یا سه مقدار جداشده با نقطه ویرگول است؛ در هر دو حالت آخرین مقدار مد نظر است. اگر این مقدار بین 0 تا 6 یا برابر با 8 باشد، رنگ‌های مناسب برای پس‌زمینه تیره برگزیده می‌شوند: .sp COLORFGBG=";0" ip -c a .SH "کد خروج (EXIT STATUS)" در صورت موفقیت‌آمیز بودن دستور، کد خروج 0 است و در صورت بروز خطای نحوی مقدار 1 بازگردانده می‌شود. اگر خطایی از سوی هسته گزارش شود، کد خروج 2 خواهد بود. .SH "مثال‌ها (EXAMPLES)" .PP ip addr .RS 4 نمایش آدرس‌های اختصاص‌یافته به تمامی رابط‌های شبکه. .RE .PP ip neigh .RS 4 نمایش جدول همسایگی فعلی در هسته. .RE .PP ip link set x up .RS 4 فعال کردن رابط شبکه x. .RE .PP ip link set x down .RS 4 غیرفعال کردن رابط شبکه x. .RE .PP ip route .RS 4 نمایش جدول مسیرها. .RE .SH "تاریخچه (HISTORY)" دستور .B ip توسط Alexey N. Kuznetsov نوشته شد و در لینوکس 2.2 اضافه گردید. .SH "همچنین ببینید (SEE ALSO)" .BR ip-address (8), .BR ip-addrlabel (8), .BR ip-fou (8), .BR ip-ioam (8), .BR ip-l2tp (8), .BR ip-link (8), .BR ip-macsec (8), .BR ip-maddress (8), .BR ip-monitor (8), .BR ip-mptcp (8), .BR ip-mroute (8), .BR ip-neighbour (8), .BR ip-netconf (8), .BR ip-netns (8), .BR ip-nexthop (8), .BR ip-ntable (8), .BR ip-route (8), .BR ip-rule (8), .BR ip-sr (8), .BR ip-stats (8), .BR ip-tcp_metrics (8), .BR ip-token (8), .BR ip-tunnel (8), .BR ip-vrf (8), .BR ip-xfrm (8) .br .RB "راهنمای مرجع دستورات IP: " ip-cref.ps .SH "گزارش باگ‌ها (REPORTING BUGS)" هرگونه باگ را به فهرست پستی توسعه‌دهندگان شبکه .B که توسعه و نگهداری اصلی در آنجا انجام می‌گیرد گزارش دهید. برای ارسال پیام نیازی به عضویت در این فهرست پستی نیست. .SH "نویسنده (AUTHOR)" صفحه راهنمای اصلی توسط Michail Litvak نوشته شده است.