dfu-util(1) [debian man page]
DFU-UTIL(1) General Commands Manual DFU-UTIL(1) NAME
dfu-util - Device firmware update (DFU) USB programmer SYNOPSIS
dfu-util [-ldpciatUDRhvV] DESCRIPTION
dfu-util is a program that implements the host (computer) side of the USB DFU (Universal Serial Bus Device Firmware Upgrade) protocol. In the OpenMoko project (for example), this program is used to communicate with the specially enhanced u-boot boot loader, which implements the DFU device side. OPTIONS
-l, --list List the currently attached DFU capable USB devices. -d, --device VENDOR:PRODUCT Specify vendor/product ID of the DFU device. Both VENDOR and PRODUCT are hexadecimal numbers (no prefix needed). Example: $ dfu-util --device 1457:51ab If you only have one standards-compliant DFU device attached to your PC, this is optional. However, as soon as you have multiple DFU devices, dfu-util will detect this and abort, asking you to specify which device it shall use. -p, --path BUS-PORT. ... .PORT Specify the path to the DFU device. -c, --cfg CONFIG-NR Specify the configuration of the DFU device. -i, --intf INTF-NR Specify the DFU interface number. -a, --alt ALT Specify the altsetting of the DFU interface by name or by number. -t, --transfer-size Specify the number of bytes per USB transfer. If you don't supply this option, the maximum possible size for your combination of host OS and USB device is chosen (for optimal performance). -U, --upload FILE Read firmware from device into FILE. Note: Upload support is currently broken. -D, --download FILE Write firmware from FILE into device. -R, --reset Issue USB reset signalling once we are finished. -s, --dfuse-address Specify target address for raw binary download/upload on DfuSe devices. Do not use this for downloading DfuSe files. -h, --help Show a help text and exit. -v, --verbose Print more information about dfu-util's operation. A second -v will turn on verbose logging of USB requests. -V, --version Show version information and exit. EXAMPLES
Here are some examples for the usage of dfu-util in the OpenMoko project (working with the Neo1973 hardware): Flashing the rootfs: $ dfu-util -a rootfs -R -D /path/to/openmoko-devel-image.jffs2 Flashing the kernel: $ dfu-util -a kernel -R -D /path/to/uImage Flashing the bootloader: $ dfu-util -a u-boot -R -D /path/to/u-boot.bin Copying a kernel into RAM: $ dfu-util -a 0 -R -D /path/to/uImage Once this has finished, the kernel will be available at the default load address of 0x32000000 in Neo1973 RAM. Note: You cannot transfer more than 2MB of data into RAM using this method. BUGS
Please see http://wiki.openmoko.org/wiki/Dfu-util for some limitations and bugs in the current dfu-util code. Please report any further bugs at on the openmoko mailing list at openmoko@lists.openmoko.org. LICENCE
dfu-util is covered by the GNU General Public License (GPL), version 2 or later. AUTHORS
Weston Schmidt <weston_schmidt@yahoo.com> Harald Welte <hwelte@hmw-consulting.de> This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>. It is licensed under the terms of the GNU GPL (version 2 or later). February 29, 2008 DFU-UTIL(1)
Check Out this Related Man Page
EXFAT.UTIL(8) BSD System Manager's Manual EXFAT.UTIL(8) NAME
exfat.util -- ExFAT file system utility SYNOPSIS
exfat.util -p device removable writable exfat.util -k device exfat.util -s device exfat.util -m device directory removable writable nosuid nodev exfat.util -u device DESCRIPTION
The exfat.util command supports the probing of ExFAT file systems, and getting or setting a volume UUID. Options: -p device removable writable Probe the device to determine whether it contains an ExFAT file system. The removable and writable arguments are ignored for compat- ibility with other file system utilities. If the device appears to contain an ExFAT file system, the exit status is 255. If the file system contains a label (volume name), that name is written to standard output. If the device does not appear to contain an ExFAT file system, the exit status is 254. An exit status of 252 indicates that an I/O error occurred. -k device Return the volume UUID of the ExFAT file system on device. If the device appears to contain an ExFAT file system, the volume's UUID is written to standard output (as formatted by uuid_unparse(3)), and the exit status is 253. If the root directory contains a Volume GUID entry, that GUID is the value returned; otherwise, the 32-bit volume serial number stored in the boot sector is converted to a UUID and returned. If the device does not appear to contain an ExFAT file system, the exit status is 254. An exit status of 252 indicates that an I/O error occurred. device may be mounted or unmounted. If it is mounted, the UUID is obtained through the file system using the getattrlist(2) call. If the device is not mounted, exfat.util reads from the device directly. -s device Set a new UUID for the ExFAT file system on device, which must not be mounted. This generates a new UUID using uuid_generate(3) and stores that UUID in a Volume GUID entry in the root directory (creating one if one does not exist, or updating an existing entry). If the UUID is successfully set, the exit status is 253. If the device does not appear to contain an ExFAT file system, the exit status is 254. An exit status of 252 indicates that device was already mounted, or an I/O error occurred. -m device directory removable writable nosuid nodev Deprecated. Mount the ExFAT file system from device onto directory. The removable argument should be either removable if the device is removable, or fixed otherwise. The actual argument value is currently ignored. The writable argument must be either readonly or writable which mounts the volume read-only or read/write, respectively. The nosuid argument must be either suid or nosuid. That argument is passed as a mount option. The nodev argument must be either dev or nodev. That argument is passed as a mount option. -u device Deprecated. Unmount the file system on device. If the unmount is successful, the exit status is 253. FILES
The exfat.util command is installed in the /System/Library/Filesystems/exfat.fs directory, which is typically not in a shell's search path. COMPATIBILITY
The -m and -u options are deprecated. The preferred way to mount an ExFAT volume is to let diskarbitrationd(8) mount it automatically when the device is discovered, or use the diskutil(8) command to explicitly mount a device. You may also use the mount(8) or mount_exfat(8) com- mands directly. The preferred way to unmount an ExFAT volume is with the diskutil(8) command. Note that using the umount(8) command usually will not work because various process are likely to have open files, which will prevent the unmount. The diskutil(8) command will send a notification that causes many such processes to close their open files so that the unmount will succeed. SEE ALSO
mount_exfat(8), fsck_exfat(8), diskarbitrationd(8,) diskutil(8), uuid(3,) uuid_unparse(3), uuid_generate(3), getattrlist(2) HISTORY
The exfat.util utility first appeared in Mac OS X 10.6.3. BUGS
The choice of non-zero exit status to indicate success was an unfortunate design decision. The -u option usually does not work since several processes in Mac OS X leave files open on mounted volumes, thus preventing the unmount. The diskutil(8) command is preferred for unmounting. Darwin January 19, 2010 Darwin