haiku/docs/userguide/fr/applications/cli-apps.html
2020-05-30 10:43:56 +01:00

183 lines
17 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
<head>
<!--
*
* Copyright 2010-2018, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
* Humdinger <humdingerb@gmail.com>
* Translators:
* Humdinger
* Loïc
* Wabouz
*
-->
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="robots" content="all" />
<title>Programmes en ligne de commande</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css" href="../../Haiku-doc.css" />
</head>
<body>
<div id="banner">
<div><span>User guide</span></div>
</div>
<div class="nav">
<div class="inner">
<ul class="lang-menu">
<li class="now">Français&nbsp;<span class="dropdown-caret">&#9660;</span></li>
<li><a href="../../id/applications/cli-apps.html">Bahasa Indonesia</a></li>
<li><a href="../../ca/applications/cli-apps.html">Català</a></li>
<li><a href="../../de/applications/cli-apps.html">Deutsch</a></li>
<li><a href="../../en/applications/cli-apps.html">English</a></li>
<li><a href="../../es/applications/cli-apps.html">Español</a></li>
<li><a href="../../fur/applications/cli-apps.html">Furlan</a></li>
<li><a href="../../it/applications/cli-apps.html">Italiano</a></li>
<li><a href="../../hu/applications/cli-apps.html">Magyar</a></li>
<li><a href="../../pl/applications/cli-apps.html">Polski</a></li>
<li><a href="../../pt_PT/applications/cli-apps.html">Português</a></li>
<li><a href="../../pt_BR/applications/cli-apps.html">Português (Brazil)</a></li>
<li><a href="../../ro/applications/cli-apps.html">Română</a></li>
<li><a href="../../sk/applications/cli-apps.html">Slovenčina</a></li>
<li><a href="../../fi/applications/cli-apps.html">Suomi</a></li>
<li><a href="../../sv_SE/applications/cli-apps.html">Svenska</a></li>
<li><a href="../../tr/applications/cli-apps.html">Türkçe</a></li>
<li><a href="../../zh_CN/applications/cli-apps.html"> 中文 [中文]</a></li>
<li><a href="../../ru/applications/cli-apps.html">Русский</a></li>
<li><a href="../../uk/applications/cli-apps.html">Українська</a></li>
<li><a href="../../jp/applications/cli-apps.html">日本語</a></li>
</ul>
<span>
« <a href="list-cli-apps.html">List of commands</a>
:: <a href="../applications.html#cli-apps" class="uplink">Applications</a>
</span></div>
</div>
<div id="content">
<div>
<div class="box-info">The translation of this page isn't yet complete. Until it is, unfinished parts use the English original.</div>
<h2><img src="../../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>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td>Localisation :</td><td style="width:15px;"></td><td><span class="path">/boot/system/bin/</span><br />
<span class="path">/boot/system/non-packaged/bin/</span><br />
<span class="path">~/config/bin/</span><br />
<span class="path">~/config/non-packaged/bin/</span></td></tr>
</table>
<p><br /></p>
<p>Tous les programmes en ligne de commande livrés avec Haiku se trouvent dans <span class="path">/boot/system/bin/</span>. Vos commandes personnalisées ou additionnelles, installées depuis un paquet .hpkg apparaitrons dans ce même répertoire ou dans <span class="path">~/config/bin/</span>.Autrement, vous pouvez les mettre dans <span class="path">/boot/system/non-packaged/bin/</span> ou <span class="path">~/config/non-packaged/bin/</span>. Ces répertoires faisant tous partie de la variable PATH, l'emplacement d'un programme est donc automatiquement détecté.<br />
Ce qui suit n'est pas une liste exhaustive de toutes les commande spécifiques à Haiku, mais juste un mise en évidence des quelques commandes les plus utiles pour vous en donnez un aperçu. N'hésitez pas à explorer le contenu du dossier <span class="path">bin/</span> de vous même, en exécutant une commande avec le paramètre <tt>--help</tt>, vous accéderez à ses différentes options disponibles pour l'utiliser.</p>
<h3><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="cli-attributes" name="cli-attributes">Concernant les attributs : <span class="cli">listattr</span>, <span class="cli">catattr</span>, <span class="cli">addattr</span>, <span class="cli">rmattr</span>, <span class="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 <a href="../attributes.html#attributes-terminal">attributs dans le Terminal</a>.</p>
<h3><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="cli-index" name="cli-index">Concernant les index : <span class="cli">lsindex</span>, <span class="cli">mkindex</span>, <span class="cli">reindex</span>, <span class="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 <a href="../index.html">Index</a>.</p>
<h3><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="cli-pkg" name="cli-pkg">Concernant la gestion des paquets : <span class="cli">package</span>, <span class="cli">pkgman</span></a></h3>
<p>La commande <span class="cli">package</span> sert à gérer les paquets HPKG.
Consultez l'article <a href="https://www.haiku-os.org/guides/daily-tasks/install-applications">Installing applications</a> pour apprendre les rudiments.
Habituellement, l'outil <a href="https://github.com/haikuports/haikuports/wiki">haikuporter</a> est utilisé pour créer automatiquement des paquets à partir de règles appelées « recettes ».</p>
<p><span class="cli">pkgman</span> sert à rechercher, installer, mettre à jour et désinstaller les paquets. Les dépôts de paquets peuvent être ajoutés, retirés, et la liste de leurs paquets peut être rafraîchi. Le paramètre <tt>full-sync</tt> appelle un type de mise à jour plus agressif : si nécessaire, il retire ou rétrograde des paquets.<br />
pour plus de détails sur un paramètre, ajouter "--help", e.g. <tt>pkgman search --help</tt>.</p>
<h3><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="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 <a href="../bash-scripting.html">le Bash et les Scripts</a>).</p>
<table summary="scripting cli tools" border="0" cellpadding="2" cellspacing="0">
<tr><td><p><span class="cli">alert</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">alert</span> conjures up the typical alert window with a pre-defined icon, explanatory text and up to three buttons. It will return the title of the pressed button and an exit status (starting with 0). For example, this is made of the line:</p>
<pre class="terminal">alert --idea "FantasticApp(tm) installed successfully! \
Would you like a link to it?" "On Desktop" "In Deskbar" "No thanks"</pre>
<p><img src="../images/apps-images/cli-alert.png" alt="cli-alert.png" /></p>
</td></tr>
<tr><td><p><span class="cli">filepanel</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">filepanel</span> displays a load or save file panel and lets the user choose a file or location. As a return value you'll get the chosen file or folder's path. There are several parameters available, for example to set a starting directory, a window title, a default name when saving or restrictions to the allowed types of files. This is an example of</p>
<pre class="terminal">filepanel -s -t "Save your logfile" -d ~/config/settings -n Fantastic.log</pre>
<p><img src="../images/apps-images/cli-filepanel.png" alt="cli-filepanel.png" /></p>
</td></tr>
<tr><td><p><span class="cli">hey</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="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… <a href="https://www.haiku-os.org/blog/humdinger/2017-11-05_scripting_the_gui_with_hey/">l'article du blog de Humdinger</a> constitue une bonne introduction, et dans la "BeOS Bible" de Scot Hacker, vous trouverez un <a href="http://www.birdhouse.org/beos/bible/bos/ch_scripting6.html">tutoriel pour hey</a> par Chris Herborth, très complet.</p></td></tr>
<tr><td><p><span class="cli">notify</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">notify</span> shows a notification panel with a message. There are various parameters that are described when you call <span class="cli">notify --help</span>. A notification can also be used to show the progress of some action. When doing that, it's important to set a <i>messageID</i> and always use it when you update the progress (a float between 0.0 and 1.0 that's printed as percent). Otherwise you'll see several notification panels if you update quicker then the set timeout.<br />
An example:</p>
<pre class="terminal">notify --type progress --group "--group" --title "--title" --icon /boot/home/bebook.hvif \
--messageID MyMessageID --progress .75 "Keep waiting"</pre>
<p><img src="../images/apps-images/cli-notification.png" alt="cli-notification.png" /></p>
</td></tr>
<tr><td><p><span class="cli">query</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="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 (<span class="menu">by formula</span>), et de copier le tout entre doubles quottes (<tt>"</tt>) en paramètre à la commande <span class="cli">query</span> que vous appelez à partir du Terminal ou de votre script.</p></td></tr>
<tr><td><p><span class="cli">waitfor</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="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></tr></table>
<h3><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="cli-other" name="cli-other">Autres commandes</a></h3>
<table summary="scripting cli tools" border="0" cellpadding="2" cellspacing="0">
<tr><td><p><span class="cli">checkfs</span></p></td><td style="width:10px;"> </td>
<td><p><span class="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 <span class="path">/Haiku</span> ou du périphérique, et il va parcourir tous les fichiers et si possible, corriger des incohérences.</p>
</td></tr>
<tr><td><p><span class="cli">desklink</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="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 <span class="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>
<pre class="terminal"> desklink "cmd=Active window (2s):/bin/screenshot --window --border --delay 2" \
"cmd=Remove replicant:desklink --remove=screenshot" /bin/screenshot
</pre>
<p><img src="../images/apps-images/cli-desklink.png" alt="cli-alert.png" /></p>
</td></tr>
<tr><td><p><span class="cli">diskimage</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="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>
<tr><td><p><span class="cli">launch_roster</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p>The launch_daemon starts all sorts of services and applications at boot-up. For some it was instructed to re-start them if they were quit. If you don't want that maybe you'd like to test a modified Tracker, for example you use <span class="cli">launch_roster</span> to <tt>stop</tt> the re-starting of the application before quitting it. Similarly, you can <tt>start</tt> it again or get <tt>info</tt> about it.c The parameter <tt>log</tt> prints out a log of all launch_daemon related events.<br />
Without parameter, <span class="cli">launch_roster</span> lists all apps/services that are under its control.<br />
For example, this will stop the re-launching of the Deskbar:</p>
<pre class="terminal">launch_roster stop x-vnd.be-tskb</pre></td></tr>
<tr><td><p><span class="cli">mountvolume</span><br /><span class="cli">mount</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="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><span class="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 <span class="path">/system/add-ons/kernel/file_system</span> (and corresponding file hierarchies under <span class="path">~/config</span> or "<span class="path">non-packaged</span>", of course). You also have to create a folder as mountpoint. Here's an example:</p>
<pre class="terminal">mkdir -p /DiskStation
mount -t nfs4 -p "192.168.178.3:volume1" /DiskStation</pre></td></tr>
<tr><td><p><span class="cli">open</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="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>
<tr><td><p><span class="cli">ramdisk</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p>A ramdisk is like a harddisk running only in the computer's memory. That makes it very fast but also volatile, because its contents vanishes when you shut down the computer, or it crashes or you experience a blackout.<br />
To create a ramdisk of 1 GiB, format to the name "RAMses" and mount it, you enter this in Terminal or create a script of it:</p>
<pre class="terminal">ramdisk create -s 1gb
mkfs -q -t bfs /dev/disk/virtual/ram/0/raw RAMses
mountvolume RAMses</pre>
<p>Note: When creating a ramdisk, the <span class="cli">ramdisk</span> command prints out the path to it. If you create several disks, that path <span class="path">/dev/disk/virtual/ram/0/raw</span> will change!</p>
<p>To preserve the contents, at least if no calamity like a blackout etc. strikes, a ramdisk can be set up to read/write an image on the harddisk. For that, you need to supply a file of the desired size that will be read from every time you start your ramdisk, and written to when you unmount it. To create an image file "RAMimage" of 500MiB and format it, do this:</p>
<pre class="terminal">dd if=/dev/zero of=RAMimage bs=500M count=1
mkfs -q -t bfs /dev/disk/virtual/ram/0/raw RAMimage</pre>
<p>From now on, you start the ramdisk like this:</p>
<pre class="terminal">ramdisk create RAMimage
mountvolume RAMimage</pre>
<p>It's very important to always cleanly unmount you ramdisk, either from Tracker or with <span class="cli">unmount /RAMimage</span>, or the changes won't be written back to the image file!</p>
</td></tr>
</table>
</div>
</div>
<div class="nav">
<div class="inner"><span>
« <a href="list-cli-apps.html">Liste des commandes</a>
:: <a href="../applications.html#cli-apps" class="uplink">Applications</a>
</span></div>
</div>
</body>
</html>