[patch 1/1]erofs-utils:0001-Improve-README.patch
Arshad Hussain
arshad.super at gmail.com
Sun Mar 3 23:39:15 AEDT 2019
Hi Gao Xiang,
I prepared the patch using format-patch. Wonder why that should be broken. Thanks anyway for accepting and applying!.
Presently, from the TODO list. I am trying to figure out the on disk layout of erofs in an attempt to prepare a document out of it.
Currently, I am just reverse engineering the structs to figure out. (This is for the no compress version). Do you have any
other docs you can upload to help out. ?
Please do put out extensive TODO (I know you have it for erofs) for both erofs-utils(mkfs) and erofs so I can start contributing
Thanks,
Arshad
On 03-Mar-2019, at 12:34 pm, Gao Xiang <hsiangkao at aol.com> wrote:
> Original patch seems broken. I apply it by hand with some minor changes...
>
> From b6d8c8c6fa91a8ffa7c138578d6315b768372476 Mon Sep 17 00:00:00 2001
> From: Arshad Hussain <arshad.super at gmail.com>
> Date: Sun, 3 Mar 2019 14:46:44 +0800
> Subject: [PATCH] erofs-utils: improve README
>
> This patch improves the build section and
> adds the example/specimen usage section in
> the README file.
>
> Signed-off-by: Arshad Hussain <arshad.super at gmail.com>
> ---
> README | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++---
> 1 file changed, 63 insertions(+), 3 deletions(-)
>
> diff --git a/README b/README
> index 4e34159..9014268 100644
> --- a/README
> +++ b/README
> @@ -21,8 +21,14 @@ How to build with lz4 static library
> ./configure --with-lz4=<lz4 install path>
> eg. if lz4 lib has been installed into fold of /usr/local/lib
> ./configure --with-lz4=/usr/local/lib && make
> -Maybe you should run this first:
> - ./autogen.sh
> +On Fedora, static lz4 can be installed using:
> + yum install lz4-static.x86_64
> +To build you should run this first:
> + $ ./autogen.sh
> + $ ./configure
> + $ make
> +
> +mkfs.erofs binary will be generated under mkfs folder.
>
> Usage:
> $ ./mkfs.erofs
> @@ -35,7 +41,61 @@ Usage:
> -d -- set debugging level <dbglvl>
> -z -- enable <compr_algri> compression (only lz4hc is supported)
>
> - target path, source directory are both needed.
> + Target path, source directory are both needed.
> +
> +Specimen Usage:
> +1) Create a temporary Disk
> +$ dd if=/dev/zero of=erofs_disk bs=512 count=23000
> +
> +2) Create and populate source directory
> +$ mkdir -p srcd
> +
> +Our sample source directory contents
> +$ ls -ali srcd/
> +total 44
> +425555 drwxr-xr-x 2 root root 4096 Feb 23 06:55 .
> +425533 drwxr-xr-x 9 root root 4096 Feb 26 06:54 ..
> +422789 -rw-r--r-- 1 root root 0 Feb 22 14:52 ChangeLog
> ++422793 -rw-r--r-- 1 root root 3195 Feb 23 06:55 configure.ac
> ++422794 -rw-r--r-- 1 root root 25763 Feb 23 06:55 Makefile
> ++422796 -rw-r--r-- 1 root root 1879 Feb 23 06:55 README
> +
> +3) Run mkfs.erofs
> + ./mkfs/mkfs.erofs ./erofs_disk ./srcd/
> + c_version: [0.1 Feb 22 2019 14:13:38]
> + c_img_path: [./erofs_disk]
> + c_src_path: [/root/arshad/erofs-utils/srcd]
> + c_dbg_lvl: [ 0]
> + c_dry_run: [ 0]
> + c_alg_name: [ none]
> + c_compr_maxsz: [ 921600]
> + c_compr_lvl: [ 0]
> + c_compr_boundary: [ 128]
> + c_compr_ratio_limit: [ 100]
> +
> +4) Load erofs.ko module
> +$ insmod drivers/staging/erofs/erofs.ko
> +
> +5) Mount erofs_disk image
> +$ mount -t erofs erofs_disk /mnt/vg1 -o loop
> +
> +6) Check FS type mount reports
> +$ mount | grep erofs
> +/root/arshad/erofs-utils/erofs_disk on /mnt/vg1 type erofs ro,relatime,user_xattr,acl)
> +
> +7) Check the contents of the mounted FS
> +$ ls -ali /mnt/vg1/
> +total 31
> + 4 -rw-r--r-- 1 root root 0 Feb 23 06:55 ChangeLog
> +896 -rw-r--r-- 1 root root 3195 Feb 23 06:55 configure.ac
> + 5 -rw-r--r-- 1 root root 25763 Feb 23 06:55 Makefile
> + 44 -rw-r--r-- 1 root root 1879 Feb 23 06:55 README
> +
> +8) Umount /mnt/vg1
> +$ umount /mnt/vg1
> +
> +9) Unload erofs module
> +$ rmmod erofs
>
> To:
> linux-erofs mailing list <linux-erofs at lists.ozlabs.org>
> --
> 2.11.0
>
>
> On 2019/3/3 14:02, Gao Xiang wrote:
>> Hi Arshad,
>>
>> On 2019/3/2 21:04, arshad hussain wrote:
>>> Hi,
>>>
>>> This patch improves the build section and
>>> adds the example/specimen usage section in
>>> the README file.
>>>
>>> Signed-off-by: Arshad Hussain <arshad.super at gmail.com>
>>
>>
>> Thanks for improving the mkfs README.
>> mkfs is now under refactoring in order to make it more clean and straight-forward,
>> yet its progress is somewhat slow.
>>
>> Anyway, I will take this patch and thanks for your contributing :)
>>
>>
>> Thanks,
>> Gao Xiang
>>
>>
>>> ----
>>> # cat 0001-Improve-README.patch
>>> From a2aa7e7b8938f1190d1618a5dda9f5c32cf3215e Mon Sep 17 00:00:00 2001
>>> From: Arshad Hussain <arshad.super at gmail.com>
>>> Date: Tue, 26 Feb 2019 10:30:04 +0530
>>> Subject: [PATCH] Improve README
>>>
>>> This patch improves the build section and
>>> adds the example/specimen usage section in
>>> the README file.
>>> ---
>>> README | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++---
>>> 1 file changed, 63 insertions(+), 3 deletions(-)
>>>
>>> diff --git a/README b/README
>>> index 4e34159..b5b605a 100644
>>> --- a/README
>>> +++ b/README
>>> @@ -21,8 +21,14 @@ How to build with lz4 static library
>>> ./configure --with-lz4=<lz4 install path>
>>> eg. if lz4 lib has been installed into fold of /usr/local/lib
>>> ./configure --with-lz4=/usr/local/lib && make
>>> -Maybe you should run this first:
>>> - ./autogen.sh
>>> +On Fedora, static lz4 can be installed using:
>>> + yum install lz4-static.x86_64
>>> +To build you should run this first:
>>> + $ ./autogen.sh
>>> + $ ./configure
>>> + $ make
>>> +
>>> +mkfs.erofs binary will be generated under mkfs folder.
>>>
>>> Usage:
>>> $ ./mkfs.erofs
>>> @@ -35,7 +41,61 @@ Usage:
>>> -d -- set debugging level <dbglvl>
>>> -z -- enable <compr_algri> compression (only lz4hc is supported)
>>>
>>> - target path, source directory are both needed.
>>> + Target path, source directory are both needed.
>>> +
>>> +Specimen Usage:
>>> +Create a temporary Disk
>>> +$ dd if=/dev/zero of=erofs_disk bs=512 count=23000
>>> +
>>> +Create and populate source directory
>>> +$ mkdir -p srcd
>>> +
>>> +Our sample source directory contents
>>> +$ ls -ali srcd/
>>> +total 44
>>> +425555 drwxr-xr-x 2 root root 4096 Feb 23 06:55 .
>>> +425533 drwxr-xr-x 9 root root 4096 Feb 26 06:54 ..
>>> +422789 -rw-r--r-- 1 root root 0 Feb 22 14:52 ChangeLog
>>> +422793 -rw-r--r-- 1 root root 3195 Feb 23 06:55 configure.ac
>>> +422794 -rw-r--r-- 1 root root 25763 Feb 23 06:55 Makefile
>>> +422796 -rw-r--r-- 1 root root 1879 Feb 23 06:55 README
>>> +
>>> +Run mkfs.erofs
>>> +$ ./mkfs/mkfs.erofs ./erofs_disk ./srcd/
>>> + c_version: [0.1 Feb 22 2019 14:13:38]
>>> + c_img_path: [./erofs_disk]
>>> + c_src_path: [/root/arshad/erofs-utils/srcd]
>>> + c_dbg_lvl: [ 0]
>>> + c_dry_run: [ 0]
>>> + c_alg_name: [ none]
>>> + c_compr_maxsz: [ 921600]
>>> + c_compr_lvl: [ 0]
>>> + c_compr_boundary: [ 128]
>>> + c_compr_ratio_limit: [ 100]
>>> +
>>> +Load erofs.ko module
>>> +$ insmod drivers/staging/erofs/erofs.ko
>>> +
>>> +Mount erofs_disk image
>>> +$ mount -t erofs erofs_disk /mnt/vg1 -o loop
>>> +
>>> +Check FS type mount reports
>>> +$ mount | grep erofs
>>> +/root/arshad/erofs-utils/erofs_disk on /mnt/vg1 type erofs
>>> (ro,relatime,user_xattr,acl)
>>> +
>>> +Check the contents of the mounted FS
>>> +$ ls -ali /mnt/vg1/
>>> +total 31
>>> + 4 -rw-r--r-- 1 root root 0 Feb 23 06:55 ChangeLog
>>> +896 -rw-r--r-- 1 root root 3195 Feb 23 06:55 configure.ac
>>> + 5 -rw-r--r-- 1 root root 25763 Feb 23 06:55 Makefile
>>> + 44 -rw-r--r-- 1 root root 1879 Feb 23 06:55 README
>>> +
>>> +Umount /mnt/vg1
>>> +$ umount /mnt/vg1
>>> +
>>> +Unload erofs module
>>> +$ rmmod erofs
>>>
>>> To:
>>> linux-erofs mailing list <linux-erofs at lists.ozlabs.org>
>>> --
>>> 2.14.3
More information about the Linux-erofs
mailing list