Documentation Globale De Liveusb Version 1.1-Sio-Gnome-Stretch-Stretch

Documentation globale de liveUSB Version 1.1-sio-gnome-stretch-stretch

Gregory DAVID

13/09/2018

Table des matières

1 Présentation du système liveUSB 3 1.1 Logiciels installés...... 3 1.2 Comparaison avec ClefAgreg/Clef ISN...... 13

2 Téléchargement et utilisation du système liveUSB 15 2.1 Pour utiliser un système déjà conﬁguré et testé (méthode la plus simple)...... 15 2.2 Pour conﬁgurer le système pour d’autres besoins (méthode plus complète)...... 15

3 Captures d’écran 17 3.1 Généralités...... 17 3.2 Exemples d’applications préinstallées (ici en version 1.1)...... 18

4 Documentation utilisateur 21 4.1 Comment permettre le démarrage du système sur la clé...... 21 4.2 Conﬁguration par défaut...... 21 4.3 Comment installer un paquet manquant...... 22 4.4 Erreurs ou avertissements possibles...... 22

5 Documentation distributeur 23 5.1 Téléchargement de l’image système...... 23 5.2 Transfert de l’image système et conﬁguration de la persistance...... 23 5.3 Et si on dispose déjà d’une clef liveUSB?...... 28

6 Documentation constructeur 29 6.1 Prologue...... 29 6.2 Mécanisme général d’une construction ...... 29 6.3 Mise en œuvre de la construction...... 30

7 Documentation contributeur 33 7.1 Vous rencontrez des dysfonctionnements...... 33 7.2 Vous ne trouvez pas la documentation adaptée à votre besoin...... 35 7.3 Vous voulez apporter votre aide, votre savoir-faire ou votre expertise...... 35

8 Installation de live-build pour les utilisateurs sans Debian GNU/Linux 39 8.1 Récupération du code source...... 39 8.2 Installation de live-build ...... 39

9 Structure de travail et répartition des rôles 41

A Nomenclature 43

B Pré-requis 45

i C Contributions 47

ii Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

Author Gregory DAVID Release 1.1 Date 13/09/2018 Copyright GNU Free Documentation License 1.3 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts

Table des matières 1 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

2 Table des matières CHAPITRE 1

Présentation du système liveUSB

Clef USB démarrable, support de l”enseignement de la spécialité ISN en Terminale S (notamment, mais peut être construite pour d’autres usages : Physique/Chimie, Mathématiques, STI2D, etc.). Contient une version adaptée de Debian GNU/Linux. C’est une clef persistante (les modiﬁcations sont conservées entre les redémarrages).

1.1 Logiciels installés

Voir la liste des paquets installés 1.

1.1.1 Représentation de l’information

Représentation binaire

— bless 2 — hexedit 3 — shed 4 — wxhexeditor 5

Opérations booléennes

— logisim 6

1. https://git.framasoft.org/groolot/liveUSB/blob/testing/SYSTEME.rst#liste-des-paquets-install%C3%A9s 2. https://packages.debian.org/stretch/bless 3. https://packages.debian.org/stretch/hexedit 4. https://packages.debian.org/stretch/shed 5. https://packages.debian.org/stretch/wxhexeditor 6. https://packages.debian.org/stretch/logisim

3 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

Numérisation

— gimp 7 — gimp-data-extras 8 — gimp-plugin-registry 9 — gimp-texturize 10 — inkscape 11 — xsane 12

Formats de données

— bless 13 — fontforge 14 — gdb 15 — hexedit 16 — python3 17 — shed 18 — wxhexeditor 19

Compression

— ﬁle-roller 20 — unar 21 — unrar-free 22 — unzip 23 — zip 24

Structuration et organisation de l’information

— gparted 25 — lxterminal 26 — nautilus 27 — nautilus-scripts-manager 28 — nautilus-share 29 — nautilus-wipe 30 — xterm 31 7. https://packages.debian.org/stretch/gimp 8. https://packages.debian.org/stretch/gimp-data-extras 9. https://packages.debian.org/stretch/gimp-plugin-registry 10. https://packages.debian.org/stretch/gimp-texturize 11. https://packages.debian.org/stretch/inkscape 12. https://packages.debian.org/stretch/xsane 13. https://packages.debian.org/stretch/bless 14. https://packages.debian.org/stretch/fontforge 15. https://packages.debian.org/stretch/gdb 16. https://packages.debian.org/stretch/hexedit 17. https://packages.debian.org/stretch/python3 18. https://packages.debian.org/stretch/shed 19. https://packages.debian.org/stretch/wxhexeditor 20. https://packages.debian.org/stretch/ﬁle-roller 21. https://packages.debian.org/stretch/unar 22. https://packages.debian.org/stretch/unrar-free 23. https://packages.debian.org/stretch/unzip 24. https://packages.debian.org/stretch/zip 25. https://packages.debian.org/stretch/gparted 26. https://packages.debian.org/stretch/lxterminal 27. https://packages.debian.org/stretch/nautilus 28. https://packages.debian.org/stretch/nautilus-scripts-manager 29. https://packages.debian.org/stretch/nautilus-share 30. https://packages.debian.org/stretch/nautilus-wipe 31. https://packages.debian.org/stretch/xterm

4 Chapitre 1. Présentation du système liveUSB Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

1.1.2 Algorithmique

— algobox 32 — dia 33 — logisim 34 — plantuml 35 — umbrello 36

1.1.3 Langages et programmation

— arduino 37 — autoconf 38 — automake 39 — build-essential 40 — cmake 41 — codelite 42 — codelite-plugins 43 — eclipse 44 — eclipse-cdt 45 — emacs 46 — gcc-doc 47 — geany 48 — geany-plugin-py 49 — gedit 50 — git 51 — graphviz 52 — ipython3 53 — ipython3-qtconsole 54 — libtool 55 — make 56 — manpages-dev 57 — pd-boids 58 — pd-chaos 59

32. https://packages.debian.org/stretch/algobox 33. https://packages.debian.org/stretch/dia 34. https://packages.debian.org/stretch/logisim 35. https://packages.debian.org/stretch/plantuml 36. https://packages.debian.org/stretch/umbrello 37. https://packages.debian.org/stretch/arduino 38. https://packages.debian.org/stretch/autoconf 39. https://packages.debian.org/stretch/automake 40. https://packages.debian.org/stretch/build-essential 41. https://packages.debian.org/stretch/cmake 42. https://packages.debian.org/stretch/codelite 43. https://packages.debian.org/stretch/codelite-plugins 44. https://packages.debian.org/stretch/eclipse 45. https://packages.debian.org/stretch/eclipse-cdt 46. https://packages.debian.org/stretch/emacs 47. https://packages.debian.org/stretch/gcc-doc 48. https://packages.debian.org/stretch/geany 49. https://packages.debian.org/stretch/geany-plugin-py 50. https://packages.debian.org/stretch/gedit 51. https://packages.debian.org/stretch/git 52. https://packages.debian.org/stretch/graphviz 53. https://packages.debian.org/stretch/ipython3 54. https://packages.debian.org/stretch/ipython3-qtconsole 55. https://packages.debian.org/stretch/libtool 56. https://packages.debian.org/stretch/make 57. https://packages.debian.org/stretch/manpages-dev 58. https://packages.debian.org/stretch/pd-boids 59. https://packages.debian.org/stretch/pd-chaos

1.1. Logiciels installés 5 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

— pd-fftease 60 — pd-freeverb 61 — pd-ggee 62 — pd-hcs 63 — pd-hid 64 — pd-iemlib 65 — pd-iemnet 66 — pd-libdir 67 — pd-osc 68 — pd-zexy 69 — php-cli 70 — php-readline 71 — plantuml 72 — puredata 73 — puredata-extra 74 — puredata-import 75 — puredata-utils 76 — pylint 77 — pylint-doc 78 — python-astroid 79 — python-logilab-common 80 — python-pyo 81 — python3-doc 82 — python3-kivy 83 — python3-liblo 84 — python3-lxml 85 — python3-matplotlib 86 — python3-numpy 87 — python3-pil 88 — python3-pil.imagetk 89 — python3-pip 90 — python3-psycopg2 91

60. https://packages.debian.org/stretch/pd-fftease 61. https://packages.debian.org/stretch/pd-freeverb 62. https://packages.debian.org/stretch/pd-ggee 63. https://packages.debian.org/stretch/pd-hcs 64. https://packages.debian.org/stretch/pd-hid 65. https://packages.debian.org/stretch/pd-iemlib 66. https://packages.debian.org/stretch/pd-iemnet 67. https://packages.debian.org/stretch/pd-libdir 68. https://packages.debian.org/stretch/pd-osc 69. https://packages.debian.org/stretch/pd-zexy 70. https://packages.debian.org/stretch/php-cli 71. https://packages.debian.org/stretch/php-readline 72. https://packages.debian.org/stretch/plantuml 73. https://packages.debian.org/stretch/puredata 74. https://packages.debian.org/stretch/puredata-extra 75. https://packages.debian.org/stretch/puredata-import 76. https://packages.debian.org/stretch/puredata-utils 77. https://packages.debian.org/stretch/pylint 78. https://packages.debian.org/stretch/pylint-doc 79. https://packages.debian.org/stretch/python-astroid 80. https://packages.debian.org/stretch/python-logilab-common 81. https://packages.debian.org/stretch/python-pyo 82. https://packages.debian.org/stretch/python3-doc 83. https://packages.debian.org/stretch/python3-kivy 84. https://packages.debian.org/stretch/python3-liblo 85. https://packages.debian.org/stretch/python3-lxml 86. https://packages.debian.org/stretch/python3-matplotlib 87. https://packages.debian.org/stretch/python3-numpy 88. https://packages.debian.org/stretch/python3-pil 89. https://packages.debian.org/stretch/python3-pil.imagetk 90. https://packages.debian.org/stretch/python3-pip 91. https://packages.debian.org/stretch/python3-psycopg2

6 Chapitre 1. Présentation du système liveUSB Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

— python3-scipy 92 — python3-tk 93 — qmlscene 94 — qt5-doc 95 — qtbase5-dev-tools 96 — qtcreator 97 — qtcreator-doc 98 — qttools5-dev-tools 99 — qttranslations5-l10n 100 — scratch 101 — spyder3 102 — zenity 103

Correction d’un programme

— alleyoop 104 — cppcheck 105 — doxygen 106 — doxygen-gui 107 — gdb 108 — phpunit 109 — pylint 110 — valgrind 111 — valkyrie 112

Langages de description

— auctex 113 — blueﬁsh 114 — gedit 115 — plantuml 116 — texlive 117 — texlive-bibtex-extra 118 — texlive-lang-french 119

92. https://packages.debian.org/stretch/python3-scipy 93. https://packages.debian.org/stretch/python3-tk 94. https://packages.debian.org/stretch/qmlscene 95. https://packages.debian.org/stretch/qt5-doc 96. https://packages.debian.org/stretch/qtbase5-dev-tools 97. https://packages.debian.org/stretch/qtcreator 98. https://packages.debian.org/stretch/qtcreator-doc 99. https://packages.debian.org/stretch/qttools5-dev-tools 100. https://packages.debian.org/stretch/qttranslations5-l10n 101. https://packages.debian.org/stretch/scratch 102. https://packages.debian.org/stretch/spyder3 103. https://packages.debian.org/stretch/zenity 104. https://packages.debian.org/stretch/alleyoop 105. https://packages.debian.org/stretch/cppcheck 106. https://packages.debian.org/stretch/doxygen 107. https://packages.debian.org/stretch/doxygen-gui 108. https://packages.debian.org/stretch/gdb 109. https://packages.debian.org/stretch/phpunit 110. https://packages.debian.org/stretch/pylint 111. https://packages.debian.org/stretch/valgrind 112. https://packages.debian.org/stretch/valkyrie 113. https://packages.debian.org/stretch/auctex 114. https://packages.debian.org/stretch/blueﬁsh 115. https://packages.debian.org/stretch/gedit 116. https://packages.debian.org/stretch/plantuml 117. https://packages.debian.org/stretch/texlive 118. https://packages.debian.org/stretch/texlive-bibtex-extra 119. https://packages.debian.org/stretch/texlive-lang-french

1.1. Logiciels installés 7 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

— texlive-latex-extra 120 — texlive-latex-recommended 121 — texmaker 122

1.1.4 Gestion des bases de données

— pgadmin3 123 — php-pgsql 124 — php-readline 125 — php-sqlite3 126 — postgresql-client 127 — sqlite3 128

1.1.5 Architectures matérielles

— binutils 129 — build-essential 130 — gdb 131 — pciutils 132

1.1.6 Réseaux

— arping 133 — ﬁlezilla 134 — netcat 135 — openssh-client 136 — openssh-server 137 — openssh-sftp-server 138 — openssl 139 — pd-iemnet 140 — pd-osc 141 — python-scapy 142 — python3-liblo 143 — seahorse 144 120. https://packages.debian.org/stretch/texlive-latex-extra 121. https://packages.debian.org/stretch/texlive-latex-recommended 122. https://packages.debian.org/stretch/texmaker 123. https://packages.debian.org/stretch/pgadmin3 124. https://packages.debian.org/stretch/php-pgsql 125. https://packages.debian.org/stretch/php-readline 126. https://packages.debian.org/stretch/php-sqlite3 127. https://packages.debian.org/stretch/postgresql-client 128. https://packages.debian.org/stretch/sqlite3 129. https://packages.debian.org/stretch/binutils 130. https://packages.debian.org/stretch/build-essential 131. https://packages.debian.org/stretch/gdb 132. https://packages.debian.org/stretch/pciutils 133. https://packages.debian.org/stretch/arping 134. https://packages.debian.org/stretch/ﬁlezilla 135. https://packages.debian.org/stretch/netcat 136. https://packages.debian.org/stretch/openssh-client 137. https://packages.debian.org/stretch/openssh-server 138. https://packages.debian.org/stretch/openssh-sftp-server 139. https://packages.debian.org/stretch/openssl 140. https://packages.debian.org/stretch/pd-iemnet 141. https://packages.debian.org/stretch/pd-osc 142. https://packages.debian.org/stretch/python-scapy 143. https://packages.debian.org/stretch/python3-liblo 144. https://packages.debian.org/stretch/seahorse

8 Chapitre 1. Présentation du système liveUSB Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

— vde2 145 — wireshark 146

1.1.7 Mathématiques

— geogebra 147 — maxima 148 — wxmaxima 149 — xmaxima 150

1.1.8 Global

Jeux

— 2048-qt 151 — gnome-hearts 152 — gnome-klotski 153 — gnome-mahjongg 154 — gnome-mastermind 155 — gnome-mines 156 — gnome-nibbles 157 — gnome-sudoku 158 — gnome-tetravex 159

Visualiseurs

— evince 160 — gedit 161 — impressive 162 — mplayer 163 — pdf-presenter-console 164 — vlc 165 — xpdf 166 — zathura 167 145. https://packages.debian.org/stretch/vde2 146. https://packages.debian.org/stretch/wireshark 147. https://packages.debian.org/stretch/geogebra 148. https://packages.debian.org/stretch/maxima 149. https://packages.debian.org/stretch/wxmaxima 150. https://packages.debian.org/stretch/xmaxima 151. https://packages.debian.org/stretch/2048-qt 152. https://packages.debian.org/stretch/gnome-hearts 153. https://packages.debian.org/stretch/gnome-klotski 154. https://packages.debian.org/stretch/gnome-mahjongg 155. https://packages.debian.org/stretch/gnome-mastermind 156. https://packages.debian.org/stretch/gnome-mines 157. https://packages.debian.org/stretch/gnome-nibbles 158. https://packages.debian.org/stretch/gnome-sudoku 159. https://packages.debian.org/stretch/gnome-tetravex 160. https://packages.debian.org/stretch/evince 161. https://packages.debian.org/stretch/gedit 162. https://packages.debian.org/stretch/impressive 163. https://packages.debian.org/stretch/mplayer 164. https://packages.debian.org/stretch/pdf-presenter-console 165. https://packages.debian.org/stretch/vlc 166. https://packages.debian.org/stretch/xpdf 167. https://packages.debian.org/stretch/zathura

1.1. Logiciels installés 9 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

Son

— audacity 168 — cmus 169 — cmus-plugin-ffmpeg 170 — ffmpeg 171 — ffmpeg-doc 172 — sox 173

Image

— blender 174 — dia 175 — fyre 176 — gimp 177 — imagemagick 178

Vidéo

— ffmpeg 179 — ffmpeg-doc 180 — mplayer 181 — vlc 182

Systèmes de gestion de version (SCM)

— git 183 — git-doc 184 — git-gui 185 — gitk 186 — meld 187

Virtualisation

— qemu-kvm 188 — qemu-utils 189

168. https://packages.debian.org/stretch/audacity 169. https://packages.debian.org/stretch/cmus 170. https://packages.debian.org/stretch/cmus-plugin-ffmpeg 171. https://packages.debian.org/stretch/ffmpeg 172. https://packages.debian.org/stretch/ffmpeg-doc 173. https://packages.debian.org/stretch/sox 174. https://packages.debian.org/stretch/blender 175. https://packages.debian.org/stretch/dia 176. https://packages.debian.org/stretch/fyre 177. https://packages.debian.org/stretch/gimp 178. https://packages.debian.org/stretch/imagemagick 179. https://packages.debian.org/stretch/ffmpeg 180. https://packages.debian.org/stretch/ffmpeg-doc 181. https://packages.debian.org/stretch/mplayer 182. https://packages.debian.org/stretch/vlc 183. https://packages.debian.org/stretch/git 184. https://packages.debian.org/stretch/git-doc 185. https://packages.debian.org/stretch/git-gui 186. https://packages.debian.org/stretch/gitk 187. https://packages.debian.org/stretch/meld 188. https://packages.debian.org/stretch/qemu-kvm 189. https://packages.debian.org/stretch/qemu-utils

10 Chapitre 1. Présentation du système liveUSB Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

— virt-manager 190 — virt-viewer 191

Navigateurs web

— chromium 192 — ﬁrefox-esr 193 — ﬁrefox-esr-l10n-fr 194 — surf 195 — xul-ext-adblock-plus 196

Bureautique

— freeplane 197 — gedit 198 — libreofﬁce 199 — libreofﬁce-l10n-fr 200 — hunspell 201 — hunspell-fr-modern 202

Communication

— ekiga 203 — hexchat 204 — icedove 205 — icedove-l10n-fr 206 — mime-support 207 — mumble 208 — mutt 209 — pidgin 210

1.1.9 Système et outils de base

— avahi-daemon 211 — binutils 212 190. https://packages.debian.org/stretch/virt-manager 191. https://packages.debian.org/stretch/virt-viewer 192. https://packages.debian.org/stretch/chromium 193. https://packages.debian.org/stretch/firefox-esr 194. https://packages.debian.org/stretch/firefox-esr-l10n-fr 195. https://packages.debian.org/stretch/surf 196. https://packages.debian.org/stretch/xul-ext-adblock-plus 197. https://packages.debian.org/stretch/freeplane 198. https://packages.debian.org/stretch/gedit 199. https://packages.debian.org/stretch/libreoffice 200. https://packages.debian.org/stretch/libreoffice-l10n-fr 201. https://packages.debian.org/stretch/hunspell 202. https://packages.debian.org/stretch/hunspell-fr-modern 203. https://packages.debian.org/stretch/ekiga 204. https://packages.debian.org/stretch/hexchat 205. https://packages.debian.org/stretch/icedove 206. https://packages.debian.org/stretch/icedove-l10n-fr 207. https://packages.debian.org/stretch/mime-support 208. https://packages.debian.org/stretch/mumble 209. https://packages.debian.org/stretch/mutt 210. https://packages.debian.org/stretch/pidgin 211. https://packages.debian.org/stretch/avahi-daemon 212. https://packages.debian.org/stretch/binutils

1.1. Logiciels installés 11 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

— broadcom-sta-dkms 213 — build-essential 214 — console-data 215 — console-setup 216 — cryptsetup 217 — cups 218 — cups-filters 219 — cups-pk-helper 220 — debian-installer-launcher 221 — ekiga 222 — evince 223 — file 224 — file-roller 225 — filezilla 226 — firmware-atheros 227 — firmware-brcm80211 228 — firmware-iwlwifi 229 — firmware-zd1211 230 — foomatic-db-compressed-ppds 231 — gtk2-engines-pixbuf 232 — gvfs 233 — gvfs-bin 234 — keyboard-configuration 235 — less 236 — libcanberra-gtk-module 237 — live-tools 238 — locales 239 — network-manager-gnome 240 — printer-driver-cups-pdf 241 — printer-driver-gutenprint 242 — screen 243 — sudo 244 213. https://packages.debian.org/stretch/broadcom-sta-dkms 214. https://packages.debian.org/stretch/build-essential 215. https://packages.debian.org/stretch/console-data 216. https://packages.debian.org/stretch/console-setup 217. https://packages.debian.org/stretch/cryptsetup 218. https://packages.debian.org/stretch/cups 219. https://packages.debian.org/stretch/cups-filters 220. https://packages.debian.org/stretch/cups-pk-helper 221. https://packages.debian.org/stretch/debian-installer-launcher 222. https://packages.debian.org/stretch/ekiga 223. https://packages.debian.org/stretch/evince 224. https://packages.debian.org/stretch/file 225. https://packages.debian.org/stretch/file-roller 226. https://packages.debian.org/stretch/filezilla 227. https://packages.debian.org/stretch/firmware-atheros 228. https://packages.debian.org/stretch/firmware-brcm80211 229. https://packages.debian.org/stretch/firmware-iwlwifi 230. https://packages.debian.org/stretch/firmware-zd1211 231. https://packages.debian.org/stretch/foomatic-db-compressed-ppds 232. https://packages.debian.org/stretch/gtk2-engines-pixbuf 233. https://packages.debian.org/stretch/gvfs 234. https://packages.debian.org/stretch/gvfs-bin 235. https://packages.debian.org/stretch/keyboard-configuration 236. https://packages.debian.org/stretch/less 237. https://packages.debian.org/stretch/libcanberra-gtk-module 238. https://packages.debian.org/stretch/live-tools 239. https://packages.debian.org/stretch/locales 240. https://packages.debian.org/stretch/network-manager-gnome 241. https://packages.debian.org/stretch/printer-driver-cups-pdf 242. https://packages.debian.org/stretch/printer-driver-gutenprint 243. https://packages.debian.org/stretch/screen 244. https://packages.debian.org/stretch/sudo

12 Chapitre 1. Présentation du système liveUSB Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

— synaptic 245 — task-french 246 — task-french-desktop 247 — task-gnome-desktop 248 — unar 249 — unrar-free 250 — unzip 251 — user-setup 252 — vlc 253 — wfrench 254 — xpdf 255 — zip 256 — zsh 257

1.2 Comparaison avec ClefAgreg/Clef ISN

Il existe déjà une ClefAgreg/Clef ISN 258 pour l’agrégation de mathématiques, pour l’informatique en prépa, pour l’ISN. Cette clef est référencée 259 sur le site du SILO. Nous l’avons testée (voir l”issue #31 260) et elle fonctionne bien, sauf sur l’un de nos ordinateurs, qui est plutôt récent. Mais surtout, elle nous semble plus compliquée à conﬁgurer et à mettre à jour.

245. https://packages.debian.org/stretch/synaptic 246. https://packages.debian.org/stretch/task-french 247. https://packages.debian.org/stretch/task-french-desktop 248. https://packages.debian.org/stretch/task-gnome-desktop 249. https://packages.debian.org/stretch/unar 250. https://packages.debian.org/stretch/unrar-free 251. https://packages.debian.org/stretch/unzip 252. https://packages.debian.org/stretch/user-setup 253. https://packages.debian.org/stretch/vlc 254. https://packages.debian.org/stretch/wfrench 255. https://packages.debian.org/stretch/xpdf 256. https://packages.debian.org/stretch/zip 257. https://packages.debian.org/stretch/zsh 258. http://clefagreg.dnsalias.org/8.0/ 259. https://wiki.inria.fr/sciencinfolycee/ClefISN 260. https://git.framasoft.org/groolot/liveUSB/issues/31

1.2. Comparaison avec ClefAgreg/Clef ISN 13 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

14 Chapitre 1. Présentation du système liveUSB CHAPITRE 2

Téléchargement et utilisation du système liveUSB

2.1 Pour utiliser un système déjà conﬁguré et testé (méthode la plus simple)

2.1.1 Téléchargement

La dernière image système validée et construite de liveUSB v1.1 est disponible au format .img 261. Vous pouvez consulter les autres constructions en visitant liveUSB 262.

2.1.2 Documentations

— Documentation distributeur (page 23) : des instructions pour « recopier » le système sur une clef USB. — Documentation utilisateur (page 21) : comment démarrer sur la clef liveUSB, et ensuite comment utiliser le système liveUSB, etc.

2.2 Pour conﬁgurer le système pour d’autres besoins (méthode plus complète)

Pour conﬁgurer la construction d’une autre image système, voir la Documentation constructeur (page 29).

261. http://liveusb.groolot.net/testing/liveUSB-v1.1-amd64.img 262. http://liveusb.groolot.net

15 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

16 Chapitre 2. Téléchargement et utilisation du système liveUSB CHAPITRE 3

Captures d’écran

3.1 Généralités

Voir Menu de démarrage de la clef (basé sur SYSLINUX) (page 17) et Bureau et gestionnaire de fenêtres (Gnome3) (page 18).

Fig. 1 – Menu de démarrage de la clef (basé sur SYSLINUX)

17 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

Fig. 2 – Bureau et gestionnaire de fenêtres (Gnome3)

3.2 Exemples d’applications préinstallées (ici en version 1.1)

18 Chapitre 3. Captures d’écran Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

3.2. Exemples d’applications préinstallées (ici en version 1.1) 19 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

20 Chapitre 3. Captures d’écran CHAPITRE 4

Documentation utilisateur

4.1 Comment permettre le démarrage du système sur la clé

4.1.1 Utiliser le menu de démarrage

Au démarrage, il faut appuyer sur la touche qui indique à l’ordinateur de démarrer sur la clé, et non pas sur le disque dur. Pour trouver cette touche, cela dépend de votre matériel et vous devrez probablement être attentif aux informations afﬁchées lors de l’allumage de l’ordinateur.

Note : Exemples : F8 (PC de bureau) ou F12 (PC portable).

Les périphériques suivants s’afﬁchent : — USB Mass Storage Device — UEFI: SanDisk <= celui-ci — SanDisk <= ou celui-là

4.1.2 Entrer dans le BIOS

Si l’étape précédente n’a pas fonctionné, c’est qu’elle n’a pas été activée, ou qu’elle n’est pas disponible. Il faut alors aller dans le BIOS, et activer le menu de démarrage (boot menu), ou bien (directement à partir du BIOS) démarrer sur la clé. Exemples de touches à utiliser au démarrage : DEL ou F2.

4.2 Conﬁguration par défaut

Le nom du compte d’utilisateur (login) est utilisateur, c’est celui qui apparaîtra dans le terminal. Le nom visible est Utilisateur liveUSB, c’est ce qui apparaît dans Gnome3 ou d’autres applications.

Note : Le mot de passe du compte utilisateur est live.

21 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

4.3 Comment installer un paquet manquant

Par exemple, python-pygame n’est pas installé par défaut. Pour l’installer s’il y a besoin, voir l”issue #18 263.

4.4 Erreurs ou avertissements possibles

4.4.1 Apple Macintosh

Depuis la version v0.1.4, les images construites sont compatibles avec les Apple Macintosh qui démarrent en UEFI.

4.4.2 Windows is hibernated

Ce message peut apparaître au démarrage de la clé : ntfs: (device sda2) : load_system_files(): Windows is hibernated. Mounting read-

˓→only. Run chkdsk

Cela provient du fait que Windows n’est pas vraiment éteint par défaut (Windows 8, Windows 10 par exemple). Il est en hibernation, aﬁn de redémarrer plus vite. Il n’y a pas de problème lié à la clé live. S’il y a besoin de monter la partition Windows, alors il faut éteindre complètement Windows avant de lancer la clé live. Voir le forum de discussion 264.

4.4.3 Undeﬁned video mode number : 317

Undefined video mode number: 317 Press to see video modes available, to continue, or wait 30 sec

L’écran du Asus Eee PC 1015PEM a une résolution de 1024x600 pixels, ce mode semble provoquer ce message (j’ai essayé en choisissant ENTER mais la résolution 1024x600 n’est pas proposée). Donc ici on appuie directement sur SPACE et tout se déroule correctement ensuite.

4.4.4 Le système semble gelé en sortie de veille

Il est arrivé, sur un système de test, que la sortie de veille du système live gèle la machine. Ceci a été discuté dans l”issue #16 265 et ne semble pas avoir été rencontré à nouveau. Si toutefois vous rencontrez ce dysfonctionnement et qu’il est reproductible (c’est à dire si vous pouvez le refaire plusieurs fois selon la même méthode), venez alimenter l”issue #16 266 avec les informations suivantes : — modèle de votre machine, — quantité de mémoire vive (RAM exprimée en Go), — modèle du CPU (ex : Dual Core [email protected]), — version de liveUSB touchée par le dysfonctionnement, — description de la démarche pour reproduire le dysfonctionnement.

263. https://git.framasoft.org/groolot/liveUSB/issues/18 264. http://askubuntu.com/questions/145902/unable-to-mount-windows-ntfs-ﬁlesystem-due-to-hibernation 265. https://git.framasoft.org/groolot/liveUSB/issues/16 266. https://git.framasoft.org/groolot/liveUSB/issues/16

22 Chapitre 4. Documentation utilisateur CHAPITRE 5

Documentation distributeur

5.1 Téléchargement de l’image système

La dernière image système validée et construite de liveUSB est disponible au format .img 267. Vous pouvez consulter les autres constructions en visitant liveUSB 268.

5.2 Transfert de l’image système et conﬁguration de la persistance

Choisir une méthode parmi les [Méthode A - rapide, simple et préférée] Sous GNU/Linux, méthode automatisée (page 24) (automatisée) ou [Méthode B - pour comprendre] Sous GNU/Linux, méthode étape par étape (page 25) (étape par étape).

Note : Ces méthodes utilisent exclusivement des outils libres GNU/Linux.

Avertissement : Pour les utilisateurs n’ayant pas un accès direct à GNU/Linux, une solution est possible la [Méthode C] Sous Windows (page 27).

Le mécanisme général est le suivant : — copie de l’image sur le périphérique USB (utilisation de dd) — création de la partition sur l’espace vide restant sur le périphérique USB (gparted, sfdisk, etc.) — formatage de la partition en ext4 (mkfs.ext4) — conﬁguration de la persistance dans le ﬁchier persistence.conf

5.2.1 Nomenclature

Voir Nomenclature (page 41) pour des explications sur la nomenclature concernant les lignes de commande.

267. http://liveusb.groolot.net/testing/liveUSB-v1.1-amd64.img 268. http://liveusb.groolot.net

23 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

5.2.2 [Méthode A - rapide, simple et préférée] Sous GNU/Linux, méthode auto- matisée

Cette méthode est conçue pour faciliter le travail. L’automate burn peut-être utilisé. Dans notre cas, la conﬁguration de base promet d’assurer la persistance à partir d’une partition utilisant l’espace restant libre sur le support cible.

Note : Vous pouvez analyser le fichier burn 269 de la ligne 883 à la fin afin de comprendre la façon dont cette étape est assurée.

Considérons que votre clef USB est associé au descripteur /dev/sde et que le ﬁchier image système est dans liveUSB-amd64.img :

# ./burn --image liveUSB-amd64.img --device /dev/sde ou

$ sudo ./burn --image liveUSB-amd64.img --device /dev/sde

Note : Aide en ligne de burn

$ sudo ./burn --help burn v0.1.3-jessie Brûler l'image de la clef liveUSB sur un périphérique choisi et configurer l

˓→'espace restant disponible pour accueillir la persistance du système.

Usage : burn [-h | --help] [[-d | --device] chemin] [[-i | --image] fichier.img] [-

˓→uefi] [-v | --verbose | --debug] [-V | --very-verbose] [-u | --usage]

Options :

SYSTÈME : -i, --image=fichier.img Image de la clef à brûler -d, --device=chemin Bloc device (périphérique mode bloc) destinataire -c, --copy Force l'étape de copie de l'image (défaut) -C, --no-copy Désactive l'étape de copie de l'image

-p, --persistence Force l'étape de persistance (défaut) -P, --no-persistence Désactive l'étape de persistance

CHIFFREMENT DE LA PERSISTANCE : -k, --crypt Force le chiffrement de la partition de persistance (défaut) -K, --no-crypt Désactive le chiffrement de la partition de persistance

EFI / APPLE MAC : -e, --efi, --uefi Force le démarrage en UEFI (défaut) -E, --no-efi, --no-uefi Désactive le démarrage en UEFI (ne démarrera pas sur un Apple

˓→Mac)

GÉNÉRALES : (suite sur la page suivante)

269. https://git.framasoft.org/groolot/liveUSB/blob/testing/burn#883

24 Chapitre 5. Documentation distributeur Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

(suite de la page précédente) -h, --help Affiche ce message d'aide et quitte --color Force l'usage des couleurs ANSI --no-color Désactive l'usage des couleurs ANSI (défaut) -v, --verbose, --debug Affiche des informations supplémentaires -V, --very-verbose Affiche le DEBUGAGE du script (set -x) --silent, --quiet Tente d'être le plus discret possible (seule les erreurs seront affichées en plus des intéractions

˓→utilisateur)

NOTE : Vous devez avoir les droits 'sudo' ou être le super utilisateur pour

˓→exécuter ce programme.

5.2.3 [Méthode B - pour comprendre] Sous GNU/Linux, méthode étape par étape

Il s’agit de la même démarche que la [Méthode A - rapide, simple et préférée] Sous GNU/Linux, méthode auto- matisée (page 24), mais il s’agit ici d’une version non automatisée. Cette [Méthode B - pour comprendre] Sous GNU/Linux, méthode étape par étape (page 25) a été testée dans l”issue #36 270 (on y trouvera quelques erreurs, et les explications concernant leurs résolutions).

Identiﬁcation du périphérique cible

Avant de brancher la clef USB, lancer la commande lsblk :

$ lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT sda 8:0 0 465,8G 0 disk +-sda1 8:1 0 465,8G 0 part / sdb 8:16 0 1,8T 0 disk +-sdb1 8:17 0 1,8T 0 part /home

Brancher maintenant la clef USB, puis relancer lsblk :

$ lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT sda 8:0 0 465,8G 0 disk +-sda1 8:1 0 465,8G 0 part / sdb 8:16 0 1,8T 0 disk +-sdb1 8:17 0 1,8T 0 part /home sdc 8:64 1 14,5G 0 disk

Nous pouvons alors identiﬁer que notre clef USB est accessible par le descripteur en mode bloc /dev/sdc. Nous pouvons vériﬁer que c’est un périphérique en mode bloc par le b en début de ligne de sortie de la commande suivante :

$ ls -l /dev/sdc brw-rw---- 1 root disk 8, 32 févr. 15 19:03 /dev/sdc

Recopie de l’image système sur le périphérique cible (= la clef USB)

Vous devez vous munir du nom du descripteur en mode bloc du périphérique USB cible. Dans cet exemple, nous considérerons le périphérique USB accessible sur /dev/sdc. 270. https://git.framasoft.org/groolot/liveUSB/issues/36

5.2. Transfert de l’image système et conﬁguration de la persistance 25 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

Vous devez par ailleurs vous munir du nom de l’image système précédemment créée. Si vous avez laissé la configuration initiale, le fichier image se nomme liveUSB-amd64.img. Placez-vous dans le dossier contenant ce fichier image, puis exécutez la commande ci-desssous. Il faut attendre quelques minutes avant que l’écran affiche que la commande s’est bien exécutée.

# dd if=liveUSB-amd64.img of=/dev/sdc bs=1M 1634+0 enregistrements lus 1634+0 enregistrements écrits 1713373184 bytes (1,7 GB, 1,6 GiB) copied, 167,139 s, 10,3 MB/s

Mise en œuvre de la persistance (voir le live-manual271)

Il s’agit ici de comprendre les concepts. Il n’y a pas de démarche technique à réaliser. Si vous le souhaitez, passez directement à l’étape Création et paramétrage de la partition d’accueil pour la persistance (page 26). Le paradigme d’un système Live CD est d’être pré-installé en s’amorçant (boot) sur un support en lecture seule, comme un cdrom, où les données et les modifications ne survivent pas aux redémarrages du matériel hôte qui l’exécute. Un système live est une généralisation de ce paradigme et gère ainsi d’autres supports en plus des CDs. Malgré tout, dans son comportement par défaut, il doit être considéré en lecture seule et toutes les évolutions pendant l’exécution du système sont perdues à l’arrêt. La persistance est un nom commun pour les différents types de solutions pour sauver, après un redémarrage, certaines ou toutes les données, de cette évolution pendant l’exécution du système. Pour comprendre comment cela fonctionne, il peut être utile de savoir que même si le système est démarré et exécuté à partir d’un support en lecture seule, les modifications des fichiers et répertoires sont écrites sur des supports inscriptibles, typiquement un disque RAM (tmpfs) et les données des disques RAM ne survivent pas à un redémarrage. Les données stockées sur ce disque virtuel doivent être enregistrées sur un support inscriptible persistant comme un support de stockage local, un partage réseau. Tous ces supports sont pris en charge dans les systèmes live de différentes manières, et tous nécessitent un paramètre d’amorçage spécial à préciser au moment du démarrage : persistence. Si le paramètre de démarrage persistence est réglé (et nopersistence n’est pas utilisé), les supports de stockage locaux (par exemple les disques durs, clés USB) seront examinés pour trouver des volumes persistants pendant le démarrage. Il est possible de limiter les types de volumes persistants à utiliser en indiquant certains paramètres de démarrage décrits dans la page de manuel live-boot(7). Un volume persistant est un des éléments suivants : — une partition, identifiée par son nom GPT ou msdos, — un système de fichiers, identifié par son étiquette (son nom) de système de fichiers, — un fichier image situé sur la racine d’un système de fichiers en lecture (même une partition NTFS d’un système d’exploitation étranger), identifié par son nom de fichier.

Création et paramétrage de la partition d’accueil pour la persistance

Vous devez vous munir du nom du descripteur en mode bloc du périphérique USB cible. Dans cet exemple, nous considérerons le périphérique USB accessible sur /dev/sdc, tel que celui utilisé pour réalisé le transfert de l’image système.

# echo ",+,L" | sfdisk --append /dev/sdc

Concrètement, on peut avoir besoin d’écrire sudo avant et après |, sinon cela ne fonctionne pas car il nous manque des droits. De plus, le paramètre --force peut être indispensable. Ainsi, l’instruction s’écrit ainsi $ sudo echo ",+,L" | sudo sfdisk --append --force /dev/sdc Il y a ensuite deux instructions à saisir : la première informe le système de la mise à jour de la table de partition de la clé, tandis que la seconde formate et nomme la partition de persistance. 271. http://debian-live.alioth.debian.org/live-manual/unstable/manual/html/live-manual.en.html#558

26 Chapitre 5. Documentation distributeur Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

# partprobe /dev/sdc # mkfs.ext4 -F -L persistence /dev/sdc

Ensuite, il faut aller dans la partition de persistance persistence, créer le ﬁchier persistence.conf, dont le contenu est :

/ union

Voir issue #89#note_14328 272 et issue #36#note_11929 273 pour des essais réussis concernant cette étape de créa- tion de la partition d’accueil pour la persistance.

5.2.4 [Méthode C] Sous Windows

Nature du problème

Les recherches réalisés dans l”issue #89 274 montrent que Windows ne comporte pas d’outil intégré pour faire la distribution de notre clé liveUSB. Et la recherche d’un logiciel (libre) pour répondre à ce besoin n’a rien donné. Il y a deux raisons à cela : — Lorsqu’une clef USB comporte plusieurs partitions, l’explorateur Windows n’est capable d’affi- cher que la première partition. Nous voulons justement utiliser une première partition pour le sys- tème, et une deuxième partition pour les données de persistance. — Windows ne gère pas le format de fichier ext4. Or c’est justement ce format qui est adapté pour la persistance. En effet, le format de fichiers souvent utilisé pour les clefs USB est le FAT32. Mais ce format présente une limitation de taille de fichier de presque 4 Gio (232 octets pour être exact). Nous pouvons adopter deux positions : — Soit on abandonne l’idée d’avoir deux partitions séparées et on abandonne l’idée d’utiliser ext4. Cela signifie rester en FAT32, et mettre la persistance dans un fichier dédié (mais sa taille sera limitée à presque 4 Gio). C’est une solution possible, qui est d’ailleurs utilisée par beaucoup de clefs démar- rables. — Soit on abandonne l’idée de construire la clé liveUSB en restant sous Windows uniquement. C’est la démarche que nous proposons.

Solution proposée : création d’une clef démarrable GNU/Linux (qui servira de boîte à outils in- termédiaire)

Nous proposons une solution avec Lubuntu, mais d’autres distributions basées sur Debian pourraient convenir (mais nous n’avons pas eu le temps d’en tester). On pourra consulter l”issue #89 275 pour comprendre les étapes qui nous amènent à cette solution. — On télécharge directement l’iso lubuntu-15.10-desktop-i386.iso sur http://lubuntu.fr/down. htm (sans passer par LinuxLive USB Creator).

Attention : Les versions plus anciennes de lubuntu ne conviennent pas!

— Avec LinuxLive USB Creator 276, on sélectionne cette iso. Même si cette iso n’est pas dans la liste de compatibilité, LinuxLive USB Creator accepte quand même de créer un fichier de persistance (c’est ici un fichier dédié pour la persistance, il a une taille limitée à presque 4 Gio = 232 octets exactement). — La persistance n’est pas indispensable ici. On pourrait s’en passer, mais on en profite car cela pourrait servir dans d’autres situations. — Après gravure de la clef, redémarrer cette clef, et ensuite suivre la [Méthode A - rapide, simple et préférée] Sous GNU/Linux, méthode automatisée (page 24) ou la [Méthode B - pour comprendre] Sous GNU/Linux, méthode étape par étape (page 25).

272. https://git.framasoft.org/groolot/liveUSB/issues/89#note_14328 273. https://git.framasoft.org/groolot/liveUSB/issues/36#note_11929 274. https://git.framasoft.org/groolot/liveUSB/issues/89 275. https://git.framasoft.org/groolot/liveUSB/issues/89 276. http://www.linuxliveusb.com/

5.2. Transfert de l’image système et conﬁguration de la persistance 27 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

Fig. 1 – Interface de Linux Live USB Creator

5.3 Et si on dispose déjà d’une clef liveUSB ?

On peut l’utiliser pour en fabriquer une autre, il sufﬁt de démarrer sur la première clef et de suivre la documentation depuis Transfert de l’image système et conﬁguration de la persistance (page 23).

28 Chapitre 5. Documentation distributeur CHAPITRE 6

Documentation constructeur

6.1 Prologue

Cette documentation est une simplification de la documentation officielle de live-build 277 et est adaptée à la configuration fournie par ce projet.

6.1.1 Nomenclature

Voir Nomenclature (page 41) pour des explications sur la nomenclature concernant les lignes de commande.

6.1.2 Numérotation des versions

Nous nous basons sur le principe de numérotation sémantique des versions 278 proposé par Tom Preston Werner 279.

6.2 Mécanisme général d’une construction

La construction d’une clef USB bootable requiert d’assurer les étapes suivantes : — Installation des Pré-requis (page 45) sur votre système de construction — Récupération de la configuration initiale et des outils accessoires (page 31) — Choix de la configuration spécifique (page 31) (RC ou entière) — Lors de la construction d’un système liveUSB (page 34)

Note : Les 3 stades de la construction — la construction d’une intermédiaire qui mènera à une RC (développement) — la construction d’une RC (release candidate) qui mènera à une distribuable (test et validation) — la construction d’une version distribuable (mise en production) Quel que soit le stade de la construction, le mécanisme est toujours le même. La variance d’un stade à l’autre correspond à la position dans l’arbre des conﬁgurations ﬁgées (sur quel tag nous plaçons-nous pour réaliser la construction).

277. http://debian-live.alioth.debian.org/live-manual/unstable/manual/html/live-manual.en.html 278. http://www.semver.org 279. http://tom.preston-werner.com/

29 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

6.3 Mise en œuvre de la construction

Voir la vidéo de démonstration 280 dont les étapes sont détaillées ci-après.

6.3.1 Pré-requis

Les exigences pour la création ou la distribution de l’images système liveUSB sont faibles : — Accès super-utilisateur (root) sur le système — Un shell bash >=4.3 — Un noyau Linux >=2.6 — Une version mise à jour de live-build >=4.0.3 (voir Installation de live-build pour les utilisateurs sans Debian GNU/Linux (page 39)) — Une version à jour de GNU make >=3.81 — Une version à jour de cryptsetup >=1.6.6 — Une version à jour de dd >=8.23 (fourni par le paquet coreutils) — Une version à jour de debootstrap >=1.0.67 — Une version à jour de git >=2.1.4 — Une version à jour de losetup >=2.26 (fourni par le paquet util-linux) — Une version à jour de partprobe >=3.2 (fourni par le paquet parted) — Une version à jour de pv >=1.5.7 — Une version à jour de sfdisk >=2.26 — Une version à jour de syslinux >=6.03 fournissant l’EFI (syslinux-efi >=6.03 pour De- bian) — Une version à jour de whiptail >=0.52.17 ou dialog >=1.2

Super-utilisateur ?

La commande suivante permet de connaître le nom de l’utilisateur que nous sommes :

# whoami root

si l’utilisateur n’est pas root, alors il faut s’assurer que nous sommes un utilisateur faisant partie du groupe sudo :

$ groups lambda cdrom floppy sudo audio video plugdev ...

Si dans la sortie de la commande groups vous n’appercevez pas le mot clef sudo, c’est que vous ne faites pas partie du groupe sudo. Dans ce cas, vériﬁez avec l’administrateur de votre système aﬁn d’obtenir un compte vous permettant de réaliser en tant que super-utilisateur les commandes suivantes : make, lb et apt-get.

Installer les logiciels nécessaires

# apt-get update && apt-get install git live-build debootstrap make

ou avec sudo

$ sudo apt-get update && sudo apt-get install git live-build debootstrap make

280. https://www.youtube.com/watch?v=mSmJwO6gATY

30 Chapitre 6. Documentation constructeur Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

6.3.2 Récupération de la conﬁguration initiale et des outils accessoires

$ cd ~ $ git clone https://framagit.org/groolot/liveUSB.git $ cd liveUSB $ ls auto automate_release burn config credentials dist documentation Makefile README.

˓→rst SYSTEM.rst

6.3.3 Choix de la conﬁguration spéciﬁque

Lister les conﬁgurations disponibles

$ git tag v0.1 v0.1.1 v0.1.2 v0.1.3 ... v0.1.5-jessie

6.3.4 Exemple de construction de l’image système dans sa version v0.1.3

# git checkout v0.1.3 # make build ou bien avec sudo

$ git checkout v0.1.3 $ sudo make build

À l’issue de la construction, l’image système se trouve disponible dans le répertoire courant portant le nom liveUSB-v0.1.3-amd64.img (ou tout autre numéro de version en fonction du choix de la conﬁguration fait au préalable).

6.3. Mise en œuvre de la construction 31 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

32 Chapitre 6. Documentation constructeur CHAPITRE 7

Documentation contributeur

7.1 Vous rencontrez des dysfonctionnements

7.1.1 À l’usage de la clef liveUSB

1. Assurez-vous d’avoir lu Documentation utilisateur (page 21) 2. Connectez-vous à FramaGit 281 (ouvrir un compte 282 si besoin) 3. Rendez-vous dans l”espace de gestion des incidents 283 4. Recherchez dans l’ensemble des issues ouvertes et fermées si quelqu’un n’a pas déjà rencontré votre dysfonctionnement (utilisez le champ de recherche en haut à droite de la liste pour effectuer une recherche plein texte 284) 5. Si à ce stade vous n’avez trouvé d’informations satisfaisantes alors vous allez devoir rédiger une nouvelle issue aﬁn de nous rendre compte de votre situation et du dysfonctionnement : (a) Accédez à la page de création 285 d’une nouvelle issue (b) Renseignez le champ Title d’une phrase très courte décrivant le problème comme par exemple : « le pointeur de souris ne s’afﬁche » (c) Renseignez le champ Description d’une description détaillée décrivant le problème, avec les élé- ments minimum suivants : — le modèle de votre machine — la quantité de mémoire vive (RAM exprimée en Go) — le modèle du CPU (ex : Dual Core [email protected]) — la version de liveUSB touchée par ce dysfonctionnement — la description de la méthode pour reproduire le dysfonctionnement — une proposition de correction ou d’amélioration (optionnel) (d) Renseigner le champ Labels à : — err: boot si le dysfonctionnement empêche le démarrage du système liveUSB — err: system si le dysfonctionnement survient une fois le système liveUSB démarré (e) Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue 281. https://git.framasoft.org 282. https://git.framasoft.org/users/sign_in 283. https://git.framasoft.org/groolot/liveUSB/issues 284. https://fr.wikipedia.org/wiki/Recherche_plein_texte 285. https://git.framasoft.org/groolot/liveUSB/issues/new?issue

33 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

Avertissement : NE PAS RENSEIGNER les champs Assignee et Milestone

7.1.2 Lors de la distribution d’une clef liveUSB

1. Assurez-vous d’avoir lu Documentation distributeur (page 23) 2. Connectez-vous à FramaGit 286 (ouvrir un compte 287 si besoin) 3. Rendez-vous dans l”espace de gestion des incidents 288 4. Recherchez dans l’ensemble des issues ouvertes et fermées si quelqu’un n’a pas déjà rencontré votre dysfonctionnement (utilisez le champ de recherche en haut à droite de la liste pour effectuer une recherche plein texte 289) 5. Si à ce stade vous n’avez trouvé d’informations satisfaisantes alors vous allez devoir rédiger une nouvelle issue aﬁn de nous rendre compte de votre situation et du dysfonctionnement : (a) Accédez à la page de création 290 d’une nouvelle issue (b) Renseignez le champ Title d’une phrase très courte décrivant le problème comme par exemple : « la partition de persistance ne se créée pas » (c) Renseignez le champ Description d’une description détaillée décrivant le problème, avec les élé- ments minimum suivants : — le modèle de votre machine — la quantité de mémoire vive (RAM exprimée en Go) — le modèle du CPU (ex : Dual Core [email protected]) — la version de liveUSB touchée par ce dysfonctionnement — la description de la méthode pour reproduire le dysfonctionnement — une proposition de correction ou d’amélioration (optionnel) (d) Renseigner le champ Labels à err: distribuer (e) Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement : NE PAS RENSEIGNER les champs Assignee et Milestone

7.1.3 Lors de la construction d’un système liveUSB

1. Assurez-vous d’avoir lu Documentation constructeur (page 29) 2. Connectez-vous à FramaGit 291 (ouvrir un compte 292 si besoin) 3. Rendez-vous dans l”espace de gestion des incidents 293 4. Recherchez dans l’ensemble des issues ouvertes et fermées si quelqu’un n’a pas déjà rencontré votre dysfonctionnement (utilisez le champ de recherche en haut à droite de la liste pour effectuer une recherche plein texte 294) 5. Si à ce stade vous n’avez trouvé d’informations satisfaisantes alors vous allez devoir rédiger une nouvelle issue aﬁn de nous rendre compte de votre situation et du dysfonctionnement : (a) Accédez à la page de création 295 d’une nouvelle issue (b) Renseignez le champ Title d’une phrase très courte décrivant le problème comme par exemple : « la partition de persistance ne se créée pas »

286. https://git.framasoft.org 287. https://git.framasoft.org/users/sign_in 288. https://git.framasoft.org/groolot/liveUSB/issues 289. https://fr.wikipedia.org/wiki/Recherche_plein_texte 290. https://git.framasoft.org/groolot/liveUSB/issues/new?issue 291. https://git.framasoft.org 292. https://git.framasoft.org/users/sign_in 293. https://git.framasoft.org/groolot/liveUSB/issues 294. https://fr.wikipedia.org/wiki/Recherche_plein_texte 295. https://git.framasoft.org/groolot/liveUSB/issues/new?issue

34 Chapitre 7. Documentation contributeur Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

(c) Renseignez le champ Description d’une description détaillée décrivant le problème, avec les élé- ments minimum suivants : — le modèle de votre machine — la quantité de mémoire vive (RAM exprimée en Go) — le modèle du CPU (ex : Dual Core [email protected]) — la version de liveUSB touchée par ce dysfonctionnement — la description de la méthode pour reproduire le dysfonctionnement — une proposition de correction ou d’amélioration (optionnel) (d) Renseigner le champ Labels à err: build (e) Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement : NE PAS RENSEIGNER les champs Assignee et Milestone

7.2 Vous ne trouvez pas la documentation adaptée à votre besoin

1. Assurez-vous d’avoir lu Documentation liveUSB v1.1 (page 1) 2. Connectez-vous à FramaGit 296 (ouvrir un compte 297 si besoin) 3. Rendez-vous dans l”espace de gestion des incidents 298 4. Recherchez dans l’ensemble des issues ouvertes et fermées si quelqu’un n’a pas déjà évoqué ce manque documentaire (utilisez le champ de recherche en haut à droite de la liste pour effectuer une recherche plein texte 299) 5. Si à ce stade vous n’avez trouvé d’informations satisfaisantes alors vous allez devoir rédiger une nouvelle issue aﬁn de nous rendre compte de votre situation et du manque documentaire : (a) Accédez à la page de création 300 d’une nouvelle issue (b) Renseignez le champ Title d’une phrase très courte décrivant le problème comme par exemple : « pas de documentation sur les participantsd au projet » (c) Renseignez le champ Description d’une description détaillée décrivant le manque documentaire, avec les éléments minimum suivants : — le modèle de votre machine — la quantité de mémoire vive (RAM exprimée en Go) — le modèle du CPU (ex : Dual Core [email protected]) — la version de liveUSB touchée par ce manque documentaire — la description de la documentation absente — où placeriez-vous cette documentation? — une proposition de correction ou d’amélioration (optionnel) (d) Renseigner le champ Labels à étape: documentation (e) Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement : NE PAS RENSEIGNER les champs Assignee et Milestone

7.3 Vous voulez apporter votre aide, votre savoir-faire ou votre expertise

Lisez avant tout le diagramme Structure de travail et répartition des rôles (page 41) aﬁn de vous assurer du nom du rôle ou de la tâche que vous proposez. 296. https://git.framasoft.org 297. https://git.framasoft.org/users/sign_in 298. https://git.framasoft.org/groolot/liveUSB/issues 299. https://fr.wikipedia.org/wiki/Recherche_plein_texte 300. https://git.framasoft.org/groolot/liveUSB/issues/new?issue

7.2. Vous ne trouvez pas la documentation adaptée à votre besoin 35 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

7.3.1 Vous voulez participer à la rédaction de la documentation

1. Assurez-vous d’avoir lu Structure de travail et répartition des rôles (page 41) et Vous ne trouvez pas la documentation adaptée à votre besoin (page 35) 2. Connectez-vous à FramaGit 301 (ouvrir un compte 302 si besoin) 3. Rendez-vous dans l”espace de gestion des incidents 303 4. Accédez à la page de création 304 d’une nouvelle issue 5. Renseignez le champ Title d’une phrase très courte décrivant votre proposition : « documenter l’étape de test d’une version RC » 6. Renseignez le champ Description d’une description détaillée décrivant votre proposition documentaire, avec les éléments minimum suivants : — le modèle de votre machine — la quantité de mémoire vive (RAM exprimée en Go) — le modèle du CPU (ex : Dual Core [email protected]) — la version de liveUSB touchée par cette proposition — l’ébauche de la documentation envisagée (plan et léger contenu) — où placeriez-vous cette documentation? 7. Renseigner le champ Labels à étape: documentation 8. Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement : NE PAS RENSEIGNER les champs Assignee et Milestone

7.3.2 Il faut améliorer la collection logicielle

1. Assurez-vous d’avoir lu Structure de travail et répartition des rôles (page 41) et la liste des logiciels installés dans Présentation du système liveUSB (page 3) 2. Connectez-vous à FramaGit 305 (ouvrir un compte 306 si besoin) 3. Rendez-vous dans l”espace de gestion des incidents 307 4. Accédez à la page de création 308 d’une nouvelle issue 5. Renseignez le champ Title d’une phrase très courte décrivant votre proposition : « ajouter le logiciel “0A.D.” » ou bien « supprimer le logiciel “ffmpeg” » 6. Renseignez le champ Description d’une description détaillée décrivant votre proposition, avec les éléments minimum suivants : — le modèle de votre machine — la quantité de mémoire vive (RAM exprimée en Go) — le modèle du CPU (ex : Dual Core [email protected]) — la version de liveUSB touchée par cette proposition — le nom exact du paquet logiciel dans Debian 309 distribution stretch — à quelle catégorie de logiciels celui-ci se rapporte-t-il? (voir la liste des logiciels installés dans Présen- tation du système liveUSB (page 3)) 7. Renseigner le champ Labels à étape: configurer et ajouter le label : — pkg: manquant si vous prpoposez un ajout — pkg: à supprimer si vous prpoposez une suppression 8. Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

301. https://git.framasoft.org 302. https://git.framasoft.org/users/sign_in 303. https://git.framasoft.org/groolot/liveUSB/issues 304. https://git.framasoft.org/groolot/liveUSB/issues/new?issue 305. https://git.framasoft.org 306. https://git.framasoft.org/users/sign_in 307. https://git.framasoft.org/groolot/liveUSB/issues 308. https://git.framasoft.org/groolot/liveUSB/issues/new?issue 309. https://www.debian.org/distrib/packages#view

36 Chapitre 7. Documentation contributeur Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

Avertissement : NE PAS RENSEIGNER les champs Assignee et Milestone

7.3.3 Il faut vraiment améliorer l’aspect esthétique du système liveUSB

1. Assurez-vous d’avoir lu Structure de travail et répartition des rôles (page 41) 2. Connectez-vous à FramaGit 310 (ouvrir un compte 311 si besoin) 3. Rendez-vous dans l”espace de gestion des incidents 312 4. Accédez à la page de création 313 d’une nouvelle issue 5. Renseignez le champ Title d’une phrase très courte décrivant votre proposition : « changer l’image d’arrière plan du menu de démarrage » 6. Renseignez le champ Description d’une description détaillée décrivant votre proposition, avec les éléments minimum suivants : — le modèle de votre machine — la quantité de mémoire vive (RAM exprimée en Go) — le modèle du CPU (ex : Dual Core [email protected]) — la version de liveUSB touchée par cette proposition — l’ébauche ou le contenu réel de la proposition (croquis, images, etc.) — où placeriez-vous cette ressource? (optionnel) 7. Renseigner le champ Labels à tuning 8. Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement : NE PAS RENSEIGNER les champs Assignee et Milestone

310. https://git.framasoft.org 311. https://git.framasoft.org/users/sign_in 312. https://git.framasoft.org/groolot/liveUSB/issues 313. https://git.framasoft.org/groolot/liveUSB/issues/new?issue

7.3. Vous voulez apporter votre aide, votre savoir-faire ou votre expertise 37 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

38 Chapitre 7. Documentation contributeur CHAPITRE 8

Installation de live-build pour les utilisateurs sans Debian GNU/Linux

8.1 Récupération du code source live-build est développé en utilisant le système de contrôle de version Git. Dans les systèmes basés sur Debian, il est fourni par le paquet git. Pour examiner le dernier code, exécutez :

$ git clone https://anonscm.debian.org/cgit/debian-live/live-build.git

8.2 Installation de live-build

Vous pouvez également installer live-build directement sur votre système en exécutant :

# make install et le désinstaller avec :

# make uninstall

39 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

40 Chapitre 8. Installation de live-build pour les utilisateurs sans Debian GNU/Linux CHAPITRE 9

Structure de travail et répartition des rôles

41 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

42 Chapitre 9. Structure de travail et répartition des rôles ANNEXE A

Nomenclature

Les lignes de commande commençant par $ doivent être saisies par l’utilisateur lambda, exemple :

$ cd ~ $ ip link show

Les lignes de commande commençant par # doivent être saisies par le super utilisateur, ou en tant qu’utilisateur avec élévation éphémère de pouvoir (sudo), exemple :

# touch /etc/shadow # rm -rf /tmp/* ou l’équivalent avec sudo :

$ sudo touch /etc/shadow $ sudo rm -rf /tmp/*

Les lignes ne commençant pas par $ ou # ne doivent pas être saisies car elles sont les afﬁchages de sortie des commandes précédentes, exemple :

$ cat /etc/hostname ISNconstructeur # ls /var backups cache games lib local lock log mail opt run spool tmp

43 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

44 Annexe A. Nomenclature ANNEXE B

Pré-requis

45 Documentation globale de liveUSB, Version 1.1-sio-gnome-stretch-stretch

46 Annexe B. Pré-requis ANNEXE C

Contributions

Documentations — Vincent LABBÉ Tests et validations — Vincent LABBÉ — Dimitri TRICARD