DFU-SUFFIX(1) DFU-SUFFIX(1)

# [NAME](#NAME)

dfu-suffix - add, check, or remove DFU firmware file suffix

# [SYNOPSIS](#SYNOPSIS)

**dfu-suffix** \[*options*] **--add** *DFU\_FILE*

**dfu-suffix** **--check** *DFU\_FILE*

**dfu-suffix** **--delete** *DFU\_FILE*

**dfu-suffix** **--help**

**dfu-suffix** **--version**

# [DESCRIPTION](#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](#OPTIONS)

[**-v, --vid *vendorID***](#v,)

Specify USB vendor ID (hexadecimal)

[**-p, --pid *productID***](#p,)

Specify USB product ID (hexadecimal)

[**-d, --did *deviceID***](#d,)

Specify USB device ID (hexadecimal)

[**-S, --spec *version***](#S,)

Specify DFU specification version (hexadecimal)

[**-h, --help**](#h,)

Displays a help message.

[**-V, --version**](#V,)

Displays the software version.

# [EXAMPLES](#EXAMPLES)

[**dfu-suffix --vid 0123 --add firmware.dfu**](#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**](#dfu~2)

Checks the file firmware.dfu for a valid DFU suffix

[**dfu-suffix --delete firmware.dfu**](#dfu~3)

Removes a valid DFU suffix from the file firmware.dfu

# [EXIT VALUES](#EXIT_VALUES)

**0**

Success (also if suffix is missing)

**-64**

Usage error

# [LIMITATIONS](#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](#BUGS)

https://sourceforge.net/p/dfu-util/tickets/

# [COPYRIGHT](#COPYRIGHT)

License GPLv2: GNU GPL version 2

# [SEE ALSO](#SEE_ALSO)

[**dfu-prefix**(1)](/man/enterprise-packages/dfu-util/dfu-prefix.1), [**dfu-util**(1)](/man/enterprise-packages/dfu-util/dfu-util.1)

# [AUTHORS](#AUTHORS)

See AUTHORS file in source.

September 2021 dfu-util 0.11

---

Document: dfu-suffix(1) from dfu-util 0.11-r4 (Chainguard OS)
Source: https://git.code.sf.net/p/dfu-util/dfu-util