<h2><imgsrc="../../images/apps-images/cli-app-icon_64.png"alt="cli-app-icon_64.png"width="64"height="64"/>Aplicações em linha de comando específicas do 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">Relacionados aos atributos: <spanclass="cli">listattr</span>, <spanclass="cli">catattr</span>, <spanclass="cli">addattr</span>, <spanclass="cli">rmattr</span>, <spanclass="cli">copyattr</span></a></h3>
<p>Estes comandos são utilizados para exibir, ler, adicionar e remover atributos de arquivos. Lembre-se que estes metadados são atualmente apenas disponíveis em volumes formatados em BFS. Mover arquivos para outros sistemas de arquivos irá eliminar todos os atributos!<br/>
Todos estes comandos são descritos no tópico <ahref="../attributes.html#attributes-terminal">Atributos no Terminal</a>.</p>
<aid="cli-index"name="cli-index">Relacionados ao índice: <spanclass="cli">lsindex</span>, <spanclass="cli">mkindex</span>, <spanclass="cli">reindex</span>, <spanclass="cli">rmindex</span></a></h3>
<p>Com estes comandos pode-se listar, gerar, reindexar e remover atributos para o indexador do BFS. Todo volume tem seu próprio índice, lembre-se disso quando copiar arquivos de um volume para outro.<br/>
Estes comando são descritos no tópico <ahref="../index.html">Indexação</a>.</p>
<p>The <spanclass="cli">package</span> command is used to manage HPKG packages. Have a look at the article <ahref="https://www.haiku-os.org/guides/daily-tasks/install-applications">Installing applications</a> to learn the very basics. Usually the tool <ahref="https://github.com/haikuports/haikuports/wiki">haikuporter</a> is used to automatically create packages from so-called recipes.</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/>
<aid="cli-scripting"name="cli-scripting">Comandos de scripting úteis</a></h3>
<p>Aqui estão umas poucas ferramentas de linha de comando que são especificamente úteis para scripting (veja também o tópico <ahref="../bash-scripting.html">Bash e Scripting</a>).</p>
<tdvalign="top"><p><spanclass="cli">alert</span> evoca a janela típica de alerta com um ícone predefinido, texto explicativo e até três botões. Ela irá retornar o título do botão pressionado e um status de saída (comaçando com 0). Por exemplo, isto pe feito da linha:</p>
<tdvalign="top"><p><spanclass="cli">filepanel</span> exibe uma caixa de diálogo de abrir ou salvar arquivo e permite ao usuário escolher um arquivo ou localidade. Como um valor de retorno obtém-se o arquivo escolhido ou o caminho da pasta. Existem muitos parâmetros disponíveis, por exemplo para definir um diretório inicial, um título de janela, um nome padrão ao salvar ou restrições para os tipos de arquivos permitidos. Este é um exemplo de </p>
<preclass="terminal">filepanel -s -t "Salve seu arquivo de log" -d ~/config/settings -n Fantastic.log</pre>
<tdvalign="top"><p><spanclass="cli">hey</span> is a littler helper tool that sends BMessages to applications and prints out their answer. It can be used for application scripting, i.e. "remote controlling" a program from a script or the command line. Its usage is a bit complex... <ahref="https://www.haiku-os.org/blog/humdinger/2017-11-05_scripting_the_gui_with_hey/">Humdinger's blog post</a> serves as a good introduction, and thanks to Scot Hacker's BeOS Bible, there is a much more comprehensive <ahref="http://www.birdhouse.org/beos/bible/bos/ch_scripting6.html">hey tutorial</a> by Chris Herborth.</p>
<tdvalign="top"><p><spanclass="cli">notify</span> shows a notification panel with a message. There are various parameters that are described when you call <spanclass="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/>
<tdvalign="top"><p><spanclass="cli">query</span> é a versão em linha de comando da janela Procurar. Na verdade, uma maneira rápida para gerar o termo de pesquisa é construir uma consulta na janela Procurar, converter para <spanclass="menu">por fórmula</span>, adicionar aspas duplas (<tt>"</tt>) no início e no fim e colar a sequência inteira após o comando <spanclass="cli">query</span> no Terminal ou no seu script.</p>
<tdvalign="top"><p><spanclass="cli">waitfor</span> é uma maneira elegante de aguardar por um aplicativo particular ou tarefa ser iniciado ou até ter terminado.</p>
<td><p><spanclass="cli">checkfs</span> is an important tool to check for errors in your file system. Simply add a volume name like <spanclass="path">/Haiku</span> or device path and it'll run through every file and correct inconsistencies where possible.</p>
<tdvalign="top"><p><spanclass="cli">desklink</span> pode instalar um ícone para qualquer arquivo, pasta, consulta ou aplicativo na bandeja do Deskbar. Ele também oferece a opção de prover um menu de contexto quando clicar com o botão direito do mouse em um ícone para executar ações especiais. Como um exemplo, tente isto para adicionar o aplicativo de linha de comando <spanclass="app">screenshot</span> com várias opções (a "<tt>\</tt>" na primeira linha é apenas para a quebra de linha no Terminal):</p>
<tdvalign="top"><p><spanclass="cli">diskimage</span> permite registrar um arquivo regular como um dispositivo de disco. Por exemplo, pode-se registrar uma imagem anyboot do Haiku, montá-la no Rastreador e copiar, editar ou remover arquivos lá antes de usá-la como fonte no Instalador.</p>
<tdvalign="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 <spanclass="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, <spanclass="cli">launch_roster</span> lists all apps/services that are under its control.<br/>
<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> é uma pequena ferramenta muito prática. Com ela abre-se qualquer arquivo com seu aplicativo preferido, ou inicia um aplicativo específico pela sua assinatura sem a necessidade de conhecer seu caminho exato. Ela também trabalha com URLs e até com os diretórios "virtuais" <tt>.</tt> para o diretório atual e <tt>..</tt> para o superior, abrindo a pasta no Rastreador.</p>
<tdvalign="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>
<preclass="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 <spanclass="cli">ramdisk</span> command prints out the path to it. If you create several disks, that path <spanclass="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>
<p>From now on, you start the ramdisk like this:</p>
<preclass="terminal">ramdisk create RAMimage
mountvolume RAMimage</pre>
<p>It's very important to always cleanly unmount you ramdisk, either from Tracker or with <spanclass="cli">unmount /RAMimage</span>, or the changes won't be written back to the image file!</p>
