README_ASCII.txt (6493B)
1 === Devuan ASCII minimal live ==== 2 3 This image is a full-featured console-only live Devuan ASCII system, 4 with tons of command-line and curses utilities and a special focus on 5 accessibility. The system is a good starting point for a minimalist 6 environment, a powerful solution for rescue tasks, and a useful tool to 7 have in your pocket every day. 8 9 The image can be burnt on a CDROM or dd-ed on a USB stick. 10 11 The regular user is devuan/devuan. Become admin with root/toor. 12 13 Designed and maintained by Vincenzo 'Katolaz' Nicosia 14 Key used to sign: http://pgp.mit.edu/pks/lookup?op=get&search=0x5F20B3AE0B5F062F 15 Homepage: http://kalos.mine.nu 16 17 ======================================= 18 19 0) Boot options 20 1) Packages 21 2) Connecting to the Internet 22 3) About non-free firmware packages 23 4) Installing on a hard drive 24 5) Acknowledgements 25 26 ======================================= 27 28 0) == Boot options == 29 30 There are several boot options available: 31 32 - std: default, with selection of framebuffer resolution 33 - access: accessible boot, with audible boot feedback and autologin 34 - std-toram: as "std", but load squashfs into RAM 35 - access-toram: as "access", but load squashfs into RAM 36 - no probe: disable apic/apm/dma/mce/smp 37 - memtest: perform a memory test (does not boot Linux) 38 39 The two accessible boot options ("access" and "access-toram", 40 respectively the second and the fourth on the boot menu) emit a "beep" 41 (CTRL+G) when they are selected, to be easily recognisable, and enter 42 into a dedicated runlevel (runlevel 4) which autologins root on tty1 43 and the user devuan on tty2-tty6. There is audible feedback on boot, 44 and a simple chime (C-E-G-E-C) signals the end of the boot. 45 46 ======================================= 47 48 1) == Packages === 49 50 This image contains around 590 packages in total, and includes: 51 52 - _Base system_: bash, busybox, consoledata, GNU coreutils, dash, 53 dialog, locales, syslinux, sysvinit, util-linux-locales, zsh 54 55 - _Admin/Recovery_: debootstrap, entr, gddrescue, gdisk, htop, 56 iftop, iotop, mtr-tiny, multitail, ncdu, parted, wavemon, 57 wireless-tools, wpa_supplicant 58 59 - _Editors_: vim-tiny, zile (Emacs clone), nano 60 61 - _Networking_: bittornado, curl, edbrowse, fetchmail, ftp, irssi, 62 lftp, links2, mcabber, minicom, mosh, msmtp, mutt, netcat, nrss, 63 openssh-client, openssh-server, procmail, rsync, setnet, telnet, 64 tin, twidge, w3m, wget 65 66 - _Personal_productivity_: abook, aspell, calcurse, clex, dvtm, 67 fbi/fbgs, fbterm, ghostscript, gpg, mc, parallel, sc, screen, 68 taskwarrior, tmux 69 70 - _Programming_ languages_: ANSI C (tcc + libc6-dev), Perl 71 (minimal), python (minimal), awk (gawk), guile 72 73 - _Games_: bastet, bombardier, bsdgames, cavezofphear, crawl, 74 curseofwar, empire, freesweep, gnuchess, greed, matanza, moria, 75 nethack, ninvaders, omega-rpg, pacman4console, pente, sudoku 76 77 - _Accessibility_: beep, brltty, espeak, espeakup, yasr 78 79 - _Multimedia_: caca-utils, hasciicam, imagemagick, jhead, moc, 80 radio, sox 81 82 - _Miscellanea_: cmatrix, cowsay, figlet, fortune-mod, gpm, 83 termsaver, toilet, ttyrec 84 85 ======================================= 86 87 2) == Connecting to the Internet == 88 89 This image ships with "setnet.sh", a simple dialog tool to setup 90 networking. setnet allows to configure both wired and wireless 91 connections, with static or DHCP-based IP assignment, and can help you 92 setting up wi-fi authentication to open, WPA Personal (WPA/PSK and 93 WPA2/PSK), and WPA Enterprise (WPA/EAP or WPA/TLS) networks. 94 95 Just run: 96 97 # setnet.sh 98 99 from a root console, and then select "Setup interfaces" for a list of 100 recognised devices. For more information please just: 101 102 $ man setnet 103 104 ======================================= 105 106 3) == About non-free firmware packages == 107 108 Devuan minimal live comes with all the available firmware packages 109 pre-installed. This means that also *non-free* software is present in 110 this image. Actually, those non-free firmware packages are *the only* 111 non-free software packages installed in this image. 112 113 We highly value the freedom of Devuan users, and we would rather 114 prefer none of them to be ever forced to use non-free software, at 115 all. However, the choice of including non-free firmware was dictated 116 by the necessity to facilitate new users in getting their hardware, 117 and especially wifi cards, working out of the box. 118 119 We provide a simple script, that you can find in 120 "/root/remove_firmware.sh", which allows to remove all non-free 121 firmware from your installation. Just run the script, and all non-free 122 firmware will be removed. 123 124 ======================================= 125 126 4) == Installing on a hard drive == 127 128 The recommended way of installing Devuan is by using one of the 129 installation media or the desktop-live image available at 130 http://files.devuan.org under the folders "installer-iso" and 131 "desktop-live", respectively. 132 133 However, it is also possible to install this minimal live image on a 134 hard disk by using the refractainstaller script shipped with it. I 135 tested the installation on qemu and on bare-metal, and it worked quite 136 well, but I cannot guarantee that it will work for you as well, so 137 please use refractainstaller AT YOUR OWN RISK but feel free to drop me 138 a line if it works. 139 140 Again, INSTALLING AN OPERATING SYSTEM ON AN EXISTING HARD DRIVE MIGHT 141 POTENTIALLY DESTROY EXISTING DATA, ESPECIALLY IF YOU DON'T KNOW 142 EXACTLY WHAT YOU ARE DOING. SO PLEASE BE CAREFUL, BACKUP YOUR DATA, 143 AND DO NOT COMPLAIN IF ANYTHING GOES WRONG. IT WILL BE JUST *YOUR* 144 FAULT. 145 146 ======================================= 147 148 5) == Acknowledgements == 149 150 I thank the refracta team for providing refractasnapshot and 151 refractainstaller. 152 153 A very special thank goes to Gregory Nowak, Parham Doustdar, Jude 154 DaShiell, John G Heim, Rob, and all the people in the Linux-speakup 155 mailing list (http://www.linux-speakup.org/) for their encouragement 156 and support, and for providing invaluable feedback about 157 accessibility. Without their help, I couldn't have seen what was 158 needed in order to make the minimal live images easier to use for 159 visually-impaired users. 160 161 I feel indebted with all the people in the DNG Mailing List who have 162 provided feedback, suggestions, comments, and encouragement, and in 163 particular: aitor_czr, Boruch Baum, fsmithred, golinux, David Hare, 164 Irrwahn, Steve Litt, Daniel Reurich, Joel Roth, Ozi Traveller. 165 166 Comments, suggestions, criticisms, and bug reports are welcome, and 167 should be reported on the official Devuan Bug Tracking System: 168 169 http://bugs.devuan.org 170 171 ======================================= 172