getInfo.md 10.3 KB
Newer Older
Kyodev's avatar
Kyodev committed
1 2
# getInfo

kyodev's avatar
kyodev committed
3
![version: 4.16.0](https://img.shields.io/badge/version-4.16.0-blue.svg?longCache=true&style=for-the-badge)
kyodev's avatar
kyodev committed
4 5
![bash langage](https://img.shields.io/badge/bash-4-brightgreen.svg?longCache=true&style=for-the-badge)
![license LPRAB / WTFPL](https://img.shields.io/badge/license-LPRAB%20%2F%20WTFPL-blue.svg?longCache=true&style=for-the-badge)
Kyodev's avatar
Kyodev committed
6

Kyodev's avatar
Kyodev committed
7
> * script bash qui rassemble un certain nombre d'informations sur la configuration d'un PC
Kyodev's avatar
Kyodev committed
8 9 10
> * un rapport au format **markdown** est formé
> * ce rapport peut être exporté sur un pastebin (avec rendu markdown) pour partager les informations
> * par défaut le paste sera conservé 7 jours
Kyodev's avatar
Kyodev committed
11
> * aucune donnée confidentielle n'est contenue dans le rapport (mot de passe ssid, n° de série, adresses MAC)
Kyodev's avatar
Kyodev committed
12
> * l'installation du script est possible en option. il se mettra alors éventuellement à jour automatiquement
Kyodev's avatar
Kyodev committed
13 14
> * l'option -us permet la mise à jour du script en place, sans installation et sans test ultérieur de 
    nouvelle version 
kyodev's avatar
kyodev committed
15
> * testé sous debian (développement), Ubuntu (notamment LTS 16.04), ArchLinux, openSuse, Fedora et Gentoo
Kyodev's avatar
Kyodev committed
16 17 18
> * tout est collecté avec les droits utilisateur   
   seul le contenu de **journalctl** (ou dmesg) nécessite des droits administrateur et le mot de passe sera demandé.
   À défaut de le connaître ou le saisir, les journaux système ne seront pas affichés.
kyodev's avatar
kyodev committed
19 20
> * à l'installation, le script crée un lanceur, `gfetch`, qui affiche un résumé système dans le terminal (similaire à neofetch)
> * option possible pour inscrire gfetch dans bashrc (système), résumé du système s'affichera à l'ouverture d'une console 
Kyodev's avatar
Kyodev committed
21

kyodev's avatar
kyodev committed
22

Kyodev's avatar
Kyodev committed
23 24 25
## chargement et lancement du script:

```shell
kyodev's avatar
kyodev committed
26
wget -nv -O getInfo https://framaclic.org/h/getinfo
Kyodev's avatar
Kyodev committed
27 28
chmod +x getInfo
```
Kyodev's avatar
Kyodev committed
29

kyodev's avatar
kyodev committed
30
* liens de chargement alternatif `wget -nv -O getInfo https://framagit.org/sdeb/getInfo/raw/master/getInfo`
Kyodev's avatar
Kyodev committed
31

Kyodev's avatar
Kyodev committed
32 33 34 35
```shell
./getInfo
```
```text
kyodev's avatar
kyodev committed
36 37 38 39
              _   ___        __       
    __ _  ___| |_|_ _|_ __  / _| ___  
   / _' |/ _ \ __|| || '_ \| |_ / _ \ 
  | (_| |  __/ |_ | || | | |  _| (_) |
kyodev's avatar
kyodev committed
40 41 42 43
   \__, |\___|\__|___|_| |_|_|  \___/  
   |___/  version 4.12.0 - 26/06/2018

  •ø••••••••••••••••◇◇◇•••••
Kyodev's avatar
Kyodev committed
44

kyodev's avatar
kyodev committed
45 46 47 48
  les droits root sont demandés et requis pour afficher les journaux systèmes
  [su] nécessite la saisie du mot de passe root
  [sudo] nécessite le mot de passe utilisateur si celui peut obtenir les privilèges administrateur
  à défaut de saisie valide, les journaux n'apparaîtront pas dans le rapport final
Kyodev's avatar
Kyodev committed
49

kyodev's avatar
kyodev committed
50
[su]   Mot de passe : 
Kyodev's avatar
Kyodev committed
51 52 53

  le rapport est disponible en local, fichier: getInfo_rapport.md
  vous pouvez le visualiser ultérieurement avec getInfo -l
kyodev's avatar
kyodev committed
54
  vous pourrez aussi l'exporter avec getInfo -p
Kyodev's avatar
Kyodev committed
55 56 57

```

Kyodev's avatar
Kyodev committed
58 59 60
* par défaut, l'export sur un pastebin ne se fera pas (touche <Entrée\>)
* répondre o + <Entrée\> permet d'exporter et de récupérer un lien où le paste sera visible pendant 7 jours en
  standard. Après ce délai il sera supprimé.
Kyodev's avatar
Kyodev committed
61

Kyodev's avatar
Kyodev committed
62 63
```text
  exporter sur le pastebin par défaut? [o/N] o
Kyodev's avatar
Kyodev committed
64 65

  
Kyodev's avatar
Kyodev committed
66
  votre paste:  https://www.pastery.net/abcdef/
Kyodev's avatar
Kyodev committed
67
  (valide pendant 7 jours)
Kyodev's avatar
Kyodev committed
68

Kyodev's avatar
Kyodev committed
69 70 71
  le rapport est disponible en local, fichier: getInfo_rapport.md
  vous pouvez le visualiser ultérieurement avec getInfo -l
  vous pourrez l'exporter ultérieurement avec getInfo -p
Kyodev's avatar
Kyodev committed
72 73

```
Kyodev's avatar
Kyodev committed
74

Kyodev's avatar
Kyodev committed
75 76
* les erreurs/warnings/critiques via _journalctl_ (ou _dmesg_) ne sont pas rapportées sans saisie de mot de 
  passe superutilisateur. À défaut, les extraits dmesg ne seront pas dans le rapport final.
Kyodev's avatar
Kyodev committed
77 78 79 80
* export ou non, le rapport au format markdown est disponible dans le répertoire courant, dans le fichier 
  **getInfo_rapport.md**
* ultérieurement, le rapport est consultable avec la commande `./getInfo -l`
* ultérieurement, le rapport peut être (re)exporté avec la commande `./getInfo -p`
kyodev's avatar
kyodev committed
81 82 83
* la durée du paste peut être configurée avec l'option supplémentaire `-t n` (n=nombre de jours), par exemple:
    * `./getInfo -p -t 14` pour exporter un rapport existant pour une période de 14 jours
    * `./getInfo -t 21` pour former et exporter un rapport pour une période de 21 jours
Kyodev's avatar
Kyodev committed
84

Kyodev's avatar
Kyodev committed
85

Kyodev's avatar
Kyodev committed
86 87 88 89
## alertes / informations

éventuellement selon les détections, les alertes ou informations suivantes sont affichées:

Kyodev's avatar
Kyodev committed
90 91
* analyse boot-systemd
    * des services sont en erreur (alerte) : des services actifs sont dans un état erreur/échec/non trouvé
Kyodev's avatar
Kyodev committed
92 93 94 95
* disques
    * température de disque > 50°C (information) {hddtemp requis}
    * fichier /etc/initramfs-tools/conf.d/resume absent (information)
    * l'UUID dans resume ne correspond pas à celui du swap (alerte): erreur hibernation et boot allongé
Kyodev's avatar
Kyodev committed
96
* gestionnaire de paquets Apt/dpkg (debian)
Kyodev's avatar
Kyodev committed
97 98
    * apt-transport-https inutile si apt>1.5
    * https avec deb.debian si apt>1.5
Kyodev's avatar
Kyodev committed
99
    * url httpredir obsolètes dans les sources.list (info)
Kyodev's avatar
Kyodev committed
100
    * fichiers ayant une extension différente de _.list_ dans /etc/apt/sources.list.d/ (info)
Kyodev's avatar
Kyodev committed
101 102 103 104 105 106 107 108
    * erreur apt update (alerte)
    * paquets à mettre à jour `apt upgrade`(info)
    * paquets à mettre à jour avec `apt full-upgrade` (info)
    * paquets inutiles `apt autoremove` (info)
    * archives périmées `apt autoclean` (info)
    * taille du cache des paquets
    * fichiers de configuration de paquets orphelins (^rc) (info)
    * si deborphan, bibliothèques orphelines (info)
Kyodev's avatar
Kyodev committed
109
* journaux
kyodev's avatar
kyodev committed
110
    * The directory "/usr/share/fonts/X11/cyrillic" does not exist (alert): avertissement comment enlever ce message
Kyodev's avatar
Kyodev committed
111
    * les journaux ne sont pas persistants (info) : revoir les logs du précédent boot n'est donc pas 
Kyodev's avatar
Kyodev committed
112
      possible pour investigation (`journalctl --no-hostname --boot -1`) par exemple
kyodev's avatar
kyodev committed
113
    * détection firmware bug (alerte): voir microde? présence ou absence testé dans la partie système
Kyodev's avatar
Kyodev committed
114
* graphisme
Kyodev's avatar
Kyodev committed
115 116
    * une carte graphique semble désactivée (alerte): malgré l'utilisation de **DRI_PRIME=1** ou **optirun**, 
      une carte graphique n'apparaît pas dans lspci
Kyodev's avatar
Kyodev committed
117 118 119 120 121 122 123 124 125
    * l'accélération 3D n'est pas activée (info): voir glxinfo
* locale
    * Network time on: no (info): pas de service NTP actif (synchronisation de l'heure)
    * RTC in local TZ: yes (alerte): L’horloge matérielle est en heure locale et pas en UTC. Les modifications 
      d’heure d’été/hiver peuvent être incohérentes."
* réseau
    * interface wifi en erreur <wlx...> (alerte): l'interface n'est pas reconnue et est donc mal nommée, 
      éventuellement, [changer le renommage](https://kyodev.frama.io/kyopages/trucs/interfaces-nommage-classique/)
    * ifconfig [net-tools](https://github.com/giftnuss/net-tools) est un projet abandonné depuis 
Kyodev's avatar
Kyodev committed
126
      des années (info): iproute2 [linuxfoundation](https://wiki.linuxfoundation.org/networking/iproute2) le 
Kyodev's avatar
Kyodev committed
127
      remplace
Kyodev's avatar
Kyodev committed
128
    * adresses MAC visibles dans les ipv6 SLAAC (info): traçage possible sur les réseaux
Kyodev's avatar
Kyodev committed
129 130
* système
    * microcodes intel|amd64 non installés (info): donc pas de corrections bugs du processeur
kyodev's avatar
kyodev committed
131
    * display manager **SLiM** abandonné et non compatible avec systemd (alerte): voir [archlinux](https://wiki.archlinux.org/index.php/SLiM)
Kyodev's avatar
Kyodev committed
132 133


Kyodev's avatar
Kyodev committed
134
## exemple de rapport
Kyodev's avatar
Kyodev committed
135

kyodev's avatar
kyodev committed
136
[getInfo_rapport](rapport.md)
Kyodev's avatar
Kyodev committed
137

Kyodev's avatar
Kyodev committed
138

Kyodev's avatar
Kyodev committed
139 140 141 142 143 144
## help

```shell
./getInfo -h
```
```text
kyodev's avatar
kyodev committed
145 146 147 148
              _   ___        __       
    __ _  ___| |_|_ _|_ __  / _| ___  
   / _' |/ _ \ __|| || '_ \| |_ / _ \ 
  | (_| |  __/ |_ | || | | |  _| (_) |
kyodev's avatar
kyodev committed
149
   \__, |\___|\__|___|_| |_|_|  \___/  -h
kyodev's avatar
kyodev committed
150
   |___/  version 4.12.0 - 26/06/2018
kyodev's avatar
kyodev committed
151
   
kyodev's avatar
kyodev committed
152 153 154 155 156 157 158 159 160 161 162 163 164 165 166
  ./getInfo [options]: exécution script (non installé)
    getInfo [options]: exécution script installé dans le système
  -------- Options:
    -c : (catégorie)  menu sélection catégorie d'analyse
        -cs : catégorie système  -cc : catégorie configuration  -csc : système&configuration
        -cr : catégorie réseau   -ca : catégorie analyse        -cscra: toutes les 4 catégories
    -j : (journaux)  analyse démarrage système, log Xorg, kernel et système, catégorie -ca
    -l : (list)  afficher le rapport markdown existant
    -p : (paste) exporte le rapport markdown existant, durée standard du paste 7 jours
      --us     : upgrade spécial du script en place (sans être installé)
      --ip     : affiche ip publique (ipv4/ipv6), pas de rapport markdown
      --mac    : affiche adresses Mac, pas de rapport markdown
      --rc     : affiche un résumé systéme (équivalent gfetch si non installé)
      --serial : affiche n° série disques, batterie et châssis, pas de rapport markdown
      --ssid   : affiche configurations ssid, pas de rapport markdown, root & NetworkManager requis
kyodev's avatar
kyodev committed
167
  
kyodev's avatar
kyodev committed
168
      --debug-paste : affichage retour json de de l'export sur pastebin
kyodev's avatar
kyodev committed
169 170 171 172 173 174 175 176 177 178 179
      --debug       : messages d'erreur (stderr) logués et exportés avec le rapport
      --dev         : une version de dev du script (si existante) est recherchée
   -t n, --time n   : temps de conservation du paste, par défaut 7 jours
  -------- Script, installation:
    -h, --help    : affichage aide
    -i, --install : installation du script dans le système        (root requis)
    -r, --remove  : désinstallation du script                     (root requis)
    -u, --upgrade : mise à jour script installé
    -v, --version : version du script, installé et en ligne
      --irc       : inscription gfetch dans .bashrc               (root requis) 
      --rrc       : désinscription gfetch dans .bashrc            (root requis)
kyodev's avatar
kyodev committed
180
  -----------------------------------------------------------------------
kyodev's avatar
kyodev committed
181
  plus d'infos: https://framaclic.org/h/doc-getinfo
Kyodev's avatar
Kyodev committed
182

Kyodev's avatar
Kyodev committed
183
```
Kyodev's avatar
Kyodev committed
184

Kyodev's avatar
Kyodev committed
185
## informations avancées
Kyodev's avatar
Kyodev committed
186

Kyodev's avatar
Kyodev committed
187
[getInfo avancé](getInfo_plus.md)
Kyodev's avatar
Kyodev committed
188 189 190 191


## sources

kyodev's avatar
kyodev committed
192
sur [framagit](https://framagit.org/sdeb/getInfo/blob/master/getInfo)
Kyodev's avatar
Kyodev committed
193 194 195 196 197


## contact

pour tout problème ou suggestion concernant ce script, n'hésitez pas à ouvrir une issue 
kyodev's avatar
kyodev committed
198
[Framagit](https://framagit.org/sdeb/getInfo/issues)
Kyodev's avatar
Kyodev committed
199

kyodev's avatar
kyodev committed
200
IRC: ##sdeb@freenode.net
Kyodev's avatar
Kyodev committed
201 202 203 204


## license

kyodev's avatar
kyodev committed
205 206
* pour le code original: [LPRAB/WTFPL](https://framagit.org/sdeb/getInfo/blob/master/LICENSE.md)
* pour les parties de codes incluses, se référer aux licenses spécifiques indiquées dans le fichier   [LICENCE](https://framagit.org/sdeb/getInfo/blob/master/LICENSE.mdd)
Kyodev's avatar
Kyodev committed
207 208 209

## remerciements

Kyodev's avatar
Kyodev committed
210
* [kernel.org](https://www.kernel.org/) pour les tags cpu, et les modules à détecter
Kyodev's avatar
Kyodev committed
211 212
* [neofetch](https://github.com/dylanaraps/neofetch) pour du code sur la détection système.   
  neofetch est un successeur dynamique de screenfetch avec du code sympa 
Kyodev's avatar
Kyodev committed
213
* [inxi](* https://github.com/smxi/inxi) pour un longue lecture du code
Kyodev's avatar
Kyodev committed
214
* [pastery.net](https://www.pastery.net/) pour héberger des pastebins avec rendu markdown
kyodev's avatar
kyodev committed
215 216 217


![compteur](https://framaclic.org/h/getinfo-gif)