---
name: "dfu-suffix"
section: "1"
platform: "linux"
package: "dfu-util"
version: "0.11-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/dfu-suffix"
---

# dfu-suffix(1)

add, check, or remove DFU firmware file suffix

## 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-prefix/1.md), [**dfu-util**(1)](/dfu-util/1.md)

## AUTHORS

See AUTHORS file in source.