.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "FASTBOOT" "1" "" "android-platform-system-core" "fastboot Manuals"
.hy
.SH NAME
.PP
fastboot - Android flashing and booting utility
.SH SYNOPSIS
.PP
\f[B]fastboot\f[R] [-w] [-u] [-s \f[I]device\f[R]] [-p
\f[I]product\f[R]] [-c \f[I]cmdline\f[R]] [-i \f[I]vendorId\f[R]] [-b
\f[I]baseAddr\f[R]] [-n \f[I]pageSize\f[R]] [-S \f[I]size\f[R][K|M|G]]
\f[I]command\f[R]
.SH DESCRIPTION
.PP
WARNING: This manual might be outdated, please refer to the official
documentation.
.PP
\f[B]fastboot\f[R] is a command line tool for flashing an Android
device, boot an Android device to fastboot mode, etc..
.SH OPTIONS
.TP
-w
Erase userdata and cache (and format if supported by partition type).
.TP
-u
Do not erase partition before formatting.
.TP
-s \f[I]device\f[R]
Specify device serial number or path to device port.
.TP
-l
With \f[B]devices\f[R] command, list device paths.
.TP
-p \f[I]product\f[R]
Specify product name.
.TP
-c \f[I]cmdline\f[R]
Override kernel commandline.
.TP
-i \f[I]vendorId\f[R]
Specify a custom USB vendor ID.
.TP
-b|--base \f[I]baseAddr\f[R]
Specify a custom kernel base address (default: \f[B]0x10000000\f[R]).
.TP
--kernel-offset
Specify a custom kernel offset (default: \f[B]0x00008000\f[R]).
.TP
--ramdisk-offset
Specify a custom ramdisk offset (default: \f[B]0x01000000\f[R]).
.TP
--tags-offset \f[I]offset\f[R]
Specify a custom tags offset (default: \f[B]0x00000100\f[R]).
.TP
-n|--page-size \f[I]pageSize\f[R]
Specify the nand page size (default: \f[B]2048\f[R]).
.TP
-S \f[I]size\f[R][K|M|G]
Automatically sparse files greater than \[aq]size\[aq].
\f[B]0\f[R] to disable.
.TP
--slot \f[I]suffix\f[R]
Specify slot suffix to be used if the device supports slots.
This will be added to all partition names that use slots.
\f[B]all\f[R] can be given to refer to all slots.
\f[B]other\f[R] can be given to refer to a non-current slot.
If this flag is not used, slotted partitions will default to the current
active slot.
.TP
-a, --set-active[=]
Sets the active slot.
If no suffix is provided, this will default to the value given by
\f[B]--slot\f[R].
If slots are not supported, this does nothing.
This will run after all non-reboot commands.
.TP
--wipe-and-use-fbe
On devices which support it, erase userdata and cache, and enable
file-based encryption.
.TP
--unbuffered
Do not buffer input or output.
.TP
--version
Display version.
.TP
-h|--help
show this message.
.SH COMMANDS
.TP
fastboot update \f[I]filename\f[R]
Reflash device from update.zip.
.TP
fastboot flashall
Flash boot, system, vendor, and (if found) recovery.
.TP
fastboot flash \f[I]partition\f[R] [\f[I]filename\f[R]]
Write a file to a flash partition.
.TP
fastboot flashing lock
Locks the device.
Prevents flashing.
.TP
fastboot flashing unlock
Unlocks the device.
Allows flashing any partition except bootloader-related partitions.
.TP
fastboot flashing lock_critical
Prevents flashing bootloader-related partitions.
.TP
fastboot flashing unlock_critical
Enables flashing bootloader-related partitions.
.TP
fastboot flashing get_unlock_ability
Queries bootloader to see if the device is unlocked.
.TP
fastboot erase \f[I]partition\f[R]
Erase a flash partition.
.TP
fastboot format[:[\f[I]fs type\f[R]][:[\f[I]size\f[R]]] \f[I]partition\f[R]
Format a flash partition.
Can override the fs type and/or size the bootloader reports.
.TP
fastboot getvar \f[I]variable\f[R]
Display a bootloader variable.
.TP
fastboot set_active \f[I]suffix\f[R]
Sets the active slot.
If slots are not supported, this does nothing.
.TP
fastboot boot \f[I]kernel\f[R] [\f[I]ramdisk\f[R] [\f[I]second\f[R]]]
Download and boot kernel.
.TP
fastboot flash:raw boot \f[I]kernel\f[R] [\f[I]ramdisk\f[R] [\f[I]second\f[R]]]
Create bootimage and flash it.
.TP
fastboot devices [-l]
List all connected devices (with device paths if \f[B]-l\f[R] is used).
.TP
fastboot continue
Continue with autoboot.
.TP
fastboot reboot [bootloader]
Reboot device [into bootloader].
.TP
fastboot reboot-bootloader
Reboot device into bootloader.
.TP
fastboot help
Show this help message.
.SH AUTHORS
The Android Open Source Project.