'\" t
.\"     Title: whereis
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-01-05
.\"    Manual: Commandes de l'utilisateur
.\"    Source: util-linux 2.39.3
.\"  Language: English
.\"
.TH "WHEREIS" "1" "2024-01-05" "util\-linux 2.39.3" "Commandes de l\*(Aqutilisateur"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NOM"
whereis \- Rechercher les fichiers exécutables, les sources et les pages de manuel d\*(Aqune commande
.SH "SYNOPSIS"
.sp
\fBwhereis\fP [options] [\fB\-BMS\fP \fIrépertoire\fP... \fB\-f\fP] \fInom\fP...
.SH "DESCRIPTION"
.sp
\fBwhereis\fP locates the binary, source and manual files for the specified command names. The supplied names are \fBfirst stripped of leading pathname components\fP. Prefixes of \fBs.\fP resulting from use of source code control are also dealt with. \fBwhereis\fP then attempts to locate the desired program in the standard Linux places, and in the places specified by \fB$PATH\fP and \fB$MANPATH\fP.
.sp
Les restrictions de recherche (option \fB\-b\fP, \fB\-m\fP et \fB\-s\fP) sont cumulatives et s’appliquent aux motifs \fInom\fP suivants sur la ligne de commande. Toute nouvelle restriction de recherche réinitialise le masque de recherche. Par exemple,
.RS 3
.ll -.6i
.sp
\fBwhereis \-bm ls tr \-m gcc\fP
.br
.RE
.ll
.sp
recherche les binaires et pages de manuel pour « ls » et « tr », mais seulement les pages de manuel pour « gcc ».
.sp
Les options \fB\-B\fP, \fB\-M\fP et \fB\-S\fP réinitialisent les chemins de recherche pour les motifs \fInom\fP suivants. Par exemple,
.RS 3
.ll -.6i
.sp
\fBwhereis \-m ls \-M /usr/share/man/man1 \-f cal\fP
.br
.RE
.ll
.sp
recherche les pages de manuel « \fBls\fP » dans tous les chemins par défaut, mais seulement dans le répertoire \fI/usr/share/man/man1\fP pour « cal ».
.SH "OPTIONS"
.sp
\fB\-b\fP
.RS 4
Chercher les exécutables.
.RE
.sp
\fB\-m\fP
.RS 4
Chercher les manuels.
.RE
.sp
\fB\-s\fP
.RS 4
Chercher les sources.
.RE
.sp
\fB\-u\fP
.RS 4
Ne montrer que les noms de commande qui ont des entrées inhabituelles. Une commande est dite inhabituelle si elle n’a pas une seule entrée pour chaque type demandé explicitement. Ainsi, « \fBwhereis \-m \-u \fP*> » recherche les fichiers du répertoire actuel qui n\(cqont soit pas de fichier de documentation, soit plus d’un.
.RE
.sp
\fB\-B\fP \fIliste\fP
.RS 4
Limiter les répertoires où \fBwhereis\fP cherche les exécutables, à l’aide d’une liste de répertoires séparés par des espaces.
.RE
.sp
\fB\-M\fP \fIliste\fP
.RS 4
Limiter les répertoires où \fBwhereis\fP cherche les manuels et la documentation au format Info, à l’aide d’une liste de répertoires séparés par des espaces.
.RE
.sp
\fB\-S\fP \fIliste\fP
.RS 4
Limiter les répertoires où \fBwhereis\fP cherche les sources, à l’aide d’une liste de répertoires séparés par des espaces.
.RE
.sp
\fB\-f\fP
.RS 4
Terminer la liste de répertoires et signaler le début des noms de fichiers. Cette option est \fIobligatoire\fP quand une des options \fB\-B\fP, \fB\-M\fP ou \fB\-S\fP est utilisée.
.RE
.sp
\fB\-l\fP
.RS 4
Afficher la liste des chemins effectifs de recherche que \fBwhereis\fP utilise. Si ni \fB\-B\fP, ni \fB\-M\fP ni \fB\-S\fP ne sont indiquées, les chemins codés en dur que la commande a pu trouver sur le système seront affichés.
.RE
.sp
\fB\-g\fP
.RS 4
Interpret the next names as a \fBglob(7)\fP patterns. \fBwhereis\fP always compares only filenames (aka basename) and never complete path. Using directory names in the pattern has no effect. Don’t forget that the shell interprets the pattern when specified on the command line without quotes. It’s necessary to use quotes for the \fIname\fP, for example:
.RE
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
whereis \-g \*(Aqfind*\*(Aq
.fam
.fi
.if n .RE
.br
.RE
.ll
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Afficher l’aide\-mémoire puis quitter.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Afficher le numéro de version et quitter.
.RE
.SH "CHEMINS DE RECHERCHE DE FICHIERS"
.sp
Par défaut, \fBwhereis\fP essaye de trouver les fichiers définis avec des motifs joker, dans les chemins codés en dur. La commande tente d’utiliser le contenu des variables d’environnement \fB$PATH\fP et \fB$MANPATH\fP comme chemins de recherche par défaut. La façon la plus facile de connaître les chemins utilisés est d’ajouter l’option d’affichage \fB\-l\fP. Les effets de \fB\-B\fP, \fB\-M\fP et \fB\-S\fP sont affichés avec \fB\-l\fP.
.SH "ENVIRONNEMENT"
.sp
\fBWHEREIS_DEBUG\fP=all
.RS 4
Activer la sortie de débogage.
.RE
.SH "EXEMPLES"
.sp
Pour trouver tous les fichiers dans \fI/usr/bin\fP non documentés dans \fI/usr/man/man1\fP ou sans source dans \fI/usr/src\fP :
.RS 3
.ll -.6i
.sp
\fBcd /usr/bin\fP
.br
\fBwhereis \-u \-ms \-M /usr/man/man1 \-S /usr/src \-f *\fP
.br
.RE
.ll
.SH "SIGNALER DES BOGUES"
.sp
Pour signaler un bogue, utilisez le gestionnaire de bogues sur \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "DISPONIBILITÉ"
.sp
La commande \fBwhereis\fP fait partie du paquet util\-linux, elle est disponible sur \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "l’archive du noyau Linux" "."