kyopages/docs/scripts/getFlashPlayer.md

# getFlashPlayer

> c'est un script bash qui télécharge et installe le plugin FlashPlayer pour Firefox, pour l'utilisateur en cours

> le script se met à jour et gère les mises à jour de FlashPlayer par une tâche planifiée hebdomadaire

> seul l'installation et la désinstallation du **script** requièrent les privilèges **root**.   
les autres opérations se font sous le compte utilisateur, comme l'installation/suppression du plugin 
se font par chaque utilisateur


## installation rapide du script

**en root**, pour l'installation:
```shell
wget -O getFlashPlayer https://framagit.org/kyodev/kyopages/raw/master/scripts/getFlashPlayer
chmod +x getFlashPlayer && ./getFlashPlayer
```
```text
                _   _____ _           _     ____  _                       
      __ _  ___| |_|  ___| | __ _ ___| |__ |  _ \| | __ _ _   _  ___ _ __ 
     / _' |/ _ \ __| |_  | |/ _' / __| '_ \| |_) | |/ _' | | | |/ _ \ '__|
    | (_| |  __/ |_|  _| | | (_| \__ \ | | |  __/| | (_| | |_| |  __/ |   
     \__, |\___|\__|_|   |_|\__,_|___/_| |_|_|   |_|\__,_|\__, |\___|_|   
     |___/                                                |___/           
         pour Firefox, version 3.18.0 - 5/12/2017

  getFlashPlayer 3.13.0 installé dans le système.
  maintenant, appel du script par: getFlashPlayer (sans ./)

```

* le script est maintenant dans le système et tout utilisateur peut s'en servir.
* **le plugin n'est pas encore installé**
* le script est inscrit dans la crontab utilisateur, une mise à jour du plugin et du script sera faite
  périodiquement si disponible (pas de téléchargement d'archive en aveugle).
* si le paquet `flashplugin-nonfree` est présent, il sera **désinstallé**.  


## installation plugin

```shell
getFlashPlayer install
```
```text
                _   _____ _           _     ____  _                       
      __ _  ___| |_|  ___| | __ _ ___| |__ |  _ \| | __ _ _   _  ___ _ __ 
     / _' |/ _ \ __| |_  | |/ _' / __| '_ \| |_) | |/ _' | | | |/ _ \ '__|
    | (_| |  __/ |_|  _| | | (_| \__ \ | | |  __/| | (_| | |_| |  __/ |   
     \__, |\___|\__|_|   |_|\__,_|___/_| |_|_|   |_|\__,_|\__, |\___|_|   
     |___/                                                |___/           
         pour Firefox, version 3.18.0 - 5/12/2017

  FlashPlayer n'est pas libre, c'est un programme propriétaire dont on
  ne peut pas connaître le code source, ni l'utiliser sans conditions,
  ni le distribuer librement.
  Il souffre de nombreuses vulnérabilités chroniques, depuis des années...
  Il sera bloqué plus ou moins bloqué à terme pas les navigateurs majeurs,
  c'est à dire Firefox et Chrom(ium). Préparez vous à cela...
  voir: https://developer.mozilla.org/fr/docs/Plugins/Roadmap

  FlashPlayer non installé

  installation FlashPlayer, version 26.0.0.151

/tmp/getFlashPlayer-19554/flash_pl 100%[======================================>]   8,10M  1,69MB/s    in 4,8s    
  
  FlashPlayer 26.0.0.151 installé pour kyodev
  	Pour tester: http://get.adobe.com/flashplayer/about/

```

* FlashPlayer est installé, en étant directement chargé du site Adobe
* lancer le script pour chaque utilisateur ayant ouvert une session
* **seule la bibliothèque** est installée comme plugin Firefox. FlashPlayer pourra être configuré
  au clic droit dans le navigateur. le **système n'est pas encombré inutilement** 
* pour vérifier le bon fonctionnement, vous pouvez aller [sur le site](http://get.adobe.com/flashplayer/about/)
* _théoriquement_, inutile de redémarrer Firefox
* en cas de soucis, vérifier dans `Outils/Modules complémentaires/plugins`: _shockwave flash_ doit être **activé**
* le téléchargement et la mise à jour sont **forcés**


## messages avertissement

<hr>
```text
  l'installation du script est obsolète (-1)
  veuillez réinstaller le script manuellement
  voir https://kyodev.frama.io/kyopages/scripts/getFlashPlayer/#messages-avertissement 
```
ce message indique qu'une installation obsolète a été détectée. 
[Réinstaller ce script manuellement](#installation-rapide-du-script)
(pour avoir les droits **root**).

* code erreur -1: une version de développement à laissé des droits inappropriés sur le script. une réinstallation 
  sous droits **root** est nécessaire 
* code erreur -2: le script s'appuie sur _rsyslog_ pas toujours disponible sur les systèmes. une réinstallation 
  sous droits **root** est nécessaire pour utiliser un fichier de log spécifique (_/var/log/sdeb_getFirefox.log_) 

<hr>


## help

lancer le script sans arguments: `getFlashPlayer` ou avec l'option `getFlashPlayer -h`
```text
                _   _____ _           _     ____  _                       
      __ _  ___| |_|  ___| | __ _ ___| |__ |  _ \| | __ _ _   _  ___ _ __ 
     / _' |/ _ \ __| |_  | |/ _' / __| '_ \| |_) | |/ _' | | | |/ _ \ '__|
    | (_| |  __/ |_|  _| | | (_| \__ \ | | |  __/| | (_| | |_| |  __/ |   
     \__, |\___|\__|_|   |_|\__,_|___/_| |_|_|   |_|\__,_|\__, |\___|_|   
     |___/                                                |___/           
         pour Firefox, version 3.18.0 - 5/12/2017

  -----------------------------------------------------------------------
  getFlashPlayer install :  téléchargement & installation de FlashPlashplayer
  getFlashPlayer remove  :  désinstallation de FlashPlayer
  getFlashPlayer version :  version en ligne de FlashPlayer et du script
  getFlashPlayer upgrade :  mise à jour plugin si disponible
  ----
  getFlashPlayer manuel fichier.tar.gz : installation manuelle d'une archive
  ----
  ./getFlashPlayer                       : installation du script dans le système
  getFlashPlayer -h, --help              : affichage aide
  getFlashPlayer -r, --remove, sysremove : désinstallation du script du système
  getFlashPlayer -u, --upgrade           : mise à jour script & plugin, cron hebdomadaire
  getFlashPlayer -v, --version           : versions du script
  -----------------------------------------------------------------------
  Ce script doit être exécuté avec les droits root uniquement pour 
  l'installation et la suppression du script dans le système. 
  SEUL le plugin sera installé comme plugin Firefox, par tout utilisateur,
  sans droits root requis.
  -----------------------------------------------------------------------
  plus d'infos:  https://kyodev.frama.io/kyopages/scripts/getFlashPlayer/

  FlashPlayer n'est pas libre, c'est un programme propriétaire dont on
  ne peut pas connaître le code source, ni l'utiliser sans conditions,
  ni le distribuer librement.
  Il souffre de nombreuses vulnérabilités chroniques, depuis des années...
  Il sera bloqué plus ou moins bloqué à terme pas les navigateurs majeurs,
  c'est à dire Firefox et Chrom(ium). Préparez vous à cela...
  voir: https://developer.mozilla.org/fr/docs/Plugins/Roadmap

```


## version

```shell
getFlashPlayer version
```
```text
                _   _____ _           _     ____  _                       
      __ _  ___| |_|  ___| | __ _ ___| |__ |  _ \| | __ _ _   _  ___ _ __ 
     / _' |/ _ \ __| |_  | |/ _' / __| '_ \| |_) | |/ _' | | | |/ _ \ '__|
    | (_| |  __/ |_|  _| | | (_| \__ \ | | |  __/| | (_| | |_| |  __/ |   
     \__, |\___|\__|_|   |_|\__,_|___/_| |_|_|   |_|\__,_|\__, |\___|_|   
     |___/                                                |___/           
         pour Firefox, version 3.18.0b - 5/12/2017

  version FlashPlayer en ligne: 27.0.0.187

  FlashPlayer à jour

  version script en cours: 3.18.0b
  version script en ligne: 3.18.0, mise à jour possible

```

* affiche la version en ligne de FlashPlayer
* affiche la version en ligne du script
* compare avec les versions installées


## désinstallation plugin

```shell
getFlashPlayer remove
```
```text
                _   _____ _           _     ____  _                       
      __ _  ___| |_|  ___| | __ _ ___| |__ |  _ \| | __ _ _   _  ___ _ __ 
     / _' |/ _ \ __| |_  | |/ _' / __| '_ \| |_) | |/ _' | | | |/ _ \ '__|
    | (_| |  __/ |_|  _| | | (_| \__ \ | | |  __/| | (_| | |_| |  __/ |   
     \__, |\___|\__|_|   |_|\__,_|___/_| |_|_|   |_|\__,_|\__, |\___|_|   
     |___/                                                |___/           
         pour Firefox, version 3.18.0 - 5/12/2017

   FlashPlayer 26.0.0.151 désinstallé pour kyodev

```

* le plugin est effacé du profil Mozilla de l'utilisateur
* lancer le script pour chaque utilisateur ayant installé le plugin
* cela **ne supprime pas le script** _getFlashPlayer_ du système


## installation manuelle

* [charger manuellement](https://get.adobe.com/fr/flashplayer/) Flashplayer en choisissant une 
  archive linux tar.gz ou installer une archive tar.gz disponible hors-ligne
* lancer l'installation habituelle, avec:   

```shell
getFlashPlayer manuel flash_player_npapi_linux.x86_64.tar.gz
```
```text
                _   _____ _           _     ____  _                       
      __ _  ___| |_|  ___| | __ _ ___| |__ |  _ \| | __ _ _   _  ___ _ __ 
     / _' |/ _ \ __| |_  | |/ _' / __| '_ \| |_) | |/ _' | | | |/ _ \ '__|
    | (_| |  __/ |_|  _| | | (_| \__ \ | | |  __/| | (_| | |_| |  __/ |   
     \__, |\___|\__|_|   |_|\__,_|___/_| |_|_|   |_|\__,_|\__, |\___|_|   
     |___/                                                |___/           
         pour Firefox, version 3.18.0 - 5/12/2017

  FlashPlayer n'est pas libre, c'est un programme propriétaire dont on
  ne peut pas connaître le code source, ni l'utiliser sans conditions,
  ni le distribuer librement.
  Il souffre de nombreuses vulnérabilités chroniques, depuis des années...
  Il sera bloqué plus ou moins bloqué à terme pas les navigateurs majeurs,
  c'est à dire Firefox et Chrom(ium). Préparez vous à cela...
  voir: https://developer.mozilla.org/fr/docs/Plugins/Roadmap

  installation manuelle de flash_player_137_npapi_linux.i386.tar.gz

    - décompression...

  FlashPlayer 26.0.0.137 installé pour kyodev
  	Pour tester: http://get.adobe.com/flashplayer/about/

```


## mise à jour plugin

```shell
getFlashPlayer upgrade
```
```text
                _   _____ _           _     ____  _                       
      __ _  ___| |_|  ___| | __ _ ___| |__ |  _ \| | __ _ _   _  ___ _ __ 
     / _' |/ _ \ __| |_  | |/ _' / __| '_ \| |_) | |/ _' | | | |/ _ \ '__|
    | (_| |  __/ |_|  _| | | (_| \__ \ | | |  __/| | (_| | |_| |  __/ |   
     \__, |\___|\__|_|   |_|\__,_|___/_| |_|_|   |_|\__,_|\__, |\___|_|   
     |___/                                                |___/           
         pour Firefox, version 3.18.0 - 5/12/2017

  version FlashPlayer en ligne: 26.0.0.151

  version FlashPlayer installée: 26.0.0.137, mise à jour possible

  installation FlashPlayer, version 26.0.0.151

    - téléchargement...

/tmp/getFlashPlayer-25780/flash_play 100%[====================================>]   8,10M  3,91MB/s    in 2,1s    
    - décompression...

  FlashPlayer 26.0.0.151 installé pour kyodev
  	Pour tester: http://get.adobe.com/flashplayer/about/

```

* mise à jour du **plugin** si une nouvelle version est disponible en ligne
* pas de nouvelle version: pas de téléchargement


## mise à jour du script (et du plugin)

```shell
getFlashPlayer -u
```

* test toutes les **semaines**
* mise à jour du **script** si une nouvelle version est disponible en ligne
* mise à jour du **plugin** si une nouvelle version est disponible en ligne
* le script se mettra à jour même si le plugin n'est pas installé 
* cette tâche est exécutée périodiquement par cron/anachron et n'a pas vraiment vocation à être lancée manuellement
* _anacron_ est utilisé, c'est à dire que la mise à jour sera testée, même lors d'arrêts du Pc


## vérification

tous les évènements importants sont consignées dans le fichier _/var/log/sdeb_getFlashPlayer.log_   
consulter son contenu:
```shell
cat /var/log/sdeb_getFlashPlayer.log
```

pour vérifier la date où la dernière version du plugin a été installée ou _mise à jour_
`date -r ~/.mozilla/plugins/libflashplayer.so`    


## supprimer le script

en **root**:
```shell
getFlashPlayer -r
```
```text
                _   _____ _           _     ____  _                       
      __ _  ___| |_|  ___| | __ _ ___| |__ |  _ \| | __ _ _   _  ___ _ __ 
     / _' |/ _ \ __| |_  | |/ _' / __| '_ \| |_) | |/ _' | | | |/ _ \ '__|
    | (_| |  __/ |_|  _| | | (_| \__ \ | | |  __/| | (_| | |_| |  __/ |   
     \__, |\___|\__|_|   |_|\__,_|___/_| |_|_|   |_|\__,_|\__, |\___|_|   
     |___/                                                |___/           
         pour Firefox, version 3.18.0 - 5/12/2017

  getFlashPlayer 3.18.0 supprimé du système.

```

* effacement du script dans le système (_/opt/bin_)
* effacement de l'inscription dans crontab/anacron utilisateur
* cela ne **supprime pas** un éventuel **plugin** installé


## sources

sur [framagit](https://framagit.org/kyodev/kyopages/blob/master/scripts/getFlashPlayer)


## changelog

sur [framagit](https://framagit.org/kyodev/kyopages/blob/master/scripts/getFlashPlayer_changelog.md)


## contact

pour tout problème ou suggestion concernant ce script, n'hésitez pas à ouvrir une issue 
[Framagit](https://framagit.org/kyodev/kyopages/issues)

IRC freenode: ##sdeb


## license

[LPRAB/WTFPL](https://framagit.org/kyodev/kyopages/blob/master/scripts/LICENSE.md)