haiku/docs/userguide/en/bash-scripting.html

118 lines
7.1 KiB
HTML
Raw Normal View History

<?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="en-US" xml:lang="en-US">
<head>
<!--
*
* Copyright 2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
* Humdinger <humdingerb@gmail.com>
*
-->
<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>Bash and Scripting</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">English&nbsp;<span class="dropdown-caret">&#9660;</span></li>
<li><a href="../id/bash-scripting.html">Bahasa Indonesia</a></li>
<li><a href="../ca/bash-scripting.html">Català</a></li>
<li><a href="../de/bash-scripting.html">Deutsch</a></li>
<li><a href="../es/bash-scripting.html">Español</a></li>
<li><a href="../fr/bash-scripting.html">Français</a></li>
<li><a href="../fur/bash-scripting.html">Furlan</a></li>
<li><a href="../it/bash-scripting.html">Italiano</a></li>
<li><a href="../hu/bash-scripting.html">Magyar</a></li>
<li><a href="../pl/bash-scripting.html">Polski</a></li>
<li><a href="../pt_PT/bash-scripting.html">Português</a></li>
<li><a href="../pt_BR/bash-scripting.html">Português (Brazil)</a></li>
<li><a href="../ro/bash-scripting.html">Română</a></li>
<li><a href="../sk/bash-scripting.html">Slovenčina</a></li>
<li><a href="../fi/bash-scripting.html">Suomi</a></li>
<li><a href="../sv_SE/bash-scripting.html">Svenska</a></li>
<li><a href="../tr/bash-scripting.html">Türkçe</a></li>
<li><a href="../zh_CN/bash-scripting.html"> 中文 [中文]</a></li>
<li><a href="../ru/bash-scripting.html">Русский</a></li>
<li><a href="../uk/bash-scripting.html">Українська</a></li>
<li><a href="../jp/bash-scripting.html">日本語</a></li>
</ul>
<span>
«  <a href="preferences.html">Preferences</a> 
::  <a href="contents.html" class="uplink">Contents</a> 
<!-- ::  <a href="filesystem-layout.html">Filesystem layout</a>  » -->
</span></div>
</div>
<div id="content">
<div>
<h1>Bash and Scripting</h1>
<p>"Scripting" is the technique of automating procedures by stringing together commands and saving it all as text files, so called "scripts". Every time you run such a script, the commands are processed one after the other just like they would if you entered them into the <a href="applications/terminal.html">Terminal</a> by hand.<br />
Scripts can range from simply executing a few commands in a specific order to sophisticated pieces of code that solve complex tasks.</p>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="bash" name="bash">The Bash</a></h2>
2017-04-15 23:38:49 +03:00
<p>Since scripts rely naturally a lot on the shell they are interpreted by, you should first familiarize yourself with the BASH that's used by Haiku. There are many resources online as it's a widely used shell. One nice document is Johan Jansson's <a href="https://web.archive.org/web/20011205095723/http://www.beforever.com/bashtut.htm" class="printurl">Introduction to bash - a tutorial for bash under BeOS</a>.<br />
The <a href="https://www.gnu.org/software/bash/manual/bash.pdf" class="printurl">Bash Reference Manual (PDF, 720 KiB)</a> is a nice resource to get into the details.</p>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="scripting-bible" name="scripting-bible">The Scripting Bible</a></h2>
2017-04-15 23:38:49 +03:00
<p>After you've learned a few basics about working in the shell, it's time to slowly ease yourself into the world of scripting. Again, you'll find loads of tutorials and reference material online as well as in bookstores. A very nice introduction that's practically tailor-made for Haiku is the online available <a href="http://www.birdhouse.org/beos/bible/bos/ch_scripting1.html" class="printurl">Scripting Chapter</a> (<a href="http://www.birdhouse.org/beos/bible/bos/BeOS.scripting.PDF">PDF, 900 KiB</a>) of Scot Hacker's BeOS Bible.</p>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a><a id="user-scripts" name="user-scripts">Scripts in Haiku</a></h2>
<p>Haiku used to have scripts for booting and shutting down. Today it uses the <a href="https://dev.haiku-os.org/wiki/LaunchDaemon">launch_daemon</a> instead. However, the user can still augment this process with certain user scripts.
If they don't exist already, you'll have to create the needed files yourself. Otherwise simply add your commands where in the process you want them to be executed.</p>
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="userbootscript" name="userbootscript">The UserBootscript</a></h3>
<p><span class="path">/boot/home/config/settings/boot/UserBootscript</span> will be executed after the system has finished its boot process. For example, you could launch a number of programs that would then be automatically started on every boot up:</p>
<pre># Start LaunchBox
/boot/system/apps/LaunchBox &amp;
# Start Workspaces Applet
/boot/system/apps/Workspaces &amp;</pre>
<p>Remember to end a command with an "<tt>&amp;</tt>" to start it as a background process, or the script will halt until that command has finished (in this case: the launched app was closed).</p>
<p>A simple alternative to the above for launching applications at boot up is to put links to them in the <span class="path">/boot/home/config/settings/boot/launch</span> directory. This can be done simply by right-clicking on the application you wish to have started automatically, going to <span class="menu">Create Link</span> and then <a href="tracker.html#navigating">navigating</a> to the above directory.</p>
<h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="usershutdownscript" name="usershutdownscript">The UserShutdownScript - <i>not yet working</i></a></h3>
<p><span class="path">/boot/home/config/settings/boot/UserShutdownScript</span> will be executed as the first step in the shutdown process. If the script returns a non-zero exit status, the shutdown is aborted.</p>
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="usershutdownfinishscript" name="usershutdownfinishscript">The UserShutdownFinishScript - <i>not yet working</i></a></h3>
<p><span class="path">/boot/home/config/settings/boot/UserShutdownFinishScript</span> is executed as the last step in the shutdown process. Note, that most parts of the system have terminated by the time this script is executed.</p>
</div>
</div>
<div class="nav">
<div class="inner"><span>
«  <a href="preferences.html">Preferences</a> 
::  <a href="contents.html" class="uplink">Contents</a> 
<!-- ::  <a href="filesystem-layout.html">Filesystem layout</a>  » -->
</span></div>
</div>
</body>
</html>