Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
DFU-SUFFIX(1)							   DFU-SUFFIX(1)

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 wild-
	    card 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.

dfu-util 0.11			 September 2021 		   DFU-SUFFIX(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dfu-suffix&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help