summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIru Cai <mytbk920423@gmail.com>2016-07-05 20:57:18 +0800
committerIru Cai <mytbk920423@gmail.com>2016-08-02 12:31:53 +0800
commit3a44dcd3a23ed8ccc16f6544a2c33927f63a9f57 (patch)
tree904ebebe9524bc45a820632bd5e317434c974f68
parent992f60ea1004d4750d201b93420ed301234cbb9f (diff)
downloadliveusb-builder-3a44dcd3a23ed8ccc16f6544a2c33927f63a9f57.tar.xz
support-a-new-distro.md: instruction to support a new distro
-rw-r--r--support-a-new-distro.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/support-a-new-distro.md b/support-a-new-distro.md
new file mode 100644
index 0000000..13655d3
--- /dev/null
+++ b/support-a-new-distro.md
@@ -0,0 +1,19 @@
+# Support a new distro
+
+## Global variables
+
+- ``ROOTPATH``: root of a USB stick mountpoint
+- ``KERNELDIR``: the place to install the kernel
+- ``DATADIR``: the place to install other data files, e.g. squashfs, iso files
+- ``ISOMNT``: the mount point that the iso file is mounted to with ``mount_iso``
+
+## How to support
+
+You can refer to [Arch Linux](distro/arch/). What you need is:
+
+- ``grub.cfg``: write the menuentry for your distro
+- ``install.sh``: a script file describing how to install the LiveCD to USB
+- ``mirrorlist``: where to download the iso file
+
+In ``install.sh``, ``ISOURL`` is the relative path to a mirror that shows the URL of the Live ISO file. You can use ``SHA256``,``SHA1`` or ``MD5`` for iso file checksum. ``install_live`` is the bash function that handles the install of the Live ISO to the USB stick.
+