Manpage logo

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

NAME  SYNOPSIS  DESCRIPTION  OPTIONS  EXAMPLES  EXIT VALUES  LIMITATIONS  BUGS  COPYRIGHT  SEE ALSO  AUTHORS 

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)

AUTHORS

See AUTHORS file in source.


Updated 2026-06-01 - jenkler.se | uex.se