install - Copier des fichiers et positionner leurs attributs.

install [options] [-s] [--strip] source dest
install [options] [-s] [--strip] source... repertoire
install [options] [-d,--directory] repertoire...
Options (version courte) :
[-b] [-c] [-g groupe] [-m modee] [-o proprietaire] [-S SUFFIXE] [-V {numbered,existing,simple}] [--help] [--version] [--]

install copie des fichiers tout en positionnant les modes d'accès et si possible le propriétaire et le groupe.
Dans sa première forme, le fichier source est copié dans le fichier dest. Dans la seconde, chaque fichier source est copié dans le répertoire destination. Dans la dernière forme, chaque répertoire (ainsi que tout répertoire parent inexistant) est créé.
install est similaire à cp, mais vous permet de contrôler les attributs des fichiers destinations. Il est typiquement utilisé dans les fichiers Makefiles, pour copier les programmes dans leurs répertoires définitifs. Il refuse de copier un fichier sur lui-même.

-c

Ignoré. Pour compatibilité avec de vieilles versions Unix d'install.

-d, --directory

Créer chaque répertoire indiqué ainsi que les répertoires parents manquants, en fixant le propriétaire, le groupe et le mode comme indiqué sur la ligne de commande, ou avec les valeurs par défaut. Donner ces attributs aux répertoires parents créés (ce qui diffère de SunOS 4.x où install, donne les attributs par défaut aux répertoires parents créés).

-g groupe, --group=groupe

Donner aux fichiers installés et aux répertoires crées le groupe indiqué. La valeur par défaut est le groupe du processus appelant. Le groupe peut être mentionné sous forme numérique ou par son nom.

-m mode, --mode=mode

Donner aux fichiers installés et aux répertoires crées le mode indiqué. Celui-ci peut être fourni sous forme de nombre octal, ou sous forme de mode symbolique comme avec chmod, en utilisant 0 comme point de départ. Le mode par défaut est 0755, lecture, écriture, exécution pour le propriétaire, lecture et exécution pour le groupe et les autres.

-o propriétaire, --owner=propriétaire

Si install est invoqué avec les privilèges appropriés (exécuté sous root), il donne aux fichiers installés et aux répertoires créés le propriétaire indiqué. La valeur par défaut est « root ». Le propriétaire peut être mentionné sous forme numérique ou par son nom.

-s, --strip

Réduire la table des symboles des exécutables binaires installés.

Les versions GNU des programmes comme cp, mv, ln, install et patch créeront au besoin une copie de sauvegarde des fichiers à écraser, à modifier ou à détruire. On demande une copie de sauvegarde à l'aide de l'option -b, on indique la nomenclature à adopter avec l'option -V, et si la sauvegarde se fait avec un suffixe, celui-ci est précisé avec l'option -S.

-b, --backup

Créer une copie de sauvegarde des fichiers à écraser ou à détruire.

-S SUFFIXE, --suffix=SUFFIXE

Ajouter le SUFFIXE indiqué à chaque fichier de sauvegarde créé. Si cette option n'est pas indiquée, on utilisera la valeur de la variable d'environnement SIMPLE_BACKUP_SUFFIX. Si la variable SIMPLE_BACKUP_SUFFIX n'existe pas, la valeur par défaut est « ~ ».

-V METHODE, --version-control=METHODE

Préciser la nomenclature des fichiers de sauvegarde La METHODE indiquée peut être « numbered » (« t »), « existing » (« nil »), ou « never » (« simple »). Si cette option n'est pas indiquée, la valeur de la variable d'environnement VERSION_CONTROL est utilisée, et si la variable VERSION_CONTROL n'existe pas, la valeur par défaut est « existing ».
Cette option correspond à la variable « version-control » sous Emacs. Les METHODES valides (les abréviations non ambigües sont acceptées) sont :

t, numbered

Toujours faire une sauvegarde numérotée.

nil, existing

Faire une sauvegarde numérotée des fichiers en ayant déjà une précédente, et une sauvegarde simple pour les autres.

never, simple

Faire toujours une sauvegarde simple.

--help

Afficher un message d'aide sur la sortie standard, et terminer correctement.

--version

Afficher un numéro de version sur la sortie standard, et terminer correctement.

--

Fin de la liste d'options.

Les variables LANG, LC_ALL, LC_CTYPE et LC_MESSAGES ont leurs significations habituelles.

BSD 4.2 (qui dispose des options -c, -m, -o, -g et -s).

Cette page décrit la version de install se trouvant dans le package fileutils-3.16. D'autres versions peuvent différer légèrement. Envoyez les corrections concernant cette page de manuel (en anglais) à aeb@cwi.nl, aw@mail1.bet1.puv.fi, et ragnar@lightside.ddns.org, et (en français) à ccb@club-internet.fr. Signalez les bugs dans le programme à fileutils-bugs@gnu.ai.mit.edu.

Christophe Blaess, 1998.