OPTIONS DE POSITION¶

Les options de position renvoient toujours vrai. Elles ne concernent que les tests qui apparaissent ensuite sur la ligne de commande.

-daystart

Mesurer les temps (avec -amin, -atime, -cmin, -ctime, -mmin, et -mtime) depuis le début de la journée plutôt que depuis 24 heures. Cette option n'affecte que les tests qui sont indiqués plus loin sur la ligne de commande.

-follow

Obsolète, utilisez plutôt l'option -L à la place. Déréférence les liens symboliques. Cela implique l'option -noleaf. L'option -follow n'affecte que les tests qui apparaissent après son apparition sur la ligne de commande. Sauf dans le cas où l'option -H ou -L est indiquée, la position de l'option -follow change le comportement du prédicat -newer, et tout fichier donné en paramètre de -newer sera déréférencé s'il s'agit d'un lien symbolique. La même remarque s'applique à -newerXY, -anewer et -cnewer. De la même façon, le prédicat -type correspondra toujours au type du fichier pointé par le lien symbolique plutôt qu’au lien lui-même. Les prédicats -lname et -ilname renvoient toujours faux lorsqu'on utilise -follow.

-regextype type

Changer la syntaxe de l'expression rationnelle des tests -regex et -iregex qui seront indiqués plus loin sur la ligne de commande. Pour voir les types d'expression rationnelle connus, utilisez -regextype help. La documentation de Texinfo (voir VOIR AUSSI) explique la signification et les différences entre les différents types d'expression rationnelle. Si vous n'utilisez pas cette option, find se comporte comme si le type d'expression rationnelle emacs avait été spécifié.

-warn, -nowarn

Activer ou désactiver les messages d'avertissement. Ces messages d'avertissement concernent l'usage de la ligne de commande et non les événements que find peut rencontrer lorsqu'il explore les répertoires. Le comportement par défaut est d'activer -warn si l'entrée standard est un tty et -nowarn dans les autres cas. Si un message d'avertissement est produit concernant l'utilisation de la ligne de commande, l’état de sortie de find n'est pas affecté. Si la variable d'environnement POSIXLY_CORRECT est définie et si -warn est utilisé, rien ne dit quels messages d'avertissement seront actifs s'il y en a.

OPTIONS GLOBALES¶

Les options globales renvoient toujours vrai. Les options globales prennent effet même pour les tests intervenant plus tôt sur la ligne de commande. Pour éviter toute confusion, les options globales devraient être spécifiées sur la ligne de commande après la liste des points de départ, juste avant le premier test, une option de position ou une action. Si vous spécifiez une option globale ailleurs, find produira un message d'avertissement pour dire que cela peut entraîner des confusions.

Les options globales interviennent après la liste des points de départ, elles sont d'un autre type que des options comme -L.

-d

Un synonyme de -depth, dans un but de compatibilité avec FreeBSD, NetBSD, MacOS X et OpenBSD.

-depth

Traiter d'abord les sous-répertoires avant le répertoire lui-même. L'action -delete implique aussi -depth.

-files0-from fichier

Lire les points de départ à partir de fichier au lieu de l'obtenir sur la ligne de commande. Contrairement aux limites connues de passer des points de départ au moyen d'arguments sur la ligne de commande, à savoir la limitation du nombre de noms de fichier, et l'ambiguïté inhérente de noms de fichiers en conflit avec des noms d'option, l'utilisation de cette option permet des passer sans risque un nombre arbitraire de points de départ à find.

Utiliser cette option et passer les points de départ en ligne de commande s'excluent mutuellement et cela n'est donc pas permis en même temps.

L'argument fichier est obligatoire. Il est possible d'utiliser -files0-from - pour lire la liste des points de départ à partir du flux de l'entrée standard, et par exemple d'un tube. Dans ce cas, les actions -ok et -okdir ne sont pas permises parce qu'elles interféreraient de façon évidente avec la lecture à partir de l'entrée standard afin d'obtenir une confirmation de l'utilisateur.

Les points de départ dans fichier doivent être séparés par des caractères ASCII NULL. Deux caractères NULL successifs, par exemple un point de départ avec un nom de fichier de longueur nulle ne sont pas permis et mèneront à une erreur de diagnostic suivie d'un code d'erreur différent de zéro.

Dans le cas où le fichier donné en argument est vide, find ne traite aucun point de départ et donc quittera immédiatement après l'analyse des arguments du programme. C'est différent de l'invocation standard où find considère le répertoire actuel comme point de départ si aucun argument de chemin n'est passé.

Sinon, le traitement des points de départ est comme d'habitude, par exemple find parcourra de façon récursive les sous-répertoires sauf indication contraire. Pour ne traiter que les points de départ, il est possible de passer l'argument -maxdepth 0 en plus.

Remarques supplémentaires : si un fichier est listé plus d'une fois dans le fichier d'entrée, il n'est pas précisé s'il est visité plus d'une fois. Si le fichier est déplacé pendant le fonctionnement de find, le résultat n'est pas précisé non plus. Enfin, la position de la recherche à l'intérieur du fichier nommé au moment où find quitte, que se soit avec la commande quit ou de n'importe quelle manière, n'est pas non plus précisée. Par « non précisé », on entend ici que cela peut fonctionner ou non, ou faire quelque chose de particulier et que le comportement peut changer d'une plateforme à l'autre ou selon la version de findutils.

-help, --help

Afficher un message d'aide concernant l'utilisation de find sur la sortie standard et quitter.

-ignore_readdir_race

Normalement, find affiche un message d'erreur quand il échoue lors de l'analyse d'un fichier. Si vous utilisez cette option et que le fichier est effacé entre le moment où find lit le nom du fichier dans le répertoire et celui où il essaye de l'analyser, vous n'obtiendrez aucun message d'erreur. Cela s'applique aussi aux fichiers et répertoires dont vous avez donné les noms sur la ligne de commande. Cette option prend effet dès le moment où la ligne de commande est lue, ce qui veut dire que vous ne pouvez pas rechercher sur une partie du système de fichiers avec cette option activée et sur une autre partie avec cette option désactivée (si vous devez faire cela, vous utiliserez plutôt deux commandes find, une avec l'option et l'autre sans).

De plus, find avec l'option -ignore_readdir_race ignorera les erreurs de l'action -delete si le fichier a disparu depuis la lecture du répertoire parent : il n'affichera pas d'erreur et le code de retour de l'action -delete sera vrai.

-maxdepth n

Descendre au plus à n niveaux de profondeur des répertoires (n étant un entier positif ou nul) sous le point de départ. -maxdepth 0 signifie de n'appliquer les tests et les actions qu'aux points de départ eux-mêmes.

-mindepth n

Ne pas appliquer les tests ou les actions à des niveaux de profondeur inférieurs à n (un entier non négatif). n est un entier positif ou nul. -mindepth 1 signifie que les tests et les actions s'appliquent à tous les fichiers sauf aux points de départ.

-mount

Ne pas parcourir les répertoires situés sur d'autres systèmes de fichiers. Il s'agit d'une alternative à l'option -xdev, assurant la compatibilité avec d'anciennes versions de find.

-noignore_readdir_race

Désactiver l'effet de -ignore_readdir_race.

-noleaf

Ne pas optimiser, en assumant que les répertoires contiennent deux sous-répertoires de moins que leur nombre de liens physiques. Cette option est nécessaire lorsque l'on parcourt des systèmes de fichiers ne suivant pas les conventions Unix concernant les liens de répertoires, comme les systèmes MS-DOS, les CD-ROM ou les points de montage de volumes AFS. Chaque répertoire sur un système de fichiers Unix dispose d'au moins deux liens physiques, son nom et « . ». De plus, chaque sous-répertoire a également un lien « .. » vers le répertoire parent (s'il existe). Quand find examine un répertoire, il sait qu'il y a deux sous-répertoires de moins que de liens vers le répertoire. Une fois qu'il a déclaré deux sous-répertoires de moins que le nombre de liens au répertoire, il sait que le reste des entrées dans le répertoire ne sont pas des répertoires. (Ces fichiers sont des feuilles ([NDT] « leaf ») dans l'arborescence des répertoires). S'il n'y a que les noms de fichiers à examiner, il n'a plus besoin de vérifier leur nature, ce qui entraîne une augmentation notable de la vitesse de traitement.

-version, --version

Afficher le numéro de version de find et quitter.

-xdev

Ne pas parcourir les répertoires situés sur d'autres systèmes de fichiers.

TESTS¶

Quelques tests (comme -newerXY et -samefile par exemple) permettent de comparer le fichier en cours d'examen et un fichier de référence indiqué sur la ligne de commande. Quand ces tests sont utilisés, l'analyse du fichier de référence est soumis aux effets des options -H, -L, -P et tout -follow précédent. Par contre, ce fichier de référence n'est consulté qu'une fois, au moment où la ligne de commande est interprétée. Si ce fichier de référence ne peut pas être analysé (par exemple si l'appel système stat(2) échoue), un message d'erreur sera généré et la commande find s'interrompra avec un statut différent de zéro.

Un paramètre numérique n peut être passé aux tests (comme -amin, -mtime, -gid, -inum, -links, -size, -uid et -used) ainsi

+n

supérieur à n,

-n

inférieur à n,

n

strictement égal à n.

Tests pris en charge :

-amin n

Dernier accès au fichier il y a plus de, moins de ou précisément n minutes.

-anewer référence

La date du dernier accès au fichier actuel est plus récente que la dernière modification du fichier référence. Si référence est un lien symbolique et que les options -H ou -L sont actives, c'est toujours la date de dernière modification du fichier pointé qui est utilisée.

-atime n

Dernier accès au fichier il y a plus de, moins de ou précisément n*24 heures. Lorsque find calcule le nombre de périodes de 24 heures depuis lequel il y a eu un accès au fichier, la partie fractionnelle est ignorée. Ainsi, pour correspondre à -atime +1, il faut qu'un accès au fichier ait eu lieu il y a au moins deux jours.

-cmin n

Date de dernière modification de l’état du fichier il y a plus de, moins de ou précisément n minutes.

-cnewer référence

La date de dernière modification de l’état du fichier est plus récente que la date de dernière modification du fichier référence donné. Si le fichier référence donné est un lien symbolique et que les options -H ou -L sont actives, alors c'est la date de dernière modification de l’état du fichier pointé par le lien qui est considérée.

-ctime n

Date de dernière modification de l'état du fichier il y a plus de, moins de ou précisément n*24 heures. Consultez l'explication concernant -atime pour comprendre comment l’effet d'arrondi altère l'interprétation de la date de dernière modification de l'état du fichier.

-empty

Fichier vide. De plus, ce fichier doit être un fichier normal ou un répertoire.

-executable

Correspond aux fichiers qui sont exécutables et aux répertoires qui sont accessibles (en ce qui concerne la résolution d'un nom de fichier). Les listes de contrôles d'accès (ACL) et autres artefacts de permissions sont pris en compte, à l'inverse du test -perm qui, lui, les ignore. Ce test utilise l'appel système access(2) et peut de ce fait être trompé par les serveurs NFS qui font de la substitution d'identité (ou du root squashing). En effet, de nombreux systèmes implémentent access(2) au niveau du client et ne peuvent donc se servir des substitutions d'identité gérées du coté serveur. Puisque ce test n'est basé que sur le résultat fourni par l'appel système access(2), il n'y a aucune garantie qu'un fichier trouvé par ce test soit réellement exécutable.

-false

Toujours faux.

-fstype type

Fichier se trouvant sur un système de fichiers du type indiqué. Les types autorisés de systèmes de fichiers dépendent de la version d'Unix. Une liste non exhaustive des systèmes acceptés sur certaines versions d'Unix sont : ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K. Vous pouvez utiliser -printf avec la directive %F pour examiner les types de vos systèmes de fichiers.

-gid n

Fichier dont le GID numérique vaut plus de, moins de ou précisément n.

-group nom_groupe

Fichier appartenant au groupe nom_groupe (éventuellement un identifiant numérique).

-ilname motif

Semblable à -lname, mais sans différencier les majuscules et les minuscules. Si les options -L ou -follow sont actives, ce test renvoie toujours faux, à moins que le lien symbolique ne soit cassé.

-iname motif

Semblable à -name, mais sans différencier les majuscules et les minuscules. Par exemple les motifs « to* » et « T??? » correspondent aux noms de fichiers « Toto », « TOTO », « toto », « tOto », etc. Le motif « toto » correspond aussi à un fichier nommé « totobidule ».

-inum n

Fichier dont le numéro d'inœud est inférieur à, supérieur à ou égal à n. Il est en général plus facile d'utiliser le test -samefile.

-ipath motif

Semblable à -path, mais sans différencier les capitales et les minuscules.

-iregex motif

Semblable à -regex, mais sans différencier les capitales et les minuscules.

-iwholename motif

Voir -ipath. Cette option est moins portable que -ipath.

-links n

Fichier ayant moins de, plus de ou précisément n liens physiques.

-lname motif

Fichier représentant un lien symbolique, dont le contenu correspond au motif indiqué. Lors du développement des métacaractères, « / » et « . » ne sont pas traités différemment des autres caractères. Si les options -L ou -follow sont actives, ce test renvoie faux, sauf si le lien symbolique est cassé.

-mmin n

Fichier dont les données ont été modifiées il y a plus de, moins de ou précisément n minutes.

-mtime n

Fichier dont les données ont été modifiées il y a moins de, plus de ou précisément n*24 heures. Consultez l'explication sur -atime pour comprendre comment les arrondis affectent l'interprétation des dates de modification des fichiers.

-name motif

Fichier dont le nom de base (chemin sans les répertoires parents) correspond au motif de l'interpréteur de commande. Les répertoires parents des noms de fichier étant supprimés, le motif ne doit pas inclure de barre oblique parce que « -name a/b » ne trouvera rien (vous devrez probablement utiliser plutôt -path). Une exception à l'utilisation de la barre oblique dans motif (« -name / ») est la recherche du répertoire racine, car cela est une chaine valable pour correspondre au répertoire racine « / » (car le nom de base de « / » est « / »). Un avertissement apparaît si vous essayez de passer un motif contenant une barre oblique, mais ne consistant pas en une seule barre oblique, sauf si la variable d'environnement POSIXLY_CORRECT est définie ou si l'option -nowarn est utilisée.

Pour ignorer un répertoire, ainsi que tous ses fichiers, utilisez l'option -prune plutôt que de vérifier chaque fichier de l’arbre (vous trouverez un exemple dans la description de cette action). Les parenthèses ne sont pas considérées comme des caractères spéciaux, bien que certains interpréteurs de commandes (dont le Bash) attribuent aux parenthèses un rôle particulier. La correspondance avec le nom du fichier est obtenue par l'utilisation de la fonction fnmatch(3) de la bibliothèque. N'oubliez pas de protéger votre motif avec des guillemets afin d'éviter le développement des métacaractères par l'interpréteur de commandes.

-newer référence

La date de la dernière modification du fichier courant est plus récente que celle du fichier référence indiqué. Si le fichier référence est un lien symbolique et que les options -H ou -L sont actives, c'est la date de modification du fichier pointé qui sera considérée.

-newerXY référence

Réussit si l'horodatage X d'un fichier est plus récent que celui Y d'un fichier référence. Les lettres X et Y peuvent être une des suivantes :

a	La date et l'heure de dernier accès au fichier référence
B	La date et l'heure de création du fichier référence
c	La date et l'heure de changement d'état de l'inœud référence
m	La date et l'heure de dernière modification du fichier référence
t	référence est directement interprétée en tant qu'heure

Certaines combinaisons ne sont pas valables, comme X utilisé avec t. Certaines combinaisons ne sont pas implémentées sur certains systèmes, comme B qui n'est pas pris en charge par tous les systèmes. Une erreur fatale sera renvoyée si une combinaison non valable ou non implémentée de XY est appelée. Les dates et heures sont interprétées comme les arguments de l'option -d de la commande date de GNU. Si vous essayez d'utiliser la date de création d'un fichier et que cette date de création ne peut pas être déterminée, vous obtiendrez un message d'erreur fatale. Si vous spécifiez un test qui se réfère à la date de création des fichiers à examiner, ce test échouera pour chaque fichier pour lequel la date de création est inconnue.

-nogroup

Fichier dont l'identifiant de groupe numérique ne correspond à aucun groupe d'utilisateurs.

-nouser

Fichier dont l'UID numérique ne correspond à aucun utilisateur.

-path motif

Fichier dont le nom correspond au motif motif. Les métacaractères « / » ou « . » ne sont pas interprétés, d'où, par exemple,

find . -path "./sr*sc"

affichera une entrée pour un répertoire nommé ./src/misc (s'il en existe un). Pour ignorer toute une arborescence, utilisez -prune au lieu de vérifier chaque fichier d'une arborescence. Remarquez que le test de correspondance de motif s'applique à tout le nom du fichier en commençant par un des points de départ désigné sur la ligne de commande. Ici, utiliser un chemin absolu n'aurait de sens que si le point de départ en question est aussi un chemin absolu. Cela veut dire que cette commande ne correspondra jamais :

find bidule -path /truc/bidule/monFichier -print

find compare l'argument -path à la concaténation du nom du répertoire et le nom de base du fichier en cours d'examen. La concaténation ne se terminant jamais par une barre oblique, les arguments -path qui se terminent par ce signe ne trouveront rien (sauf peut-être un point de départ spécifié sur la ligne de commande). Le prédicat -path est également pris en charge par HP-UX find et fait partie du standard POSIX 2008.

-perm mode

Fichier dont les bits d'autorisations sont fixés exactement au mode indiqué (en notation symbolique ou octale). Puisqu'une correspondance stricte est requise, si vous voulez utiliser cette forme de modes symboliques, vous risquez d'être obligé d'utiliser une chaîne de caractères plutôt compliquée. Par exemple, -perm g=w ne recherchera que les fichiers qui ont le mode 0020 (c'est-à-dire, ceux pour lesquels la permission d'écriture pour le groupe est la seule permission définie). Vous voudrez plus certainement utiliser les formes « / » ou « - », telles que -perm -g=w, qui correspondent à tous les fichiers qui ont le droit d'écriture pour les groupes. Consultez la section EXEMPLES pour des exemples plus significatifs.

-perm -mode

Fichier ayant tous les bits d'autorisations indiqués dans le mode. Les notations symboliques sont acceptées dans ce cas, et c'est en général comme cela que l'on veut s'en servir. Vous devez indiquer « u », « g » ou « o » si vous utilisez un mode symbolique. Consultez la section EXEMPLES pour des exemples plus significatifs.

-perm /mode

Fichier ayant certains des bits d'autorisations indiqués dans le mode. La notation symbolique est acceptée dans ce cas. Vous devez indiquer « u », « g » ou « o » si vous utilisez un mode symbolique. Consultez la section EXEMPLES pour des exemples plus significatifs. Si aucun bit d'autorisation n'est indiqué dans mode, cela correspond à tous les fichiers (l'objectif est d'être cohérent avec le comportement de perm -000).

-perm +mode

Cela n'est plus pris en charge (et obsolète depuis 2005). Utilisez plutôt -perm /mode.

-readable

Correspond aux fichiers qui sont accessibles en lecture par l'utilisateur actuel. Les listes de contrôle d'accès (ACL) et les autres artefacts de permissions sont pris en compte, à l'inverse du test -perm qui, lui, les ignore. Ce test utilise l'appel système access(2), et peut, de ce fait, être trompé par les serveurs NFS qui font de la substitution d'identité (UID mapping ou root squashing). En effet, de nombreux systèmes implémentent access(2) au niveau du client et ne peuvent donc pas se servir des substitutions d'identités gérées du coté serveur.

-regex motif

Nom de fichier correspondant à l'expression rationnelle motif. Il s'agit d'une correspondance sur le chemin complet, pas d'une recherche. Par exemple, pour mettre en correspondance un fichier nommé « ./fubar3 », vous pouvez utiliser les expressions rationnelles « .*bar. » ou « .*b.*3 », mais pas « f.*r3 ». Les expressions rationnelles comprises par find sont, par défaut, celles d'Emacs, mais cela peut être changé avec l'option -regextype.

-samefile nom

Fichier qui se réfère au même inœud que nom. Quand -L est actif, cela inclut les liens symboliques.

-size n[cwbkMG]

Fichier utilisant moins de, plus de ou précisément n unités d'espace arrondi au nombre supérieur. On pourra utiliser les suffixes suivants :

La taille est simplement le membre st_size de struct stat remplie par l'appel système lstat (ou stat), arrondie à l'unité supérieure comme décrit ci-dessus. En d'autres termes, il est cohérent avec le résultat de ls -l. Souvenez-vous que les spécificateurs de format « %k » et « %b » de -printf gèrent différemment les fichiers creux. Le suffixe « b » décompte toujours des blocs de 512 octets, jamais de 1024 octets, contrairement au comportement de -ls.

Les préfixes + et - signifient, comme d'habitude, plus grand que et plus petit que ; ainsi une taille exacte de n unités ne correspond pas. Retenez que la taille est arrondie à l'unité supérieure. Donc -size -1M n'équivaut pas à -size -1048576c. Le premier ne correspond qu'à des fichiers vides, le second à des fichiers pesant entre 0 et 1 048 575 octets.

-true

Toujours vrai.

-type c

Fichier du type c :

Pour rechercher plus d'un type à la fois, vous pouvez fournir une liste combinée de lettres de types séparées par une virgule « , » (extension GNU).

-uid n

Fichier dont l'identifiant utilisateur numérique vaut plus de, moins de ou précisément n.

-used n

Fichier dont le dernier accès date de plus de, moins de ou précisément n jours après la date de sa dernière modification.

-user utilisateur

Fichier appartenant à l'utilisateur indiqué (identifiant utilisateur numérique éventuellement).

-wholename motif

Voir -path. Cette option est moins portable que -path.

-writable

Correspond aux fichiers qui sont accessibles en écriture par l'utilisateur actuel. Les listes de contrôle d'accès (ACL) et les autres artefacts de permissions sont pris en compte, à l'inverse du test -perm qui, lui, les ignore. Ce test utilise l'appel système access(2) et peut, de ce fait, être trompé par les serveurs NFS qui font de la substitution d'identité (UID mapping ou root squashing), étant donné que de nombreux systèmes implémentent access(2) au niveau du noyau du client et ne peuvent donc se servir des substitutions d'identités gérées du côté serveur.

-xtype c

Semblable à -type sauf si le fichier est un lien symbolique. Pour les liens symboliques, si les options -H ou -P ont été spécifiées, le test est vrai si le fichier pointé par le lien est de type c ; si l'option -L a été spécifiée, le test est vrai si c vaut « l ». Autrement dit, pour les liens symboliques, -xtype vérifie le type des fichiers que l'option -type ne vérifie pas. Si un lien symbolique est cassé (parce que le sujet qu'il pointe n'existe pas ou que le lien pointe sur lui-même), alors -xtype se comportera comme -type.

-context motif

(SELinux seulement) le contexte de sécurité du fichier correspond au motif global.

ACTIONS¶

-delete

Effacer les fichiers ou les répertoires et renvoyer vrai si l'effacement a réussi. Si l'effacement échoue, un message d'erreur est envoyé et le code de retour de find sera différent de zéro (quand finalement il s'interrompt).

Attention : N'oubliez pas que find évalue la ligne de commande comme une expression. Aussi placer -delete en premier fera que find essaiera de détruire tout ce qu'il trouvera sous le point de départ spécifié.

L'utilisation de l'action -delete en ligne de commande active automatiquement l'option -depth. Comme à son tour -depth rend -prune inefficace, l'action -delete ne peut pas être combinée de façon utile avec -prune.

Souvent, l'utilisateur voudrait tester une recherche find en ligne de commande avec -print avant d'ajouter -delete à l'exécution réelle de la suppression. Pour éviter des résultats surprenants, il est habituellement préférable de ne pas oublier d'utiliser -depth explicitement pendant l'exécution préalable du test.

L'action -delete échouera aussi à supprimer un répertoire à moins qu'il ne soit vide.

Avec l'option -ignore_readdir_race, find ignorera les erreurs de l'action -delete si le fichier a disparu depuis que le répertoire parent a été lu : il n'affichera pas de diagnostic d'erreur, ne changera pas le code d'erreur à une valeur différente de zéro, et le code de retour de l'action -delete sera vrai.

-exec commande ;

Exécuter la commande ; vrai si le code de retour 0 est renvoyé. Tous les paramètres qui suivent find sont considérés comme des paramètres pour la ligne de commande, jusqu'à la rencontre d'un caractère « ; ». La chaîne « {} » est remplacée par le nom du fichier en cours de traitement, cela dans toutes ses occurrences sur la ligne de commande et pas seulement aux endroits où elle est isolée, comme c'est le cas avec d'autres versions de find. Ces deux chaînes peuvent avoir besoin d'être protégées du développement de la ligne de commande par l'interpréteur, en utilisant le caractère d'échappement (« \ ») ou une protection par des guillemets. Consultez la section EXEMPLES pour des exemples d'utilisation de l'option -exec. La commande indiquée est exécutée à chaque fois qu'un fichier correspond. La commande est exécutée depuis le répertoire de départ. Il existe d'inévitables problèmes de sécurité associés à l'usage de l'option -exec, c'est pourquoi vous devriez utiliser l'option -execdir à la place.

-exec commande {} +

Cette variante de l'option -exec exécute la commande spécifiée sur les fichiers sélectionnés, mais en ajoutant le nom de chaque fichier trouvé à la fin de la ligne de commande. Le nombre total d'invocations de la commande sera donc très inférieur au nombre de fichiers trouvés. La ligne de commande est construite à la manière de xargs. Une seule instance de « {} » est permise à l'intérieur de la commande et elle doit apparaître à la fin et immédiatement avant le « + » ; elle doit être échappée (avec un « \ ») ou entre guillemets pour la protéger d'une interprétation par les interpréteurs. La commande sera exécutée dans le répertoire de départ. Si une invocation avec la forme « + » renvoie une valeur différente de zéro comme code de retour, alors find renvoie un code de retour différent de zéro. Si find rencontre une erreur, cela peut parfois provoquer une fin immédiate, aussi certaines commandes en attente pourraient ne pas être exécutées. C'est pourquoi -exec ma_commande ... {} \+ -quit peut n'aboutir à aucune exécution de ma_commande. Cette variante de -exec renvoie toujours vrai.

-execdir commande ;

-execdir commande {} +

Semblable à -exec, sauf que la commande indiquée sera exécutée à partir du sous-répertoire contenant le fichier correspondant qui n'est normalement pas celui à partir duquel vous avez lancé find. Comme avec -exec, {} devrait être entouré de guillemets si find est appelé depuis un interpréteur. C'est une méthode bien plus fiable d'invocation de commande, puisqu'elle évite des conflits de résolution de chemins des fichiers trouvés. Comme pour l'option -exec, la forme de -execdir avec « + » construira une ligne de commande de telle sorte qu'elle pourra traiter plusieurs fichiers trouvés en une passe, mais chaque invocation de commande ne portera que sur une liste de fichiers issus d'un seul et même répertoire. Si vous utilisez cette option, veillez bien à ce que votre variable d'environnement PATH ne contienne pas une référence au répertoire courant « . », sinon un pirate pourrait lancer toutes les commandes qu'il souhaite en mettant un fichier au nom adéquat dans les répertoires où vous allez lancer un -execdir. De la même manière, évitez les références vides ou les noms de répertoires exprimés en relatif dans PATH. Si une invocation avec la forme « + » renvoie un état de sortie autre que zéro, find renvoie un état de sortie qui n'est pas zéro. Si find rencontre une erreur, il peut quitter immédiatement, donc des commandes en attente ne seront pas lancées. Le résultat de l'action varie selon que vous utilisez la variante + ou ; ; -execdir commande {} + renvoie toujours vrai alors que -execdir commande {} ; ne renvoie vrai que si commande renvoie 0.

-fls fichier

Vrai ; semblable à -ls, mais écrire dans le fichier comme le fait -fprint. Le fichier en sortie est toujours créé, même si le prédicat n'est jamais vérifié. Consultez la section NOMS DE FICHIERS PEU COURANTS pour obtenir des informations sur la gestion des caractères inhabituels dans les noms de fichier.

-fprint fichier

Vrai ; écrire le nom complet dans le fichier. Si fichier n'existe pas au démarrage de find, il est créé. S'il existe, il est écrasé. Les noms de fichier /dev/stdout et /dev/stderr sont traités de manière particulière, ils correspondent respectivement à la sortie standard et à la sortie d'erreurs. Le fichier de sortie est toujours créé, même si le prédicat n'est jamais vérifié. Consultez la section NOMS DE FICHIERS PEU COURANTS pour obtenir des informations sur la gestion des caractères inhabituels dans les noms de fichiers.

-fprint0 fichier

Vrai ; semblable à -print0, mais écrire dans le fichier comme le fait -fprint. Le fichier de sortie est toujours créé, même si le prédicat n'est jamais vérifié. Consultez la section NOMS DE FICHIERS PEU COURANTS pour obtenir des informations sur la gestion des caractères inhabituels dans les noms de fichiers.

-fprintf fichier format

Vrai ; semblable à -printf, mais écrire dans le fichier comme le fait -fprint. Le fichier de sortie est toujours créé, même si le prédicat n'est jamais vérifié. Consultez la section NOMS DE FICHIERS PEU COURANTS pour obtenir des informations sur la gestion des caractères inhabituels dans les noms de fichiers.

-ls

Vrai, afficher le nom du fichier en cours dans le format ls -dils sur la sortie standard. La taille est calculée en blocs de 1 Ko, à moins que la variable d'environnement POSIXLY_CORRECT ne soit positionnée, auquel cas la taille est calculée en blocs de 512 octets. Consultez la section NOMS DE FICHIERS PEU COURANTS pour obtenir des informations sur la gestion des caractères inhabituels dans les noms de fichier.

-ok commande ;

Comme -exec, mais interroger d'abord l'utilisateur. Si l'utilisateur acquiesce, la commande est lancée. Sinon, le test devient faux. Si la commande est lancée, son entrée standard est redirigée depuis /dev/null. Cette action ne peut être indiquée en même temps que l'option -files0-from.

La réponse à l’invite de commande est comparée à deux expressions rationnelles afin de déterminer s'il s'agit d'une réponse positive ou négative. Ces expressions rationnelles sont données par le système si la variable d'environnement POSIXLY_CORRECT est définie et, dans le cas contraire, dans les traductions des messages de find. Si le système n'a aucune définition appropriée, les propres définitions de find seront utilisées. Dans tous les cas, l'interprétation de ces expressions rationnelles sera modifiée par les variables d'environnement LC_CTYPE (classe de caractères) et LC_COLLATE (caractères étendus et classes d’équivalence).

-okdir commande ;

Comme -execdir, mais interroger d'abord l'utilisateur comme dans le cas de -ok. Si l'utilisateur n'acquiesce pas, le test renvoie faux. Si la commande est lancée, son entrée standard est redirigée depuis /dev/null. Cette action ne peut être indiquée en même temps que l'option -files0-from.

-print

Vrai ; afficher le nom complet du fichier sur la sortie standard, suivi d'un saut de ligne. Si vous redirigez la sortie standard de find vers un autre programme et qu'il y a la moindre chance qu'un des noms des fichiers que vous recherchez contienne un saut de ligne, alors vous devriez très sérieusement opter pour l'option -print0 plutôt que -print. Consultez la section NOMS DE FICHIERS PEU COURANTS pour obtenir des informations sur la gestion des caractères inhabituels dans les noms de fichier.

-print0

Vrai ; afficher le nom complet du fichier sur la sortie standard, suivi d'un octet NULL (à la place du caractère saut de ligne que -print utilise). Cela permet aux fichiers dont le nom contient un saut de ligne ou d'autres types de caractères non affichables, d'être correctement interprétés par les programmes utilisant les données en sortie de find. Cette option correspond à l'option -0 de xargs.

-printf format

Vrai ; afficher le format sur la sortie standard, en interprétant les séquences d'échappement « \ » et les directives « % ». La largeur et la précision des champs peuvent être spécifiées comme dans la fonction « printf » du langage C. Notez bien que la plupart des champs sont affichés selon %s plutôt que %d, ce qui veut dire que les drapeaux ne fonctionneront peut-être pas comme vous vous y attendez. Cela veut aussi dire que le drapeau « - » fonctionnera (il force l'alignement des champs à gauche). Contrairement à -print, -printf n'ajoute pas de saut de ligne à la fin de la chaîne. Les séquences d'échappement et les directives sont les suivantes :

-prune

Vrai ; si le fichier est un répertoire, ne pas y descendre. Si -depth est donné, alors -prune est sans effet. Parce que -delete implique -depth, vous ne pouvez pas utiliser utilement à la fois -prune et -delete. Par exemple, pour sauter le répertoire src/emacs et tous les fichiers et répertoires en dessous, et afficher les noms des autres fichiers trouvés, faites quelque chose comme ceci :

find . -path ./src/emacs -prune -o -print

-quit

Quitter immédiatement (avec le code de retour zéro s'il n'y a eu aucune erreur). C'est différent de -prune, car -prune ne s'applique qu'au contenu des répertoires coupés, tandis que -quit arrête simplement find immédiatement. Aucune exécution de processus enfant ne sera poursuivie. Toute ligne de commande construite par -exec ... + ou -execdir ... + sera appelée avant que le programme ne quitte. Après -quit, plus aucun fichier indiqué sur la ligne de commande ne sera traité. Par exemple, « find /tmp/toto /tmp/machin -print -quit » n'affichera que « /tmp/toto ».
Une utilisation classique de -quit consiste à arrêter l'examen du système de fichiers dès qu'on a trouvé ce qu'on cherche. Par exemple, si on veut chercher un seul fichier, on peut faire cela :

find / -name needle -print -quit

OPÉRATEURS¶

Dans l'ordre de priorité décroissante :

( expr )

Forcer la priorité. Comme les parenthèses risquent d'être interprétées par le shell, vous devriez normalement les protéger. De nombreux exemples de cette page de manuel utilisent l'antislash dans ce but, par exemple « \(...\) » au lieu de « (...) ».

! expr

Vrai si expr est faux. Ce caractère doit habituellement être protégé pour éviter d'être interprété par le shell.

-not expr

Identique à ! expr, mais non conforme à la norme POSIX.

expr1 expr2

Deux expressions sur la même ligne sont prises pour être jointes par un -a impliqué ; expr2 n'est pas évalué si expr1 est faux.

expr1 -a expr2

Identique à expr1 expr2.

expr1 -and expr2

Identique à expr1 expr2, mais non conforme à la norme POSIX.

expr1 -o expr2

OU ; expr2 n'est pas évaluée si expr1 est vraie.

expr1 -or expr2

Identique à expr1 -o expr2, mais non conforme à la norme POSIX.

expr1 , expr2

Lister ; expr1 et expr2 sont toujours évaluées. La valeur de expr1 est annulée, la valeur de la liste est la valeur de expr2. Le séparateur virgule est pratique pour rechercher différents types de choses tout en ne traversant qu'une fois l'arborescence du système de fichiers. L'action -fprintf peut être utilisée pour récupérer une liste d'éléments variés pour les ranger dans différents fichiers en sortie.

Veuillez remarquer le -a, quand il est spécifié implicitement (par exemple par deux tests sans opérateur explicite entre eux) ou explicitement, a une plus haute priorité que -o. Cela signifie que find . -name fichier1 -o -name fichier2 -print n'affichera jamais fichier1.

Approche simple de « find|xargs »¶

-

Rechercher les fichiers nommés core dans le répertoire /tmp ou dans ses sous-répertoires, puis les effacer.

$ find /tmp -name core -type f -print | xargs /bin/rm -f


    

Remarquez que cela ne fonctionnera pas bien si des noms de fichiers comportent des retours à la ligne, des guillemets simples ou doubles ou des espaces.

Approche plus sûre de « find -print0 | xargs -0 »¶

-

Chercher les fichiers qui s'appellent core dans le répertoire /tmp et ses sous-répertoires, puis les effacer, en veillant à ce que les noms de fichiers ou de répertoires qui contiennent des guillemets simples ou doubles, des espaces ou des retours à la ligne soient correctement traités.

$ find /tmp -name core -type f -print0 | xargs -0 /bin/rm -f


    

Le test -name est effectué avant celui -type afin d'éviter un appel stat(2) sur tous les fichiers.

Remarquez qu'il y a toujours un conflit entre le moment où find explore la hiérarchie et affiche les noms de fichiers trouvés et celui où le processus exécuté par xargs agit sur le fichier.

Traitement de points de départ arbitraires¶

-

Étant donné qu'un autre programme programme exécute un pré-filtre et crée une énorme liste de fichiers séparés par des caractères NULL, les traiter comme points de départ et trouver tous les fichiers normaux parmi eux :

$ proggy | find -files0-from - -maxdepth 0 -type f -empty


    

L'utilisation de -files0-from - signifie lire les noms des points de départ à partir de l'entrée standard, c'est-à-dire par exemple d'un tube, et -maxdepth 0 assure que seules ces entrées explicitement désignées seront examinées sans parcours récursif dans les répertoires (au cas où une des points de départ est un répertoire).

Exécuter une commande pour chaque fichier¶

-

Exécuter fichier sur chaque fichier du répertoire actuel ou de ses sous-répertoires.

$ find . -type f -exec fichier '{}' \;


    

Remarquez que les accolades sont entourées par des guillemets afin d'empêcher leur interprétation en tant que ponctuation du script d'interpréteur. De la même façon, le point-virgule est protégé grâce à une barre oblique inverse, bien que l'apostrophe aurait aussi pu être utilisée dans ce cas.

Dans de nombreux cas, on pourrait préférer la syntaxe `-exec ... +`, voire même `-execdir ... +`, pour des raisons de performance et de sécurité.

Explorer une fois le système de fichiers - pour deux actions différentes¶

-

Parcourir le système de fichiers en une seule passe, stockant les fichiers et répertoires en setuid dans /root/suid.txt et les gros fichiers dans /root/grand.txt.

$ find / \


\( -perm -4000 -fprintf /root/suid.txt '%#m %u %p\n' \) , \


\( -size +100M -fprintf /root/grand.txt '%-10s %p\n' \)




    

Cet exemple utilise le caractère de suite de ligne '\' sur les deux premières lignes pour demander à l'interpréteur de continuer à lire la commande sur la ligne suivante.

Rechercher des fichiers par leur âge¶

-

Rechercher les fichiers dans votre dossier personnel qui ont été modifiés pendant les dernières vingt-quatre heures.

$ find $HOME -mtime 0


    

Cette commande s'exprime de cette façon parce que la date de dernière modification de chaque fichier est découpée en tranche de 24 heures et le reliquat est éliminé. Cela veut dire que pour correspondre à -mtime 0, un fichier doit avoir une antériorité de modification inférieure à 24 heures.

Rechercher les fichiers par leurs permissions¶

• Rechercher les fichiers qui offrent le droit d'exécution, mais qui ne sont pas lisibles.

  
  
  $ find /sbin /usr/sbin -executable \! -readable -print
  
  
      

• Rechercher les fichiers qui ont la permission de lire et d'écrire pour leur propriétaire et groupe et que les autres utilisateurs ne peuvent que lire.

  
  
  $ find . -perm 664
  
  
      

  Les fichiers qui satisfont ces critères, mais qui ont d'autres bits de permissions activés (par exemple si le fichier est exécutable par quelqu'un) ne seront pas sélectionnés.
• Rechercher les fichiers qui ont la permission de lire et d'écrire pour leur propriétaire et leur groupe et que les autres utilisateurs peuvent lire, sans toutefois s'intéresser à la présence d'autres bits de permissions (le bit d'exécution par exemple).

  
  
  $ find . -perm -664
  
  
      

  Cela trouvera un fichier dont le mode est, par exemple, 0777.
• Rechercher les fichiers qui offrent le droit d'écriture à quelqu'un (son propriétaire ou son groupe, ou bien n'importe qui).

  
  
  $ find . -perm /222
  
  
      

• Rechercher les fichiers qui offrent le droit d'écriture à leur propriétaire ou à leur groupe.

  
  
  $ find . -perm /220
  $ find . -perm /u+w,g+w
  $ find . -perm /u=w,g=w
  
  
      

  Ces commandes font toutes les trois la même chose, mais la première utilise le mode octal pour représenter les modes du fichier, alors que les deux autres se servent de la forme symbolique. Ces fichiers n'ont pas à offrir à la fois le droit d'écriture au propriétaire et au groupe, l'un ou l'autre suffira.
• Rechercher les fichiers qui offrent le droit d'écriture à leur propriétaire et à leur groupe.

  
  
  $ find . -perm -220
  $ find . -perm -g+w,u+w
  
  
      

  Ces deux commandes font la même chose.
• Une recherche plus élaborée à partir des permissions.

  
  
  $ find . -perm -444 -perm /222 \! -perm /111
  $ find . -perm -a+r -perm /a+w \! -perm /a+x
  
  
      

  Ces commandes recherchent toutes les deux les fichiers qui sont lisibles par tous (perm -444 ou -perm -a+r), ont au moins un des bits d'écriture actif (-perm /222 ou -perm /a+w), mais qui ne sont exécutables par personne (respectivement ! -perm /111 et ! -perm /a+x).

Découper – omettre des fichiers et des sous-répertoires¶

• Copier le contenu de répertoire-source dans répertoire-cible, en omettant les fichiers ou les répertoires nommés .snapshot (et tout ce qu'ils contiennent). Cela omet aussi les fichiers ou les répertoires dont le nom se termine par « ~ », mais pas les autres contenus.

  
  
  $ cd /répertoire-source
  $ find . -name .snapshot -prune -o \( \! -name '*~' -print0 \) \
  
  
  
  
  | cpio -pmd0 /dest-dir
  
  
  
  
      

  La structure -prune -o \( ... -print0 \) est très connue. L'idée ici, c'est que l'expression avant -prune indique les fichiers à couper. Toutefois, l'action -prune renvoie vrai, donc le -o qui suit n'applique l'expression à sa droite que sur les répertoires qui n'ont pas été coupés (le contenu des répertoires coupés n'est même pas consulté, leur contenu n'est donc pas pertinent). L'expression à droite du -o est entre parenthèses pour des raisons de clarté uniquement. L'accent est mis ici sur le fait que l'action -print0 ne s'exécute que pour les items qui n'ont pas été coupés par -prune. Le « et  » implicite entre les conditions de tests est plus prioritaire que le -o, mais les parenthèses aident à comprendre ce qu'il se passe ici.
• Étant donné les répertoires de projets suivants et les répertoires d'administration de leurs systèmes de gestion de configuration, effectuer une recherche efficace dans les racines des projets :

  
  
  $ find repo/ \
  
  
  \( -exec test -d '{}/.svn' \; \
  -or -exec test -d '{}/.git' \; \
  -or -exec test -d '{}/CVS' \; \
  \) -print -prune
  
  
  
  
      

  Exemple de sortie :

  
  
  repo/project1/CVS
  repo/gnu/project2/.svn
  repo/gnu/project3/.svn
  repo/gnu/project3/src/.svn
  repo/project4/.git
  
  
      

  Dans cet exemple, -prune évite l'inutile inspection des répertoires qui ont déjà été découverts (ne cherche pas par exemple dans project3/src puisqu'il a déjà été trouvé dans project3/.svn) tout en s'assurant que les répertoires frères (project2 et project3) le sont.

Autres exemples utiles¶

• Rechercher plusieurs types de fichiers.

  
  
  $ find /tmp -type f,d,l
  
  
      

  Rechercher des fichiers, des répertoires et des liens symboliques dans le répertoire /tmp en passant ces types sous forme de liste séparée par des virgules (extension GNU), ce qui est équivalent à la commande plus longue mais plus portable :

  
  
  $ find /tmp \( -type f -o -type d -o -type l \)
  
  
      

• Rechercher les fichiers du nom particulier needle et arrêter immédiatement dès qu'on trouve le premier.

  
  
  $ find / -name needle -print -quit
  
  
      

• Démonstration de l'interprétation des directives de format %f et %h de l'action -printf dans certains cas de niche. Voici un exemple comprenant une sortie.

  
  
  $ find . .. / /tmp /tmp/TRACE compile compile/64/tests/find -maxdepth 0 -printf '[%h][%f]\n'
  [.][.]
  [.][..]
  [][/]
  [][tmp]
  [/tmp][TRACE]
  [.][compile]
  [compile/64/tests][find]
  
  
      

Surprises avec la précédence d'un opérateur¶

La commande find . -name fichier1 -o -name fichier2 -print n'affichera jamais fichier1, car elle revient en fait à find . -name fichier1 -o \( -name fichier2 -a -print \). Rappelez-vous que la précédence de -a est supérieure à celle de -o et quand aucun opérateur n'est spécifié entre les tests, -a est présumé.

Message d’erreur “paths must precede expression”¶

$ find . -name *.c -print
find: paths must precede expression
find: possible unquoted pattern after predicate `-name'?

Cela arrive quand l'interpréteur pourrait développer le motif *.c à plus d'un nom de fichier existant dans le répertoire actuel et le passage des noms de fichier qui en résultent à la ligne de commande find devient :

find . -name frcode.c locate.c word_io.c -print

Cette commande ne va bien entendu pas fonctionner, car le prédicat -name ne permet exactement qu'un motif en argument. Plutôt que de faire comme ça, vous devriez encapsuler le motif entre des guillemets ou échapper les jokers, permettant ainsi à find d'utiliser le motif avec le joker lors de la recherche d'un nom de fichier correspondant, au lieu des noms de fichier développés par l'interpréteur parent :

$ find . -name '*.c' -print
$ find . -name \*.c -print