1 files changed, 72 insertions, 0 deletions
diff --git a/doc/dfu-suffix.1.md b/doc/dfu-suffix.1.md
new file mode 100644
index 0000000..9bb4375
--- /dev/null
+++ b/doc/dfu-suffix.1.md
@@ -0,0 +1,72 @@
+% DFU-SUFFIX(1) dfu-util 0.11
+% See AUTHORS file in source
+% September 2021
+
+# NAME
+dfu-suffix - add, check, or remove DFU firmware file suffix
+
+# SYNOPSIS
+**dfu-suffix** [*options*] **\--add** *DFU_FILE*\
+**dfu-suffix** **\--check** *DFU_FILE*\
+**dfu-suffix** **\--delete** *DFU_FILE*\
+**dfu-suffix** **\--help**\
+**dfu-suffix** **\--version**
+
+# DESCRIPTION
+The program **dfu-suffix** can be used to add, check or remove a DFU firmware file suffix,
+recommended for safely matching a firmware file and device.
+
+Note that a suffix is recommended by the DFU standard, but not required.
+A DFU host tool like dfu-util will recognize the suffix and use it to check
+that the device is matching, but not transfer the suffix to the device.
+
+# OPTIONS
+-v, \--vid *vendorID*
+: Specify USB vendor ID (hexadecimal)
+
+-p, \--pid *productID*
+: Specify USB product ID (hexadecimal)
+
+-d, \--did *deviceID*
+: Specify USB device ID (hexadecimal)
+
+-S, \--spec *version*
+: Specify DFU specification version (hexadecimal)
+
+-h, \--help
+: Displays a help message.
+
+-V, \--version
+: Displays the software version.
+
+# EXAMPLES
+**dfu-suffix** \--vid 0123 \--add firmware.dfu
+: Adds a suffix matching vendor 0x0123 and product ID 0x4567.
+Since product and device ID are not specified,
+they will contain the wildcard value 0xFFFF.
+
+**dfu-suffix** \--check firmware.dfu
+: Checks the file firmware.dfu for a valid DFU suffix
+
+**dfu-suffix** \--delete firmware.dfu
+: Removes a valid DFU suffix from the file firmware.dfu
+
+# EXIT VALUES
+**0**
+: Success (also if suffix is missing)
+
+**-64**
+: Usage error
+
+# LIMITATIONS
+**dfu-suffix** can not tell a broken DFU suffix (e.g. checksum mismatch)
+from a non-existing suffix, so only a valid suffix can be removed.
+
+# BUGS
+https://sourceforge.net/p/dfu-util/tickets/
+
+# COPYRIGHT
+License GPLv2: GNU GPL version 2
+
+# SEE ALSO
+**dfu-prefix**(1), **dfu-util**(1)