website annotate en/doc/manuals/tazusb.en.html @ rev 542

tazusb*: add hooks
author Pascal Bellard <pascal.bellard@slitaz.org>
date Thu Sep 17 11:34:52 2009 +0200 (2009-09-17)
parents 0a622b3cbe2e
children
rev   line source
pankso@7 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
pankso@7 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
MikeDSmith25@117 3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
pankso@7 4 <head>
pankso@7 5 <title>TazUSB - SliTaz Live utility English manual</title>
pankso@7 6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
pankso@7 7 <meta name="description" content="slitaz bootable media LiveUSB key hd SD card" />
pankso@7 8 <meta name="expires" content="never" />
MikeDSmith25@117 9 <meta name="modified" content="2008-07-18 20:00:00" />
pankso@7 10 <style type="text/css"><!--
pankso@7 11 body { font: 90% sans-serif, vernada, arial; margin: 0; }
pankso@7 12 #header { background: #f0ba08; color: black; height: 50px;
pankso@7 13 border-top: 1px solid black; border-bottom: 1px solid black; }
pankso@7 14 #content { margin: 0px 50px 26px 50px; }
pankso@7 15 h1 { margin: 14px 0px 0px 16px; }
pankso@7 16 li { line-height: 1.4em; }
pankso@7 17 pre { padding: 5px; color: black; background: #e1e0b0; }
pankso@7 18 pre.script { padding: 10px; color: black; background: #e8e8e8;
pankso@7 19 border: 1px inset #333333; }
pankso@7 20 code { font-size: 100%; color: #669900; background: transparent; }
pankso@7 21 hr { color: white; background: white; height: 1px; border: 0; }
pankso@7 22 --></style>
pankso@7 23 </head>
pankso@7 24 <body bgcolor="#ffffff">
pankso@7 25 <div id="header">
pankso@7 26 <h1><font color="#3e1220">TazUSB Manual</font></h1>
pankso@7 27 </div>
pankso@7 28 <hr />
pankso@7 29 <!-- Start content -->
pankso@7 30 <div id="content">
pankso@7 31
paul@45 32 <h2>NAME</h2>
pankso@7 33 <p>
MikeDSmith25@117 34 TazUSB - SliTaz LiveUSB utility
pankso@7 35 </p>
pankso@7 36
pankso@7 37 <h2>SYNTAX</h2>
pankso@7 38 <pre>
paul@169 39 tazusb [command] [compression|device|file]
pankso@7 40 </pre>
pankso@7 41
pankso@7 42 <h2>DESCRIPTION</h2>
pankso@7 43 <p>
MikeDSmith25@117 44 TazUSB is a utility designed for installing SliTaz to a USB drive. Unlike a hard drive install, the filesystem is kept in a compressed "rootfs.gz" file. The filesystem is loaded entirely into memory upon boot. This should increase responsiveness, protect the filesystem against accidental corruption and reduce read/writes to the USB drive. Once setup, this utility can also rewrite the root filesystem with any changes you have made since booting up, giving the effective benefits of a hard drive install.
pankso@7 45 </p>
pankso@7 46 <p>
pankso@7 47 TazUSB supports both FAT32/EXT3 formatted drives using SYSLINUX and EXTLINUX respectively. "/home" is mounted on boot using the UUID of your particular flash drive. Unlike a device name, the UUID has the benefit of never changing from machine to machine.
pankso@7 48 </p>
pankso@7 49
pankso@7 50 <h2>COMMANDS</h2>
pascal@542 51 <a name="usage"></a>
pankso@7 52 <h3><font color="#6c0023">usage</font></h3>
pankso@7 53 <p>
pankso@9 54 The command 'usage' will display a short summary of all available commands.
pankso@7 55 </p>
pankso@7 56 <pre>
pankso@7 57 # tazusb usage
pankso@7 58 </pre>
pankso@7 59
pascal@542 60 <a name="writefs"></a>
pankso@7 61 <h3><font color="#6c0023">writefs</font></h3>
pankso@7 62 <p>
MikeDSmith25@117 63 The command 'writefs' will take the current memory resident filesystem and create a "rootfs.gz" file. If your flash drive is mounted as /home (as it should be), the new filesystem will be copied to the drive for you, otherwise it is left on the root of the drive. Your previous filesystem will be renamed to "previous.gz" and can be accessed on bootup by typing "previous" at the "boot:" prompt. All previous filesystems are renamed to rootfs.gz.unixtimestamp. These are not removed automatically, so you should periodically delete these to keep disk usage down.
pankso@7 64 </p>
pankso@7 65 <p>
pankso@9 66 Filesystem compression is supported in the form of lzma, gzip or none. Using no compression is very quick (under 5 seconds) and useful if you are experimenting with a lot of changes. By comparison, using lzma or gzip takes a few minutes but will dramatically reduce file size. This is recommended when committing permanent changes to the filesystem.
pankso@7 67 </p>
pankso@7 68 <pre>
pankso@7 69 # tazusb writefs compression
pankso@7 70 </pre>
pankso@7 71 Example:
pankso@7 72 <pre>
pankso@7 73 # tazusb writefs lzma
pankso@7 74 </pre>
pankso@7 75
pascal@542 76 <a name="format"></a>
pankso@7 77 <h3><font color="#6c0023">format</font></h3>
pankso@7 78 <p>
pankso@7 79 The command 'format' is used for formatting a device for use as a LiveUSB device. Currently, it only supports formatting as EXT3.
pankso@7 80 </p>
pankso@7 81 <pre>
pankso@7 82 # tazusb format /dev/name
pankso@7 83 </pre>
pankso@7 84 Example:
pankso@7 85 <pre>
pankso@7 86 # tazusb format /dev/sda1
pankso@7 87 </pre>
pankso@7 88
pascal@542 89 <a name="gen-liveusb"></a>
pankso@7 90 <h3><font color="#6c0023">gen-liveusb</font></h3>
pankso@7 91 <p>
MikeDSmith25@117 92 "gen-liveusb" will install a fresh MBR, set your partition as bootable and install syslinux/extlinux depending on the detected filesystem. It will then copy the kernel and filesystem from the CDROM drive, and place this on the target USB drive. This will leave you with a bootable USB copy of SliTaz.
pankso@7 93 </p>
pankso@7 94 <pre>
pankso@7 95 # tazusb gen-liveusb /dev/name
pankso@7 96 </pre>
pankso@7 97 Example:
pankso@7 98 <pre>
pankso@7 99 # tazusb gen-liveusb /dev/sda1
pankso@7 100 </pre>
paul@169 101
pascal@542 102 <a name="gen-swap"></a>
paul@172 103 <h3><font color="#6c0023">gen-swap</font></h3>
paul@169 104 <p>
paul@172 105 The 'gen-swap' command re/creates a virtual swap file and places
paul@169 106 it in the /home directory to be activated on each boot. This is useful
paul@169 107 for old systems with low memory.
paul@169 108 </p>
paul@172 109 <pre> # tazusb gen-swap
paul@169 110 </pre>
paul@169 111
pascal@542 112 <a name="gen-iso2usb"></a>
paul@169 113 <h3><font color="#6c0023">gen-iso2usb</font></h3>
paul@169 114 <p>
paul@169 115 This command performs the same task as gen-liveusb, only copying the Kernel
paul@169 116 and filesystem from a downloaded ISO image instead of the CDROM drive.
paul@169 117 </p>
paul@169 118 <pre> # tazusb gen-iso2usb /path/to/iso
paul@169 119 </pre>
paul@169 120 Example:
paul@169 121 <pre> # tazusb gen-iso2usb /home/tux/slitaz.iso
paul@169 122 </pre>
paul@169 123
pascal@542 124 <a name="clean"></a>
paul@169 125 <h3><font color="#6c0023">clean</font></h3>
paul@169 126 <p>
paul@169 127 "clean" removes old rootfs.gz.unixtimestamp filesystems (see writefs)
paul@169 128 to keep disk usage down.
paul@169 129 </p>
paul@169 130 <pre> # tazusb clean
paul@169 131 </pre>
paul@169 132
paul@171 133 <h2>MAINTAINER</h2>
paul@171 134 <p>
paul@171 135 Eric Joseph-Alexandre &lt;erjo at slitaz.org&gt;
paul@171 136 </p>
paul@171 137
pankso@7 138 <!-- End content -->
pankso@7 139 </div>
pankso@7 140 </body>
pankso@7 141 </html>