<h2><imgsrc="../../images/apps-images/cli-app-icon_64.png"alt="cli-app-icon_64.png"width="64"height="64"/>Programmes en ligne de commande spécifiques à Haiku</h2>
<p>All commandline applications shipped with Haiku are in <spanclass="path">/boot/system/bin/</span>. Your own or additionally installed commandline apps will appear there as well, or in <spanclass="path">~/config/bin/</span>, when installed from a .hpkg package. Otherwise you can put them into <spanclass="path">/boot/system/non-packaged/bin/</span> or <spanclass="path">~/config/non-packaged/bin/</span>. All these locations are part of the PATH variable and are therefore automatically found.<br/>
The following isn't an exhaustive list of all Haiku-specific CLI apps, it serves just to highlight a few of the most useful to give you a taste. Feel encouraged to explore what's in the <spanclass="path">bin/</span> folders on your own a bit. Executing an app with the parameter <tt>--help</tt> shows the usage of the command and all its various options.</p>
<aid="cli-attributes"name="cli-attributes">Concernant les attributs : <spanclass="cli">listattr</span>, <spanclass="cli">catattr</span>, <spanclass="cli">addattr</span>, <spanclass="cli">rmattr</span>, <spanclass="cli">copyattr</span></a></h3>
<p>Ces commandes sont utilisées pour afficher, lire, ajouter et supprimer des attributs de fichiers. Rappelez-vous que ces méta-données ne sont actuellement disponibles que sur les volumes formatés en BFS. Si vous déplacez un fichier vers un autre systèmes de fichiers, vous perdrez tous les attributs !<br/>
Toutes ces commandes sont décrites dans le sujet consacré aux <ahref="../attributes.html#attributes-terminal">attributs dans le Terminal</a>.</p>
<aid="cli-index"name="cli-index">Concernant les index : <spanclass="cli">lsindex</span>, <spanclass="cli">mkindex</span>, <spanclass="cli">reindex</span>, <spanclass="cli">rmindex</span></a></h3>
<p>Avec ces commandes vous pouvez lister, créer, ré-indexer et retirer des attributs au mécanisme d'indexation BFS. Chaque volume a son propre index, souvenez-vous en quand copiez des fichiers d'un volume à l'autre.<br/>
Ces commandes sont décrites dans le sujet qui traite des <ahref="../index.html">Index</a>.</p>
<aid="cli-pkg"name="cli-pkg">Concernant la gestion des paquets : <spanclass="cli">package</span>, <spanclass="cli">pkgman</span></a></h3>
<p>La commande <spanclass="cli">package</span> sert à gérer les paquets HPKG.
Consultez l'article <ahref="https://www.haiku-os.org/guides/daily-tasks/install-applications">Installing applications</a> pour apprendre les rudiments. Les paquets sont généralement construits automatiquement à partir de recettes élaborées depuis l'outil <ahref="https://github.com/haikuports/haikuports/wiki">haikuporter</a>.</p>
<p><spanclass="cli">pkgman</span> is used to search, install, update and uninstall packages. Package repositories can be added, dropped and their package lists refreshed. A special kind of update is invoked with the parameter <tt>full-sync</tt>: It is more aggressive and also downgrades or removes packages, if necessary.<br/>
For more details on a parameter, append "--help", e.g. <tt>pkgman search --help</tt>.</p>
<aid="cli-scripting"name="cli-scripting">Commandes utiles dans les scripts</a></h3>
<p>Voici quelques outils en ligne de commande qui sont particulièrement utiles pour les scripts (voir aussi le sujet sur <ahref="../bash-scripting.html">le Bash et les Scripts</a>).</p>
<tdvalign="top"><p><spanclass="cli">alert</span> invoque la fenêtre d'alerte typique avec une icône ad-hoc, un texte explicatif et jusqu'à trois boutons. le titre du bouton pressé sera renvoyé avec un code d'état (commençant à 0). Voici un exemple et son résultat :</p>
<tdvalign="top"><p><spanclass="cli">filepanel</span> affiche une boite de dialogue pour ouvrir ou enregistrer un fichier en permettant à l'utilisateur de choisir un fichier ou un emplacement. Vous obtiendrez comme valeur de retour, le fichier choisi ou le chemin du dossier.
Parmi les paramètres disponibles, vous pouvez définir un répertoire de départ, un titre de fenêtre, un nom par défaut pour le fichier à enregistrer ou des restrictions aux types de fichiers autorisés. En voici un exemple :</p>
<preclass="terminal">filepanel -s -t "Save your logfile" -d ~/config/settings -n Fantastic.log</pre>
<tdvalign="top"><p><spanclass="cli">hey</span> est un petit utilitaire pour envoyer des BMessages aux applications et afficher leurs réponses. Il peut être utilisé pour écrire des scripts d'applications, i.e. "contrôle à distance" d'un programme à partir d'un script ou de la ligne de commande. Son utilisation est un peu complexe... Mais grâce à la "BeOS Bible" de Scot Hacker, il y a un beau <ahref="http://www.birdhouse.org/beos/bible/bos/ch_scripting6.html">tutoriel pour hey</a> pour Chris Herborth.</p></td></tr>
<tdvalign="top"><p><spanclass="cli">query</span> est la version ligne de commande de la fenêtre de recherche. En fait, une façon rapide de créer une expression de recherche, est de construire une requête dans la fenêtre de recherche, de basculer vers les formules (<spanclass="menu">by formula</span>), et de copier le tout entre doubles quottes (<tt>"</tt>) en paramètre à la commande <spanclass="cli">query</span> que vous appelez à partir du Terminal ou de votre script.</p></td></tr>
<tdvalign="top"><p><spanclass="cli">waitfor</span> est une méthode élégante pour attendre qu'une application ou une tâche particulière soit démarrée, ou terminée.</p>
<td><p><spanclass="cli">checkfs</span> est un outil important pour détecter les erreurs dans votre système de fichiers. Il suffit d'ajouter le nom du volume comme par exemple <spanclass="path">/Haiku</span> ou du périphérique, et il va parcourir tous les fichiers et si possible, corriger des incohérences.</p>
<tdvalign="top"><p><spanclass="cli">desklink</span> vous permet d'installer une icône dans le cartouche de la Deskbar à partir de n'importe quel fichier, dossier, requête ou application. Vous pourrez également pourvoir le menu contextuel d'actions spécifiques à exécuter quand vous ferez un clic droit sur l'icône.
Voici par exemple comment ajouter <spanclass="app">Screenshot</span> avec diverses options (le "<tt>\</tt>" à la fin de la première ligne sert juste au saut de ligne dans Terminal) :</p>
<tdvalign="top"><p><spanclass="cli">diskimage</span> vous permet d'inscrire un ficher ordinaire en tant que periphérique disque. Par exemple, vous pouvez inscrire l'image disque "anyboot" d'Haiku, puis monter le volume qu'elle contient dans le Tracker et copier, éditer ou supprimer les fichiers avant de l'utiliser comme source dans le programme d'installation.</p></td></tr>
<tdvalign="top"><p><spanclass="cli">mountvolume</span> is preferred by many to mount local partitions and disks, because its usage is so easy: just call it with the name of the partition and you're done. Try <tt>--help</tt> for more options.</p>
<p><spanclass="cli">mount</span> can additionally mount remote disks by using a network filesystem, like NFS4. You specify the used filesystem with the <tt>-t</tt> parameter and the remote location with the <tt>-p</tt> parameter. As filesystem parameter you can use anything you find in <spanclass="path">/system/add-ons/kernel/file_system</span> (and corresponding file hierarchies under <spanclass="path">~/config</span> or "<spanclass="path">non-packaged</span>", of course). You also have to create a folder as mountpoint. Here's an example:</p>
<preclass="terminal">mkdir -p /DiskStation
mount -t nfs4 -p "192.168.178.3:volume1" /DiskStation</pre></td></tr>
<tdvalign="top"><p><spanclass="cli">open</span> est un petit outils très pratique pour ouvrir n'importe quel fichier avec son application préférée, ou pour démarrer une application particulière à partir de sa signature sans avoir besoin de connaître son emplacement exact. Ça fonctionne également avec les URLs, et même avec les dossiers "virtuels" <tt>.</tt> et <tt>..</tt> qui représentent respectivement le dossier courant et le dossier parent, qui seront ainsi ouvert dans le Tracker.</p></td></tr>