svn commit: r347289 - in head: share/man/man4 usr.sbin/mlx5tool

[Hans Petter Selasky]

Author: hselasky
Date: Wed May  8 10:51:07 2019
New Revision: 347289
URL: https://svnweb.freebsd.org/changeset/base/347289

Log:
  Document userspace firmware flash in mlx5tool(8) and mlx5io(4).
  
  Submitted by:	kib@
  MFC after:	3 days
  Sponsored by:	Mellanox Technologies

Modified:
  head/share/man/man4/mlx5io.4
  head/usr.sbin/mlx5tool/mlx5tool.8

Modified: head/share/man/man4/mlx5io.4
==============================================================================
--- head/share/man/man4/mlx5io.4	Wed May  8 10:50:35 2019	(r347288)
+++ head/share/man/man4/mlx5io.4	Wed May  8 10:51:07 2019	(r347289)
@@ -1,5 +1,5 @@
 .\"
-.\" Copyright (c) 2018 Mellanox Technologies
+.\" Copyright (c) 2018, 2019 Mellanox Technologies
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -121,6 +121,27 @@ struct mlx5_fwdump_reg {
 	uint32_t val;
 };
 .Ed
+.It Dv MLX5_FW_UPDATE
+Requests firmware update (flash) on the adapter specified by the
+.Dv devaddr
+using the firmware image in
+.Dv MFA2
+format.
+The argument for the ioctl command is the
+.Vt struct mlx5_fw_update
+with the following definition.
+.Bd -literal
+struct mlx5_fw_update {
+	struct mlx5_tool_addr devaddr;
+	void *img_fw_data;
+	size_t img_fw_data_len;
+};
+.Ed
+Image address in memory is passed in
+.Dv img_fw_data ,
+the length of the image is specified in
+.Dv img_fw_data_len
+field.
 .El
 .Sh FILES
 The

Modified: head/usr.sbin/mlx5tool/mlx5tool.8
==============================================================================
--- head/usr.sbin/mlx5tool/mlx5tool.8	Wed May  8 10:50:35 2019	(r347288)
+++ head/usr.sbin/mlx5tool/mlx5tool.8	Wed May  8 10:51:07 2019	(r347289)
@@ -1,5 +1,5 @@
 .\"
-.\" Copyright (c) 2018 Mellanox Technologies
+.\" Copyright (c) 2018, 2019 Mellanox Technologies
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -37,11 +37,14 @@
 .Fl e
 .Nm
 .Fl d Ar domain:bus:slot:func
-.Fl r
+.Fl rn
 .Nm
 .Fl d Ar domain:bus:slot:func
 .Fl o Ar file
 .Fl w
+.Nm
+.Fl d Ar domain:bus:slot:func
+.Fl f Ar file.mfa2
 .Sh DESCRIPTION
 The
 .Nm
@@ -82,6 +85,12 @@ Fetches the stored firmware dump and writes it into th
 by the
 .Fl o
 option argument.
+.It Fl f
+Flashes the firmware image
+.Fa file.mfa2
+to the specified adapter.
+Image must be in MFA2 pack format and contain a component suitable
+for the adapter hardware.
 .El
 .Sh FILES
 The