tazusb annotate doc/tazusb.en.html @ rev 76

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