From 4076e416443d921c2aea54db73ec86b870e8ff6e Mon Sep 17 00:00:00 2001
From: gcolpart <gcolpart+gitit@evolix.fr>
Date: Mon, 19 Sep 2016 19:17:53 +0200
Subject: [PATCH] Creation Howto Screen

---
 HowtoScreen.md | 91 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 HowtoScreen.md

diff --git a/HowtoScreen.md b/HowtoScreen.md
new file mode 100644
index 00000000..689e517e
--- /dev/null
+++ b/HowtoScreen.md
@@ -0,0 +1,91 @@
+# Howto Screen
+
+Screen permet de gérer des terminaux virtuels, notamment lancés en arrière plan.
+Il permet ainsi de lancer facilement des process dans un terminal et de les laisser tourner sans rester connecté.
+
+<https://www.gnu.org/software/screen/manual/screen.html>
+
+## Installation
+
+~~~{.bash}
+# apt install screen
+~~~
+
+## Utilisation de base
+
+Lister les screens lançés :
+
+~~~
+$ screen -ls
+There are screens on:
+        30742.pts-6.server  (19/09/2016 18:24:12)   (Detached)
+        4288.pts-2.server   (21/05/2015 18:07:39)   (Detached)
+2 Sockets in /var/run/screen/S-jdoe.
+~~~
+
+Pour lancer un nouveau screen (l'option *-S foo* est facultative, elle permet juste de nommer son screen) :
+
+~~~{.bash}
+$ screen -S foo
+~~~
+
+Pour se rattacher à un screen existant avec le numéro 30742 (voir screen -ls)
+~~~{.bash}
+$ screen -rd 30742
+~~~
+
+Pour se rattacher à un screen existant et utilisé en partage (permettant de voir à plusieurs un terminal)
+~~~{.bash}
+$ screen -x 30742
+~~~
+
+Une fois connecté à un screen, voici la liste des commandes de base utiles :
+
+~~~
+Ctrl+a+d : sortir du screen
+<Ctrl>+a+<Echap> OU <Ctrl>+a+[ : remonter dans le screen
+<Ctrl>+a+s : freezer le screen courant
+<Ctrl>+a+q : defreezer le screen courant (utile quand on freeze par erreur...)
+~~~
+
+
+## Utilisation avancée 
+
+Supprimer les screen "morts" :
+
+~~~{.bash}
+$ screen -wipe
+~~~
+
+Une fois connecté à un screen, voici la liste des commandes pour gérer les onglets :
+
+~~~
+<Ctrl>+a+c : ouvrir un nouvel onglet
+<Ctrl>+a+A (ou T ??) : renommer l'onglet courant
+<Ctrl>+a+n : passer a l'onglet suivant
+<Ctrl>+a+p : revenir a l'onglet precedent
+<Ctrl>+a+w : afficher le statut des onglets
+<Ctrl>+a+<N> : aller au Nième onglet
+~~~
+
+Pour découper un screen verticalement :
+
+~~~
+<Ctrl>+a+S : spliter un screen verticalement
+<Ctrl>+a+X : détruire la region splitée
+<Ctrl>+a+<Tab> : se déplacer entre les régions splitées
+~~~
+
+## screen avec port série
+
+~~~{.bash}
+$ screen /dev/ttyS0 38400
+~~~
+
+## FAQ
+
+### Erreur *Cannot open your terminal '/dev/pts/N' - please check.*
+
+On ne peut pas lancer/attacher screen après avoir fait un *sudo* ou *su*.
+La solution propre est d'utiliser SSH à la place (rappel, rien n'empêche de faire un ssh sur localhost).
+Le contournement temporaire est de faire un *chown 666 /dev/pts/N*
\ No newline at end of file