# Modify partition layout

This section explains how to add, delete, modify, or rename partitions. Configuration files that define partitions for the UFS and eMMC devices are located at:

- `layers/meta-qcom-hwe/recipes-devtools/partition-utils/qcom-partition-confs/ufs/qcm6490-partitions.conf` (for UFS)
- `layers/meta-qcom-hwe/recipes-devtools/partition-utils/qcom-partition-confs/emmc/qcm6490-partitions.conf` (for eMMC)

To add a partition, add a row entry to this file. To remove a partition, delete the corresponding entry to remove the target partition from the set of images to be flashed.

Many partitions are crucial for functionality. To understand the details
of how this file plays a role in generating the partition table, see [Manage partitions in Qualcomm Linux](https://docs.qualcomm.com/doc/80-70020-27/topic/managing_partitions_in_qualcomm_linux.html#managing-partitions-in-qualcomm-linux).

**Example 1: Add a partition**

To add a partition with name `test` in LUN0, add the following line to
`qcm6490-partitions.conf` under LUN0 section:

--partition --lun=0 --name=test --size=4096KB --type-guid=1B81F7E6-F50D-419B-A739-2AEFF8DA3335
    Copy to clipboard

This adds a 4 MB partition test to LUN0 and a GUID
determined by you. This partition isn’t flashed with any image,
but it’s available as a raw partition after the device boots up. As
this partition is added to LUN0, it shows up at either of the following
options:

- `/dev/sda<N>`
- `/dev/disk/by-partlabel/test`

Note

To reflect the changes in `qcm6490-partitions.conf`, update the preferred provider. For more information, see [Modify partition](https://docs.qualcomm.com/doc/80-70020-27/topic/managing_partitions_in_qualcomm_linux.html#modify-partition).

**Example 2: Add a partition with a binary to be flashed tothe newly created partition**

To add a partition with name `test1` in LUN0, add the following line
to `qcm6490-partitions.conf` under LUN0 section:

--partition --lun=0 --name=test --size=4096KB --type-guid=1B81F7E6-F50D-419B-A739-2AEFF8DA3335 --filename=test1.bin
    Copy to clipboard

Deploy the new `test1.bin` binary in
`build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-core-kit/$(image_name)`.

## Next steps

- Customize kernel

    To customize the kernel, see [Qualcomm Linux Kernel Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-3/).

Last Published: Jul 02, 2025

[Previous Topic
Customize image features](https://docs.qualcomm.com/bundle/publicresource/80-70020-27/topics/customizing_image_features.md) [Next Topic
Use of devtool](https://docs.qualcomm.com/bundle/publicresource/80-70020-27/topics/use_of_devtool.md)