Файлы System/bin Android 12. Справочник.


  Все     Команда     Скрипт     Служба     Приложение  

lpmake
Создание образа раздела Super

Тип файла: команда
  Eng  

usage: lpmake [параметры]

Требуемые параметры:

  • -d,--device-size=[SIZE|auto] Размер блочного устройства для логических разделов
    Может быть установлен на автоматический для автоматического расчета
    минимального размера, сумма размеров разделов плюс размер метаданных,
    умноженная на количество разделов

  • -m,--metadata-size=SIZE Максимальный размер, резервируемый
    для метаданных раздела

  • -s,--metadata-slots=COUNT Количество слотов для хранения копий метаданных

  • -p,--partition=DATA Добавить раздел с данными, см. ниже

  • -o,--output=ФАЙЛ Выходной файл

    Необязательные параметры:

  • -b,--block-size=РАЗМЕР Размер физического блока, по умолчанию 4096

  • -a,--alignment=N Оптимальное выравнивание раздела в байтах

  • -O,--alignment-offset=N Смещение выравнивания в байтах относительно
    родительского устройства

  • -S,--sparse Вывести разреженный образ для fastboot

  • -i,--image=РАЗДЕЛ=ФАЙЛ При создании разреженного образа для fastboot включить
    данный файл (или разреженный файл) в качестве исходных данных
    для именованного раздела

  • -g,--group=GROUP:SIZE Определить именованную группу разделов с заданным
    максимальным размером

  • -D,--device=DATA Добавить блочное устройство, на которое распространяется Super
    Если указано, то -d/--device-size и выравнивание указывать не нужно.
    Формат для ДАННЫХ указан ниже

  • -n,--super-name=ИМЯ Указать имя блочного устройства, на котором будет
    размещен раздел супер

  • -x,--auto-slot-suffixing Пометить блочное устройство и имена разделов,
    требующие суффиксы слотов перед использованием

  • -F,--force-full-image Принудительно записать полный образ,
    даже если образы разделов не указаны.
    Обычно это создает минимальный файл super_empty.img, который нельзя прошить;
    force-full-image создаст flashable изображение.

  • --virtual-ab Добавить флаг VIRTUAL_AB_DEVICE в заголовок метаданных
    Обратите внимание, что для полученного super.img потребуется библиотека,
    поддерживающая разбора заголовка версии 1.2

    Формат данных раздела:
    <name>:<attributes>:<size>[:group]

    attributes должен быть 'none' или 'readonly'

    Формат данных устройства:
    <partition_name>:<size>[:<alignment>:<alignment_offset>]

    Имя раздела — это базовое имя файла /dev/block/by-name/
    путь блочного устройства
    Размер — это размер устройства в байтах.
    Параметры выравнивания и смещения выравнивания одинаковы
    как -a/--alignment и -O/--alignment-offse


    ===============================================
    lpmake — это инструмент командной строки для создания образа раздела Super.
    В настоящее время он может генерировать два типа образов:

    * Разреженные образы для традиционной быстрой загрузки.
    * Образы, содержащие только метаданные, для утилиты lpflash.

    Требуются следующие аргументы командной строки:

  • -d,--device-size - Размер раздела Super на устройстве.
    Он должен точно совпадать и делиться нацело на размер сектора (512 байт).

  • -m,--metadata-size — максимальный размер, который могут потреблять
    метаданные раздела.
    Для записи раздела используется 64 байта, для записи экстента — 16 байт.
    Минимальный размер 512 байт.

  • -s,--metadata-slots — количество слотов, доступных для хранения метаданных.
    Это должно соответствовать количеству слотов обновления на устройстве:
    1 для устройств без A/B
    2 для устройств A/B

  • -p,--partition=DATA — добавить раздел в метаданные.
    Должен быть определен хотя бы один раздел.
    Строка данных имеет следующий формат: <имя>:<GUID>:<атрибуты>:<размер>.
    Атрибуты должны быть либо пустыми, либо только для чтения.
    Размер будет округлен до ближайшего выровненного блока (см. ниже).

  • -o,--output=ФАЙЛ - Выходной файл для записи образа.

    Необязательные аргументы:

  • --alignment=N — по умолчанию lpmake выравнивает разделы по границам 1 МБ.
    Однако при желании можно указать альтернативное выравнивание.
    Это полезно для устройств с минимальным размером запроса ввода-вывода,
    где неправильно выровненные границы раздела могут быть проблемой
    производительности.

  • --alignment-offset=N — в некоторых случаях раздел Super не выровнен внутри
    своего родительского блочного устройства.
    Это смещение можно использовать для исправления.

  • --sparse — если установлено, выходной образ будет в разреженном формате
    для прошивки через fastboot.
    В противном случае по умолчанию образ будет иметь минимальный формат,
    который можно использовать с lpdump и lpflash.

  • -b,--block-size=N — при записи разреженного образа устройству может потребоваться
    определенный размер блока. Размер этого блока можно указать здесь.
    Выравнивание должно быть кратно размеру блока.
    По умолчанию размер блока равен 4096.

  • -i,--image=[ИМЯ=ФАЙЛ] — при записи разреженного образа включить содержимое
    ФАЙЛА в качестве данных для раздела с именем ИМЯ.
    Файл может быть обычным файлом или разреженным образом,
    но целевой размер должен быть меньше или равен размеру раздела.
    Этот параметр доступен только при создании разреженных образов.

    Пример использования.
    Создание раздела Super размером 10 ГБ для устройства A/B
    с одним разделом Cache размером 64 МБ.

    lpmake --device-size 10240000000 \

  • --metadata-size 65536 \

  • --metadata-slots 2 \

  • -o /tmp/super.img \

  • -p "cache:2da85788-f0e1-4fda-9ee7-e5177eab184b:none:67108864" \

  • -i "cache=out/target/hikey960/cache.img"