kyopages/docs/scripts/getIp.md

# getIp

> * script bash qui affiche les Ips publiques ou locales du PC
> * l'installation du script est possible en option. il se mettra alors éventuellement à jour automatiquement
> * l'option -us permet la mise à jour du script en place, sans installation et sans test ultérieur de 
    nouvelle version 
> * jusqu'à en trouver un, les utilitaires suivants seront utilisés: dig (dnsutils) / wget / curl / telnet / nc


## chargement du script:

```shell
wget -O getIp https://frama.link/getIp
chmod +x getIp
```

* liens de chargement alternatif `wget -O getIp https://framagit.org/kyodev/kyopages/raw/master/scripts/getIp`
 
 
## help
`./getIp -h` ou `getIp -h` (si installé)
```text
            _   ___       
  __ _  ___| |_|_ _|_ __  
 / _' |/ _ \ __|| || '_ \ 
| (_| |  __/ |_ | || |_) |
 \__, |\___|\__|___| .__/ 
 |___/             |_|    

  1.16.0 - 4/12/2017
  ----------------------------------------------------------------------
  ./getIp      : exécution normale
  getIp        : exécution normale si script installé dans le système

  ce script requiert une des commandes suivantes pour déterminer l'ip publique :
    dig (dnsutils) / wget / curl / telnet / nc

  options:
     -h, --help    : affichage aide
 
     -4, --ip4     : affiche ipv4 public
     -6, --ip6     : affiche ipv6 public

     -46 --public  : afiche ipv4 & ipv6 public
     '', --local   : affiche adresses mac / ip privées / passerelle

     -us           : upgrade spécial du script (pas de mise à jour auto, maj du script en place)

     -i, --install : installation du script dans le système
     -r, --remove  : suppression du script dans le système
     -u, --upgrade : upgrade script installé si maj possible
     -v, --version : version du script, en ligne et en cours d'exécution
  plus d'infos: https://frama.link/doc-getip

```


## IPs locales

`./getIp` ou `getIp` (si installé)
```text
            _   ___       
  __ _  ___| |_|_ _|_ __  
 / _' |/ _ \ __|| || '_ \ 
| (_| |  __/ |_ | || |_) |
 \__, |\___|\__|___| .__/ 
 |___/             |_|    

  1.16.0 - 4/12/2017

 ip locale(s):
  192.168.1.129/24 ( wlp1s0 ) (wifi)

 passerelle(s):
  192.168.1.5 ( wlp1s0 ) (wifi)

 adresse(s) Mac:
  enp3s0: 00:26:17:69:ec:c2 (ethernet)
  wlp1s0: 00:69:d3:43:de:42 (wifi)

```


## IP publiques

`./getIp -46` ou `getIp -46` (si installé)  
```text
185.126.105.135
2a01:e0c:8bd5:13b0:e8ef:5cdb:f9a8:d308
```
ou
```text
pas de connectivité ipv4
pas de connectivité ipv6
```

## IP publiques ipv4

`./getIp -4` ou `getIp -4` (si installé)  
```text
185.126.105.135
```
ou
```text
pas de connectivité ipv4
```


## IP publiques ipv6

`./getIp -6` ou `getIp -6` (si installé)  
```text
2a01:e0c:8bd5:13b0:e8ef:5cdb:f9a8:d308
```
ou
```text
pas de connectivité ipv6
```


## mise à jour sans installation

* `./getInfo -us` (update spécial), le script est mis à jour là où il est, sans installation pré-requise


## installation du script

* `./getIp -i` **droits root** requis. Installation du script dans le système. Le script téléchargé sera 
  effacé du répertoire courant. Le lancement se fera donc par `getIp`.
* `getIp -r` **droits root** requis. Suppression du script du système. 
* `getIp -u` Mise à jour du script. Cette opération est automatiquement lancée toutes les semaines 
  si le script est installé.
* `getIp -v` Affiche la version du script et la version en ligne.

Une fois installé, le script est accessible à tous les utilisateurs. Un test hebdomadaire est effectué et le
script est mis à jour si une nouvelle version est disponible.


## sources

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


## 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)