====== Bash : Les opérateurs de test sur fichiers ======

  * Objet : Suite de la série de wiki visant à maîtriser bash via les caractères.
  * Niveau requis : {{tag>débutant avisé}}
  * Commentaires : Bash, ligne de commande et scripts
  * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-)
  * Suivi : {{tag>en-chantier à-tester à-placer}}
    * Création par [[user>agp91]] 20/02/2023
    * Testé par <...> le <...> FIXME
  * Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?pid=393484#p393484| Lien vers le forum concernant ce tuto]] ((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))

  * [[doc:programmation:shells:bash-les-differents-caracteres-speciaux|Vision d'ensemble]]
  * [[doc:programmation:shells:la-page-man-bash-les-caracteres-speciaux|Détail et caractères]]
  * [[atelier:chantier:bash:les-operateurs-sur-parametres|Les opérateurs de test sur paramètres]]
  * [[doc:programmation:shells:la-page-man-bash-ii-les-operateurs-lexicographiques|Les opérateurs de test sur chaînes]]
  * **Les opérateur de test sur fichiers** ;-)
  * [[doc:programmation:shells:page-man-bash-iii-les-operateurs-de-comparaison-numerique|Les opérateurs de comparaison numérique]]
  * [[doc:programmation:shells:page-man-bash-iv-symboles-dans-les-calculs-mathematiques|Les symboles dans les calculs]] 
  * [[doc:programmation:shells:page-man-bash-v-les-tableaux|Bash : les tableaux]] 
  * [[doc:programmation:shells:man-bash-vi-les-caracteres-de-transformation-de-parametres|Les caractères de transformation de parametres]]
  * [[doc:programmation:shells:bash-vii-globs-etendus-regex|Bash : Variables, globs étendus, ERb, ERe]]

**Nota :**

Contributeurs, les FIXME sont là pour vous aider, supprimez-les une fois le problème corrigé ou le champ rempli !

===== Introduction =====

<note>
Dans la page du manuel de bash, **les opérateurs des commandes de test** sont nommées __**primitives**__.
</note>

Bash dispose de plusieurs commandes pour **réaliser des tests sur des fichiers**.

  * Les commandes internes **[** et **test**.
  * Et la commande composée **<nowiki>[[</nowiki>**.
<note>
  * Les commandes **[** et **test** sont équivalentes.
  * Les commandes **[** et **test** sont disponibles dans leurs versions externe : **/usr/bin/[** et **/usr/bin/test**.
    * Elles ont toutes les deux la même page de manuel (**man [** ou **man test**).
  * Les commandes internes disposent de primitive que n'ont pas les commandes externes.
</note>

<note>
__Rappels :__

  *  Une commande de test renvoie le code de retour 0 (considérer comme vrai) lorsque le test réussi et 1 (considérer comme faux) lorsqu'il échoue.
  *  Le code retour d'une commande est mémorisé dans le paramètre spécial $?.
  *  L'opérateur de contrôle **&&** exécute la commande suivante, si la commande précédente à renvoyée un code de retour égale à 0.
  *  L'opérateur de contrôle **||** exécute la commande suivante, si la commande précédente à renvoyée un code de retour supérieur à 0.
</note>

Les commandes de test disposent de 24 primitives ( 21 unaires et 3 binaires) pour tester les fichiers.

===== Synopsis =====

  * **test OP fichier**
  * **[ OP fichier ]**
  * **<nowiki>[[</nowiki> OP fichier <nowiki>]]</nowiki>**

  * **test fichier1 OP fichier2**
  * **[ fichier1 OP fichier2 ]**
  * **<nowiki>[[</nowiki> fichier1 OP fichier <nowiki>]]</nowiki>**

  * Avec :
    * **Fichier**, **fichier1** et **fichier2** sont des chemins de fichier. Ils sont sujet aux développements.
    * **OP**, l'une des primitives suivante :

|  Liste des primitives de test sur les fichiers  ||
^ Primitives			^ Retours													^
| **-a fichier**		| Vrai si **fichier** existe.											|
| **-b fichier**		| Vrai si **fichier** est un fichier spécial bloc.								|
| **-c fichier**		| Vrai si **fichier** est un fichier spécial caractère.								|
| **-d fichier**		| Vrai si **fichier** existe et est un répertoire.								|
| **-e fichier**		| Vrai si **fichier** existe.											|
| **-f fichier**		| Vrai si **fichier** est un fichier normal.									|
| **-g fichier**		| Vrai si **fichier** a son bit Set-GID positionné.								|
| **-h fichier**		| Vrai si **fichier** est un lien symbolique.									|
| **-k fichier**		| Vrai si **fichier** a son bit « sticky » positionné.								|
| **-p fichier**		| Vrai si **fichier** est un tube nommé (FIFO).									|
| **-r fichier**		| Vrai si **fichier** est accessible en lecture.								|
| **-s fichier**		| Vrai si **fichier** a une taille strictement positive.							|
| **-t df**			| Vrai si le descripteur de fichier **df** est ouvert et se rapporte à un terminal.				|
| **-u fichier**		| Vrai si **fichier** a son bit Set-UID positionné.								|
| **-w fichier**		| Vrai si **fichier** est accessible en écriture.								|
| **-x fichier**		| Vrai si **fichier** est exécutable.										|
| **-G fichier**		| Vrai si **fichier** appartient au GID effectif du groupe.							|
| **-L fichier**		| Vrai si **fichier** est un lien symbolique.									|
| **-N fichier**		| Vrai si **fichier** a été modifié depuis sa dernière lecture.							|
| **-O fichier**		| Vrai si **fichier** appartient à l'UID effectif de l'utilisateur.						|
| **-S fichier**		| Vrai si **fichier** est une socket.										|
| **fichier1 -ef fichier2**	| Vrai si **fichier1 **et **fichier2** se rapportent au même périphérique et ont les mêmes numéros d'inœuds.	|
| **fichier1 -nt fichier2**	| Vrai si **fichier1** est plus récent que **fichier2** ou si **fichier1** existe et non **fichier2**.		|
| **fichier1 -ot fichier2**	| Vrai si **fichier1** est plus ancien que **fichier2** ou si **fichier2** existe et non **fichier1**.		|

<note>
La primitive **-e** teste si le fichier existe qu'il soit un fichier normal, spécial caractère, spécial bloc, un répertoire, un lien symbolique ou une socket.
</note>

===== Exemples =====

Testons si le fichier **/tmp/too** existe.

<code user>
touch /tmp/toto				# Crée le fichier /tmp/toto.

test -f /tmp/toto	; echo $?	# Test si le fichier /tmp/toto est un fichier.
[ -d /tmp/toto ]	; echo $?	# Test si le fichier /tmp/toto est un répertoire.

rm -v /tmp/toto				# Supprime le fichier /tmp/toto.
test -f /tmp/toto	; echo $?	# Test si le fichier existe.
</code><file>
0
1
0
'/tmp/toto' supprimé
</file>

Testons le développement du ~ (tilde) avec le fichier **~/toto**.\\ 
En copiant le code ci-dessous, dans le fichier **mon_script**.\\ 
Puis exécutons le, avant de le supprimer.

<code bash script>
#!/bin/bash
var1="~/toto"
touch $var1

if [ -f "$var1" ]
then
  echo "Le fichier existe !"
else
  echo "Fichier non trouvé ! Car il n'y a pas de développement du ~ entre guillemets (simples ou doubles)."
fi

var1=~/toto	# Sans guillemets, le ~ est développé.
if [ -f "$var1" ]
then
  echo "Le fichier existe ! (Sans guillemets, le développement du ~ c'est réalisé)."
else
  echo "Fichier inexistant !"
fi

rm ~/toto
</code><code user>
bash mon_script

rm -v mon_script
</code><file>
Fichier non trouvé ! Car il n'y a pas de développement du ~ entre guillemets (simples ou doubles).
Le fichier existe ! (Sans guillemets, le développement du ~ c'est réalisé).
'mon_script' supprimé
</file>

Testons ce qu'est  **/dev/null**.

<code>
f=/dev/null
ok="$f est"
ko="$f n'est pas"

test -e $f	&& echo "$f existe."		|| echo "$f n'existe pas."
[ -r $f	]	&& echo "$ok en lecture."	|| echo "$ko en lecture"
[[ -w $f ]]	&& echo "$ok en écriture."	|| echo "$ko en ecriture."		
[ -x $f ]	&& echo "$ok exécutable."	|| echo "$ko exécutable."
ok="$ok un"
ko="$ko un"
[ -d $f ]	&& echo "$ok répertoire."	|| echo "$ko répertoire."
[ -h $f ]	&& echo "$ok lien."		|| echo "$ko lien symbolique."
[ -S $f	]	&& echo "$ok socket."		|| echo "$ko socket."
ok="$ok fichier"
ko="$ko fichier"
[ -f $f ]	&& echo "$ok normal."		|| echo "$ko normal."
[ -b $f	]	&& echo "$ok spécial bloc."	|| echo "$ko spécial bloc."
[ -c $f ]	&& echo "$ok spécial caractère."|| echo "$ko spécial caractère."

unset f ok ko
</code><file>
/dev/null existe.
/dev/null est en lecture.
/dev/null est en écriture.
/dev/null n'est pas exécutable.
/dev/null n'est pas un répertoire.
/dev/null n'est pas un lien symbolique.
/dev/null n'est pas un socket.
/dev/null n'est pas un fichier normal.
/dev/null n'est pas un fichier spécial bloc.
/dev/null est un fichier spécial caractère.
</file>

> Et oui **/dev/null** est un fichier spécial caractère, accessible en lecture et en écriture.
> Certains le nomme le puits ou encore le trou (noir)... Mais "devnull" lui va si bien ;)
> En tout cas, tous ce qui y va, n'en ressort plus et est perdu à jamais.

Et voilà ! 8-)

===== Tuto précédent =====

[[doc:programmation:shells:la-page-man-bash-ii-les-operateurs-lexicographiques|Les opérateurs de test sur chaînes]]

===== La suite c'est ici =====

[[doc:programmation:shells:page-man-bash-iii-les-operateurs-de-comparaison-numerique|Les opérateurs de comparaison numérique]]