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

@@ -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

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