man/man8/devlink-dev.8

   1 .TH DEVLINK\-DEV 8 "14 Mar 2016" "iproute2" "Linux"
   2 .SH NAME
   3 devlink-dev \- devlink device configuration
   4 .SH SYNOPSIS
   5 .sp
   6 .ad l
   7 .in +8
   8 .ti -8
   9 .B devlink
  10 .RI "[ " OPTIONS " ]"
  11 .B dev
  12 .RI  " { " COMMAND " | "
  13 .BR help " }"
  14 .sp
  15
  16 .ti -8
  17 .IR OPTIONS " := { "
  18 \fB\-V\fR[\fIersion\fR] |
  19 \fB\-n\fR[\fIno-nice-names\fR] }
  20
  21 .ti -8
  22 .B devlink dev show
  23 .RI "[ " DEV " ]"
  24
  25 .ti -8
  26 .B devlink dev help
  27
  28 .ti -8
  29 .BR "devlink dev eswitch set"
  30 .IR DEV
  31 .RI "[ "
  32 .BR mode " { " legacy " | " switchdev " } "
  33 .RI "]"
  34 .RI "[ "
  35 .BR inline-mode " { " none " | " link " | " network " | " transport " } "
  36 .RI "]"
  37 .RI "[ "
  38 .BR encap " { " disable " | " enable " } "
  39 .RI "]"
  40
  41 .ti -8
  42 .BR "devlink dev eswitch show"
  43 .IR DEV
  44
  45 .ti -8
  46 .BR "devlink dev param set"
  47 .IR DEV
  48 .BR name
  49 .IR PARAMETER
  50 .BR value
  51 .IR VALUE
  52 .BR cmode " { " runtime " | " driverinit " | " permanent " } "
  53
  54 .ti -8
  55 .BR "devlink dev param show"
  56 .RI "[ "
  57 .IR DEV
  58 .BR name
  59 .IR PARAMETER
  60 .RI "]"
  61
  62 .ti -8
  63 .BR "devlink dev reload"
  64 .IR DEV
  65
  66 .SH "DESCRIPTION"
  67 .SS devlink dev show - display devlink device attributes
  68
  69 .PP
  70 .I "DEV"
  71 - specifies the devlink device to show.
  72 If this argument is omitted all devices are listed.
  73
  74 .in +4
  75 Format is:
  76 .in +2
  77 BUS_NAME/BUS_ADDRESS
  78
  79 .SS devlink dev eswitch show - display devlink device eswitch attributes
  80 .SS devlink dev eswitch set  - sets devlink device eswitch attributes
  81
  82 .TP
  83 .BR mode " { " legacy " | " switchdev " } "
  84 Set eswitch mode
  85
  86 .I legacy
  87 - Legacy SRIOV
  88
  89 .I switchdev
  90 - SRIOV switchdev offloads
  91
  92 .TP
  93 .BR inline-mode " { " none " | " link " | " network " | " transport " } "
  94 Some HWs need the VF driver to put part of the packet headers on the TX descriptor so the e-switch can do proper matching and steering.
  95
  96 .I none
  97 - None
  98
  99 .I link
 100 - L2 mode
 101
 102 .I network
 103 - L3 mode
 104
 105 .I transport
 106 - L4 mode
 107
 108 .TP
 109 .BR encap " { " disable " | " enable " } "
 110 Set eswitch encapsulation support
 111
 112 .I disable
 113 - Disable encapsulation support
 114
 115 .I enable
 116 - Enable encapsulation support
 117
 118 .SS devlink dev param set  - set new value to devlink device configuration parameter
 119
 120 .TP
 121 .BI name " PARAMETER"
 122 Specify parameter name to set.
 123
 124 .TP
 125 .BI value " VALUE"
 126 New value to set.
 127
 128 .TP
 129 .BR cmode " { " runtime " | " driverinit " | " permanent " } "
 130 Configuration mode in which the new value is set.
 131
 132 .I runtime
 133 - Set new value while driver is running. This configuration mode doesn't require any reset to apply the new value.
 134
 135 .I driverinit
 136 - Set new value which will be applied during driver initialization. This configuration mode requires restart driver by devlink reload command to apply the new value.
 137
 138 .I permanent
 139 - New value is written to device's non-volatile memory. This configuration mode requires hard reset to apply the new value.
 140
 141 .SS devlink dev param show - display devlink device supported configuration parameters attributes
 142
 143 .BR name
 144 .IR PARAMETER
 145 Specify parameter name to show.
 146 If this argument is omitted all parameters supported by devlink devices are listed.
 147
 148 .SS devlink dev reload - perform hot reload of the driver.
 149
 150 .PP
 151 .I "DEV"
 152 - Specifies the devlink device to reload.
 153
 154 .SH "EXAMPLES"
 155 .PP
 156 devlink dev show
 157 .RS 4
 158 Shows the state of all devlink devices on the system.
 159 .RE
 160 .PP
 161 devlink dev show pci/0000:01:00.0
 162 .RS 4
 163 Shows the state of specified devlink device.
 164 .RE
 165 .PP
 166 devlink dev eswitch show pci/0000:01:00.0
 167 .RS 4
 168 Shows the eswitch mode of specified devlink device.
 169 .RE
 170 .PP
 171 devlink dev eswitch set pci/0000:01:00.0 mode switchdev
 172 .RS 4
 173 Sets the eswitch mode of specified devlink device to switchdev.
 174 .RE
 175 .PP
 176 devlink dev param show pci/0000:01:00.0 name max_macs
 177 .RS 4
 178 Shows the parameter max_macs attributes.
 179 .RE
 180 .PP
 181 devlink dev param set pci/0000:01:00.0 name internal_error_reset value true cmode runtime
 182 .RS 4
 183 Sets the parameter internal_error_reset of specified devlink device to true.
 184 .RE
 185 .PP
 186 devlink dev reload pci/0000:01:00.0
 187 .RS 4
 188 Performs hot reload of specified devlink device.
 189
 190 .SH SEE ALSO
 191 .BR devlink (8),
 192 .BR devlink-port (8),
 193 .BR devlink-sb (8),
 194 .BR devlink-monitor (8),
 195 .br
 196
 197 .SH AUTHOR
 198 Jiri Pirko <jiri@mellanox.com>