.TH DEVLINK\-PORT 8 "14 Mar 2016" "iproute2" "Linux"
.SH "نام (NAME)"
devlink-port \- مدیریت پورتهای devlink
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.ad l
.in +8
.ti -8
.B devlink
.RI "[ " OPTIONS " ]"
.B port
.RI  " { " COMMAND " | "
.BR help " }"
.sp

.ti -8
.IR OPTIONS " := { "
\fB\-V\fR[\fIersion\fR] |
\fB\-n\fR[\fIno-nice-names\fR] }

.ti -8
.BR "devlink port set "
.IR DEV/PORT_INDEX
.RI "[ "
.BR type " { " eth " | " ib " | " auto " }"
.RI "]"

.ti -8
.BR "devlink port split "
.IR DEV/PORT_INDEX
.BR count
.IR COUNT

.ti -8
.BR "devlink port unsplit "
.IR DEV/PORT_INDEX

.ti -8
.B devlink port show
.RI "[ " DEV/PORT_INDEX " ]"

.ti -8
.B devlink port health
.RI "{ " show " | " recover " | " diagnose " | " dump " | " set " }"

.ti -8
.BI "devlink port add"
.RB "{"
.IR "DEV | DEV/PORT_INDEX"
.RB "} "
.RB "[ " flavour
.IR FLAVOUR " ]"
.RB "[ " pfnum
.IR PFNUMBER " ]"
.RB "[ " sfnum
.IR SFNUMBER " ]"
.RB "[ " controller
.IR CNUM " ]"
.br

.ti -8
.B devlink port del
.IR DEV/PORT_INDEX

.ti -8
.BR "devlink port function set "
.IR DEV/PORT_INDEX
.RI "[ "
.BR "hw_addr "
.RI "ADDR ]"
.RI "[ "
.BR state " { " active " | " inactive " }"
.RI "]"
.RI "[ "
.BR roce " { " enable " | " disable " }"
.RI "]"
.RI "[ "
.BR migratable " { " enable " | " disable " }"
.RI "]"
.RI "[ "
.BR ipsec_crypto " { " enable " | " disable " }"
.RI "]"
.RI "[ "
.BR ipsec_packet " { " enable " | " disable " }"
.RI "]"
.RI "[ "
.BR max_io_eqs " EQS"
.RI "]"

.ti -8
.BR "devlink port function rate "
.RI "{ " show " | " set " | " add " | " del " | " help " }"

.ti -8
.B devlink dev param set
.I DEV/PORT_INDEX
.B name
.I PARAMETER
.B value
.I VALUE
.BR cmode " { " runtime " | " driverinit " | " permanent " } "

.ti -8
.B devlink dev param show
[
.I DEV/PORT_INDEX
.B name
.I PARAMETER
]

.ti -8
.B devlink port help

.SH "توضیحات (DESCRIPTION)"
.SS devlink port set - تغییر ویژگی‌های پورت devlink

.PP
.I "DEV/PORT_INDEX"
\- پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

.in +4
قالب به این صورت است:
.in +2
BUS_NAME/BUS_ADDRESS/PORT_INDEX

.TP
.BR type " { " eth " | " ib " | " auto " } "
تنظیم نوع پورت.

.I eth
\- اترنت (Ethernet)

.I ib
\- اینفینی‌بند (Infiniband)

.I auto
\- انتخاب خودکار (autoselect)

.SS devlink port split - تقسیم پورت devlink به پورت‌های بیشتر

.PP
.I "DEV/PORT_INDEX"
\- پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

.TP
.BI count " COUNT"
تعداد پورت‌هایی که باید به آن‌ها تقسیم شود.

.SS devlink port unsplit - ادغام مجدد پورت devlink که قبلاً تقسیم شده است
می‌تواند روی هر پورت تقسیم‌شده از همان گروه تقسیم (split group) انجام شود.

.PP
.I "DEV/PORT_INDEX"
\- پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

.SS devlink port show - نمایش ویژگی‌های پورت devlink

.PP
.I "DEV/PORT_INDEX"
\- پورت devlink مورد نظر برای نمایش را مشخص می‌کند.
اگر این آرگومان حذف شود، تمام پورت‌ها فهرست می‌شوند.

.SS devlink port health - گزارش وضعیت سلامت و بازیابی devlink
یک نام مستعار برای
.BR devlink\-health (8)
است.

.ti -8
.SS devlink port add - افزودن یک پورت devlink
.PP
.I "DEV"
\- دستگاه devlink مورد نظر برای عملیات را مشخص می‌کند، یا

.PP
.I "DEV/PORT_INDEX"
\- شناسه پورت (index) devlink را برای استفاده در پورت درخواستی جدید مشخص می‌کند.
این گزینه اختیاری است. در صورت حذف، درایور یک شناسه پورت یکتا اختصاص می‌دهد.

.TP
.BR flavour " { " pcipf " | " pcisf " } "
تنظیم گونه (flavour) پورت

.I pcipf
\- پورت PCI PF

.I pcisf
\- پورت PCI SF

.TP
.BI pfnum " PFNUMBER "
شماره PCI PF را که دستگاه SF روی آن ایجاد می‌شود مشخص می‌کند.

.TP
.BI sfnum " SFNUMBER "
شماره sfnumber اختصاصی به دستگاه SF را مشخص می‌کند.
این فیلد برای دستگاه‌هایی که از تخصیص خودکار شماره SF پشتیبانی می‌کنند اختیاری است.

.TP
.BI controller " CNUM "
شماره کنترل‌کننده‌ای را که پورت SF برای آن ایجاد می‌شود مشخص می‌کند.
این فیلد اختیاری است و تنها زمانی استفاده می‌شود که پورت SF برای یک کنترل‌کننده خارجی ایجاد شود.

.ti -8
.SS devlink port function set - تنظیم ویژگی(های) تابع پورت

.PP
.I "DEV/PORT_INDEX"
\- پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

.TP
.BI hw_addr " ADDR"
آدرس سخت‌افزاری تابع برای تنظیم. هنگامی که نوع پورت Ethernet باشد، این آدرس MAC اترنت است.

.TP
.BR state " { " active " | " inactive " } "
وضعیت جدید تابع برای تغییر.

.I active
\- پس از اتمام پیکربندی تابع، تابع را فعال می‌کند.

.I inactive
\- برای غیرفعال کردن تابع و دستگاه(های) آن، روی inactive تنظیم کنید.

.TP
.BR roce " { " enable " | " disable  " } "
تنظیم قابلیت RoCE تابع.

.TP
.BR migratable " { " enable " | " disable  " } "
تنظیم قابلیت مهاجرت‌پذیری (migratable) تابع.

.TP
.BR ipsec_crypto " { " enable " | " disable  " } "
تنظیم قابلیت آفلود رمزنگاری IPsec تابع. آفلود عملیات رمزنگاری (رمزگذاری/رمزگشایی) وضعیت XFRM را کنترل می‌کند.

.TP
.BR ipsec_packet " { " enable " | " disable  " } "
تنظیم قابلیت آفلود بسته IPsec تابع. آفلود وضعیت و سیاست XFRM (عملیات رمزگذاری/رمزگشایی و کپسوله‌سازی IPsec) را کنترل می‌کند.

.TP
.BR max_io_eqs " EQS"
تنظیم حداکثر تعداد صف‌های رویداد ورودی/خروجی (IO event queues) تابع.

.ti -8
.SS devlink port del - حذف یک پورت devlink
.PP
.I "DEV/PORT_INDEX"
\- پورت devlink مورد نظر برای حذف را مشخص می‌کند.

.ti -8
.SS devlink port param set - تنظیم مقدار جدید برای پارامتر پیکربندی پورت devlink
.PP
.I "DEV/PORT_INDEX"
\- پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

.TP
.BI name " PARAMETER"
مشخص کردن نام پارامتر برای تنظیم.

.TP
.BI value " VALUE"
مقدار جدید برای تنظیم.

.TP
.BR cmode " { " runtime " | " driverinit " | " permanent " } "
حالت پیکربندی که در آن مقدار جدید تنظیم می‌شود.

.I runtime
\- تنظیم مقدار جدید در حین اجرای درایور. این حالت پیکربندی برای اعمال مقدار جدید به هیچ راه‌اندازی مجددی نیاز ندارد.

.I driverinit
\- تنظیم مقدار جدیدی که در حین مقداردهی اولیه درایور اعمال خواهد شد. این حالت پیکربندی برای اعمال مقدار جدید نیاز به راه‌اندازی مجدد درایور از طریق دستور devlink reload دارد.

.I permanent
\- مقدار جدید در حافظه غیرفرار دستگاه نوشته می‌شود. این حالت پیکربندی برای اعمال مقدار جدید به راه‌اندازی مجدد سخت‌افزاری نیاز دارد.

.SS devlink port param show - نمایش ویژگی‌های پارامترهای پیکربندی پشتیبانی‌شده توسط پورت devlink

.PP
.I "DEV/PORT_INDEX"
\- پورت devlink مورد نظر برای عملیات را مشخص می‌کند.

.B name
.I PARAMETER
مشخص کردن نام پارامتر برای نمایش.
اگر این آرگومان، و همچنین شناسه پورت، حذف شوند - تمام پارامترهای پشتیبانی‌شده توسط پورت‌های دستگاه devlink فهرست می‌شوند.

.SS devlink port function rate - مدیریت اشیاء نرخ (rate) devlink
یک نام مستعار برای
.BR devlink\-rate (8)
است.

.SH "مثال‌ها (EXAMPLES)"
.PP
devlink port show
.RS 4
نمایش وضعیت تمام پورت‌های devlink در سیستم.
.RE
.PP
devlink port show pci/0000:01:00.0/1
.RS 4
نمایش وضعیت پورت devlink مشخص‌شده.
.RE
.PP
devlink port set pci/0000:01:00.0/1 type eth
.RS 4
تنظیم نوع پورت devlink مشخص‌شده به Ethernet.
.RE
.PP
devlink port split pci/0000:01:00.0/1 count 4
.RS 4
تقسیم پورت devlink مشخص‌شده به چهار پورت.
.RE
.PP
devlink port unsplit pci/0000:01:00.0/1
.RS 4
لغو تقسیم پورت devlink مشخص‌شده که قبلاً تقسیم شده است.
.RE
.PP
devlink port health show
.RS 4
نمایش وضعیت و پیکربندی تمام گزارش‌دهنده‌های پشتیبانی‌شده و ثبت‌شده روی تمام پورت‌های devlink.
.RE
.PP
devlink port health show pci/0000:01:00.0/1 reporter tx
.RS 4
نمایش وضعیت و پیکربندی گزارش‌دهنده tx ثبت‌شده روی پورت devlink با شناسه pci/0000:01:00.0/1.
.RE
.PP
devlink port add pci/0000:06:00.0 flavour pcisf pfnum 0 sfnum 88
.RS 4
افزودن یک پورت devlink با گونه PCI SF روی PCI PF با شماره 0 و با شماره SF برابر با 88.
برای استفاده از تابع، یک توالی نمونه به این صورت است: افزودن پورت، پیکربندی ویژگی تابع و فعال‌سازی تابع. پس از اتمام استفاده از تابع، غیرفعال‌سازی تابع و در نهایت حذف پورت. زمانی که تمایل به استفاده مجدد از پورت بدون حذف آن وجود دارد، می‌توان آن را در وضعیتی که تابع غیرفعال (inactive) و وضعیت عملیاتی آن منفصل (detached) است، مجدداً پیکربندی و فعال کرد.
.RE
.PP
devlink port del pci/0000:06:00.0/1
.RS 4
حذف پورت devlink که قبلاً ایجاد شده است. توصیه می‌شود اگر تابع از مدیریت وضعیت پشتیبانی می‌کند، ابتدا تابع غیرفعال شود.
.RE
.PP
devlink port function set pci/0000:01:00.0/1 hw_addr 00:00:00:11:22:33
.RS 4
پیکربندی آدرس سخت‌افزاری تابع PCI ارائه‌شده توسط پورت devlink.
اگر پورت از تغییر در وضعیت تابع پشتیبانی کند، آدرس سخت‌افزاری باید پیش از فعال‌سازی تابع پیکربندی شود.
.RE
.PP
devlink port function set pci/0000:01:00.0/1 state active
.RS 4
فعال‌سازی تابع. این عمل شمارش تابع و بارگذاری درایور را آغاز می‌کند.
.RE
.PP
devlink port function set pci/0000:01:00.0/1 state inactive
.RS 4
غیرفعال‌سازی تابع. این عمل برچیدن تابع را آغاز می‌کند که منجر به تخلیه درایور و حذف دستگاه می‌شود.
.RE
.PP
devlink port function set pci/0000:01:00.0/1 roce enable
.RS 4
قابلیت RoCE تابع را فعال می‌کند.
.RE
.PP
devlink port function set pci/0000:01:00.0/1 migratable enable
.RS 4
قابلیت مهاجرت‌پذیری (migratable) تابع را فعال می‌کند.
.RE
.PP
devlink port function set pci/0000:01:00.0/1 ipsec_crypto enable
.RS 4
قابلیت آفلود رمزنگاری IPsec تابع را فعال می‌کند.
.RE
.PP
devlink port function set pci/0000:01:00.0/1 ipsec_packet enable
.RS 4
قابلیت آفلود بسته IPsec تابع را فعال می‌کند.
.RE
.PP
devlink port function set pci/0000:01:00.0/1 max_io_eqs 4
.RS 4
حداکثر تعداد صف‌های رویداد ورودی/خروجی (IO event queues) تابع را روی 4 تنظیم می‌کند.
.RE
.PP
devlink port function set pci/0000:01:00.0/1 hw_addr 00:00:00:11:22:33 state active
.RS 4
پیکربندی آدرس سخت‌افزاری و همچنین فعال‌سازی تابع. هنگامی که یک تابع همراه با پیکربندی‌های دیگر در یک دستور تکی فعال می‌شود، ابتدا تمام پیکربندی‌ها اعمال شده و سپس وضعیت به active تغییر می‌یابد.
.RE
.PP
devlink dev param show
.RS 4
نمایش (تخلیه) تمام پارامترهای پورت در سراسر دستگاه‌های ثبت‌شده در devlink.
.RE
.PP
devlink dev param set pci/0000:01:00.0/1 name internal_error_reset value true cmode runtime
.RS 4
تنظیم پارامتر internal_error_reset پورت devlink مشخص‌شده (#1) به true.
.RE
.PP
devlink port add pci/0000:06:00.0 flavour pcisf pfnum 0 sfnum 88 controller 1
.RS 4
افزودن یک پورت devlink با گونه PCI SF روی کنترل‌کننده 1 که دارای PCI PF با شماره 0 و شماره SF برابر با 88 است. برای استفاده از تابع، یک توالی نمونه به این صورت است: افزودن پورت، پیکربندی ویژگی تابع و فعال‌سازی تابع. پس از اتمام استفاده از تابع، غیرفعال‌سازی تابع و در نهایت حذف پورت. زمانی که تمایل به استفاده مجدد از پورت بدون حذف آن وجود دارد، می‌توان آن را در وضعیتی که تابع غیرفعال (inactive) و وضعیت عملیاتی آن منفصل (detached) است، مجدداً پیکربندی و فعال کرد.
.RE

.SH "همچنین ببینید (SEE ALSO)"
.BR devlink (8),
.BR devlink\-dev (8),
.BR devlink\-sb (8),
.BR devlink\-monitor (8),
.BR devlink\-health (8),
.br

.SH "نویسنده (AUTHOR)"
Jiri Pirko <jiri@mellanox.com>