[WIP] How to Write an Updater-Script with Edify Code

---

First and foremost I take no credit for the majority of this thread. I am merely posting this here as a reference for you all. I had to dig around a lot for this information and piece it together from several different threads as well as pull examples from updater-scripts in several different roms/theme/etc. Everyone else put in the work, I am just trying to make it easier for the rest of us .

Mounting Partitions:
MTD:

mount("MTD", "system", "/system");
mount("MTD", "userdata", "/data");
mount("MTD", "cache", "/cache");
mount("MTD", "sdcard", "/sdcard");

EMMC with EXT3 and EXT4 file systems:

mount("ext4", "EMMC", "/dev/block/mountpoint", "/system");
mount("ext4", "EMMC", "/dev/block/mountpoint", "/data");
mount("ext4", "EMMC", "/dev/block/mountpoint", "/cache");

mount("ext3", "EMMC", "/dev/block/mountpoint", "/system");
mount("ext3", "EMMC", "/dev/block/mountpoint", "/data");
mount("ext3", "EMMC", "/dev/block/mountpoint", "/cache");

“mountpoint” will vary from device to device. Decide what partition you want to mount, find where it mounts (there will be resources in the second post, and paste it in place of “mountpoint” in your script.

Mounting system, data, and cache on the EVO 3D

mount("ext4", "EMMC", "/dev/block/mmcblk0p23", "/system");
mount("ext4", "EMMC", "/dev/block/mmcblk0p24", "/data");
mount("ext4", "EMMC", "/dev/block/mmcblk0p25", "/cache");

Amend

none

Unmounting Partitions:
MTD and EMMC:

unmount("/system");
unmount("/data"); OR unmount("/userdata");
unmount("/cache");
unmount("/sdcard");

Amend

none

Format Partitions:
MTD:

format("MTD", "system");
format("MTD", "cache");
format("MTD", "data");
format("MTD", "boot");

EMMC EXT3/4:

format("ext4", "EMMC", "/dev/block/mountpoint");

format("ext3", "EMMC", "/dev/block/mountpoint");

Formatting system, data, cache, and boot on EVO 3D.

format("ext4", "EMMC", "/dev/block/mmcblk0p23");
format("ext4", "EMMC", "/dev/block/mmcblk0p24");
format("ext4", "EMMC", "/dev/block/mmcblk0p25");
format("ext4", "EMMC", "/dev/block/mmcblk0p22");

Amend:

format SYSTEM:
format DATA:
format BOOT:
format CACHE:

Copy files from .zip file to phone partition or sd card:

package_extract_dir("Source", "Destination");

“Source” = folder in .zip file. "Destination" = partition to copy to,

package_extract_dir("system", "/system");
package_extract_dir("data", "/data");
package_extract_dir("sdcard", "/sdcard");

Amend:

copy_dir PACKAGE:system SYSTEM:
copy_dir PACKAGE:data DATA:
copy_dir PACKAGE:sdcard SDCARD:

Write an .img file:
MTD:

assert(package_extract_file("boot.img", "/tmp/boot.img"),
write_raw_image("/tmp/boot.img", "boot"),
delete("/tmp/boot.img"));

EMMC:

package_extract_file("boot.img", "/dev/block/mountpoint");

Amend

write_raw_image PACKAGE:boot.img BOOT:

Output a line of text:
MTD/EMMC:

ui_print("Text Here");

Amend

none

Delete a file:

Use delete for a single file. Use delete recursive for an entire folder.

delete_recursive("file/path");

delete("/path/to/file");

Amend

delete_recursive PARTITION:path/to/file

delete PARTITION:path/to/file

Set ownership and permissions for folder:

set_perm_recursive(uid, gid, dmode, fmode, “/path/to/folder”);

Amend

set_perm_recursive uid gid dmode fmode PARTITION:path

Set ownership and permissions for a file:

set_perm(uid, gid, mode, “/path/to/file”);

Amend

set_perm uid gid mode PARTITION:file

Run a program:

run_program("programtorun");

Amend

run_program PACKAGE:programtorun

Creating symlinks:

symlink("/path/to/file", "/path/tofile");

Amend

symlink /path/to/file PARTITION:path/to/file

Progress bar:

show_progress(fraction, duration);

Amend

show_progress fraction, duration

Mount points for selected devices:

Evo 3D

mmcblk0p21          /boot
mmcblk0p23          /system
mmcblk0p24          /data
mmcblk0p25          /cache

Evo Shift 4G

mmcblk0p22          /boot
mmcblk0p26          /system
mmcblk0p27          /data
mmcblk0p28          /cache

Nexus S

mtdblock4				/cache
platform/s3c-sdhci.0/by-name		/system
platform/s3c-sdhci.0/by-name		/userdata

reserved for more info at a later date

excellent tutorial. answered a lot of questions i had

w00t w00t! thanks for this, dude!

http://forum.xda-developers.com/showthread.php?t=936175

A lot of information in there that I have bookmarked and used without problems.

Originally Posted by raiden89

http://forum.xda-developers.com/showthread.php?t=936175

A lot of information in there that I have bookmarked and used without problems.

Thanks. Will update. Just wanted to post something for the EVO users so we have our own thread to reference.

EDIT: Also, looks like he might be missing a few commands. Not a big deal. Any and all help is appreciated.

Oh yeah. Of course. I know some stuff is missing, but I also like the color coding of it and showing what the Amend syntax is compared to the Edify. So, I thought I would post it. It's been useful to me.

thank you so much for making this. now people will stop bothering me and tiffany about our fantastic zips not working in cwm 3.+

Some more resources for you all...

Here and here (source code is included if you would like to see the conversions being done).

=]