From ff08edcb03eea051052a559914ac0a11777f2593 Mon Sep 17 00:00:00 2001
From: Hans Petter Selasky <hselasky@FreeBSD.org>
Date: Wed, 8 May 2019 10:51:07 +0000
Subject: [PATCH] Document userspace firmware flash in mlx5tool(8) and
 mlx5io(4).

Submitted by:	kib@
MFC after:	3 days
Sponsored by:	Mellanox Technologies
---
 share/man/man4/mlx5io.4      | 23 ++++++++++++++++++++++-
 usr.sbin/mlx5tool/mlx5tool.8 | 13 +++++++++++--
 2 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/share/man/man4/mlx5io.4 b/share/man/man4/mlx5io.4
index 098285639c59..ed46c172c653 100644
--- a/share/man/man4/mlx5io.4
+++ b/share/man/man4/mlx5io.4
@@ -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
diff --git a/usr.sbin/mlx5tool/mlx5tool.8 b/usr.sbin/mlx5tool/mlx5tool.8
index 5966102bdd53..64eb03b40a94 100644
--- a/usr.sbin/mlx5tool/mlx5tool.8
+++ b/usr.sbin/mlx5tool/mlx5tool.8
@@ -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 the file specified
 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