Ero sivun ”Bash-skriptaus” versioiden välillä

Linux.fista
Siirry navigaatioon Siirry hakuun
(Lisätty linkkejä sekä parannettu ulkoasua.)
 
(31 välissä olevaa versiota 11 käyttäjän tekeminä ei näytetä)
Rivi 1: Rivi 1:
Komentorivi on jo yksinään [[Komentorivin perusteet|monipuolinen]] työkalu, mutta skriptien avulla on mahdollista toteuttaa huomattavasti monipuolisempia prosesseja pienellä vaivalla. Tässä oppaassa käsitellään skriptien kirjoittamista [[bash]]-[[komentotulkki|komentotulkille]].
Komentorivi on jo yksinään [[Komentorivin perusteet|monipuolinen]] työkalu, mutta skriptien avulla on mahdollista toteuttaa huomattavasti monipuolisempia prosesseja pienellä vaivalla. Tässä oppaassa käsitellään [[skripti]]en kirjoittamista [[Bash]]-[[komentotulkki|komentotulkille]].
 
Kirjoittaaksesi käyttöjärjestelmäriippumattomia skriptejä on syytä kirjoittaa skriptit [[POSIX]]-yhteensopivina [[POSIX-skriptaus|POSIX-skripteinä]].


== Alkuun ==
== Alkuun ==
Skripti aloitetaan rivillä
Skripti aloitetaan rivillä
<source lang="bash">
<syntaxhighlight lang="bash">
#!/bin/bash
#!/bin/bash
</source>
</syntaxhighlight>
Joka kertoo, että skripti suoritetaan käyttäen bashia riippumatta siitä, mitä komentotulkkia käyttäjä käyttää ajaessaan skriptin. Huomaa, että vaikka rivi alkaa #-merkillä, se ei ole kommentti. Muualla skriptissä #:llä alkavat rivit ovat kommentteja, eikä niitä huomioida.
Joka kertoo, että skripti suoritetaan käyttäen bashia riippumatta siitä, mitä komentotulkkia käyttäjä käyttää ajaessaan skriptin. Huomaa, että vaikka rivi alkaa #-merkillä, se ei ole kommentti. Muualla skriptissä #:llä alkavat rivit ovat kommentteja, eikä niitä huomioida.


Rivi 12: Rivi 14:
=== Ensimmäinen skripti ===
=== Ensimmäinen skripti ===
Tehdään aluksi yksinkertainen skripti, joka esittelee muutamia perustoimintoja:
Tehdään aluksi yksinkertainen skripti, joka esittelee muutamia perustoimintoja:
<source lang="bash">
<syntaxhighlight lang="bash">
#!/bin/bash
#!/bin/bash
echo "Hei, `whoami`, mitä kuuluu"
echo "Hei, $(whoami), mitä kuuluu"
echo "Olet hakemistossa $PWD, tiedostolistaus:"
echo "Olet hakemistossa $(pwd), tiedostolistaus:"
ls
ls
</source>
</syntaxhighlight>
Kuten huomaat, skripteissä käytetään tavallisia komentorivikomentoja, jotka sitten suoritetaan järjestyksessä. Toisaalta kuten myöhemmin huomaamme, skriptit tarjoavat paljon enemmän mahdollisuuksia kuin pelkkä komentojen näpyttely konsoliin.
Kuten huomaat, skripteissä käytetään tavallisia komentorivikomentoja, jotka sitten suoritetaan järjestyksessä. Toisaalta kuten myöhemmin huomaamme, skriptit tarjoavat paljon enemmän mahdollisuuksia kuin pelkkä komentojen näpyttely konsoliin.


Rivi 24: Rivi 26:
  Olet hakemistossa /home/kayttaja/ohjelmointi/skriptit, tiedostolistaus:
  Olet hakemistossa /home/kayttaja/ohjelmointi/skriptit, tiedostolistaus:
  eka.sh
  eka.sh
Esimerkistä nähdään heti muutama perusasia. Ensinnäkin toisella rivillä käytetään ohjelmaa [[whoami]], joka tulostaa käyttäjänimen. Kun ohjelma on `-merkkein välissä, kyseiseen kohtaan "kopioidaan" ajetun ohjelman tuloste.
Esimerkistä nähdään heti muutama perusasia. Ensinnäkin toisella rivillä käytetään ohjelmaa [[whoami]], joka tulostaa käyttäjänimen. Kun ohjelma on $()-merkinnän sisällä, kyseiseen kohtaan "kopioidaan" ajetun ohjelman tuloste.


Toisella rivillä käytetään muuttujaa. Muuttujien edessä on dollarimerkki ($), ja niitä voidaan tunkea vaikka merkkijonojen (jotka erotetaan lainausmerkillä) sisälle. Muuttujia käsitellään tarkemmin myöhemmin. Esimerkissä käyttämämme muuttuja <tt>$PWD</tt> on [[ympäristömuuttuja]], jonka arvona on aina se hakemisto, jossa käyttäjä on. Voit kokeilla tätä esimerkiksi kirjoittamalla komentoriville komennon <tt>echo $PWD</tt>.
Toisella rivillä käytetään muuttujaa. Muuttujien edessä on dollarimerkki ($), ja niitä voidaan tunkea vaikka merkkijonojen (jotka erotetaan lainausmerkillä) sisälle. Muuttujia käsitellään tarkemmin myöhemmin. Esimerkissä käyttämämme muuttuja <tt>$PWD</tt> on [[ympäristömuuttuja]], jonka arvona on aina se hakemisto, jossa käyttäjä on. Voit kokeilla tätä esimerkiksi kirjoittamalla komentoriville komennon <tt>echo $PWD</tt>.


Viimeisellä rivillä ajetaan normaalisti komentoriviohjelma [[ls]]. Voit myös kokeilla korvata tämän rivin rivillä
Viimeisellä rivillä ajetaan normaalisti komentoriviohjelma [[ls]]. Voit myös kokeilla korvata tämän rivin rivillä
<source lang="bash">
<syntaxhighlight lang="bash">
echo "`ls`"
echo "`ls`"
</source>
</syntaxhighlight>
 
Merkintä $() voidaan kirjoittaa myös ``, kuten alla esimerkissä. Tällöin kuitenkaan ei voi käyttää sisäkkäisiä komentoja.


Skrpti voitaisiin myös kirjoittaa suoraan komentoriville muodossa
Skripti voitaisiin myös kirjoittaa suoraan komentoriville muodossa
<source lang="bash">
<syntaxhighlight lang="bash">
echo "Hei, `whoami`, mitä kuuluu"; echo "Olet hakemistossa $PWD, tiedostolistaus:"; ls;
echo "Hei, `whoami`, mitä kuuluu"; echo "Olet hakemistossa $PWD, tiedostolistaus:"; ls;
</source>
</syntaxhighlight>


== Muuttujat ==
== Muuttujat ==
Muuttujat määritellään syntaksilla
Muuttujat määritellään syntaksilla
<source lang="bash">
<syntaxhighlight lang="bash">
nimi=arvo
nimi=arvo
</source>
</syntaxhighlight>
ja niihin viitataan laittamalla muuttujan eteen $
ja niihin viitataan laittamalla muuttujan eteen $
<source lang="bash">
<syntaxhighlight lang="bash">
$nimi
$nimi
</source>
</syntaxhighlight>
Siinä tapauksessa mikäli halutaan, että komennon tulos on muuttuja asetetaan muuttuja tyyliin:
Siinä tapauksessa mikäli halutaan, että komennon tulos on muuttuja asetetaan muuttuja tyyliin:
<source lang="bash">
<syntaxhighlight lang="bash">
nimi=("komennon nimi ja parametrit")
nimi=("komennon nimi ja parametrit")
</source>
</syntaxhighlight>
Tapauksia, joissa käyttäjän tarkoittama muuttuja on epäselvä, tulee käyttää aaltosulkuja muuttujan ympärillä
Tapauksia, joissa käyttäjän tarkoittama muuttuja on epäselvä, tulee käyttää aaltosulkuja muuttujan ympärillä
<source lang="bash">
<syntaxhighlight lang="bash">
${foo}bar
${foo}bar
</source>
</syntaxhighlight>
kun halutaan tulostaa teksti <tt>bar</tt> muuttujan <tt>foo</tt> jälkeen.
kun halutaan tulostaa teksti <tt>bar</tt> muuttujan <tt>foo</tt> jälkeen.


Ensimmäisen skriptimme tapauksessa käytimme jo ympäristömuuttujaa $PWD echo:n kanssa. Tehdäänpä samantyyppinen skripti nyt käyttäen itse määrittelemäämme muuttujaa:
Ensimmäisen skriptimme tapauksessa käytimme jo ympäristömuuttujaa $PWD echo:n kanssa. Tehdäänpä samantyyppinen skripti nyt käyttäen itse määrittelemäämme muuttujaa:
<source lang="bash">
<syntaxhighlight lang="bash">
#!/bin/bash
#!/bin/bash
HEI="Hei, `whoami`, mitä kuuluu?"
HEI="Hei, `whoami`, mitä kuuluu?"
echo $HEI
echo $HEI
</source>
</syntaxhighlight>
Kuten huomaat, kun muuttujaan sijoitetaan arvo, voidaan käyttää samoja "kikkoja" kuin muuallakin skriptissä, esimerkiksi tässä tapauksessa sijoitamme muuttujaan merkkijonon jonka sisällä on ohjelman <tt>whoami</tt> tuloste.
Kuten huomaat, kun muuttujaan sijoitetaan arvo, voidaan käyttää samoja "kikkoja" kuin muuallakin skriptissä, esimerkiksi tässä tapauksessa sijoitamme muuttujaan merkkijonon jonka sisällä on ohjelman <tt>whoami</tt> tuloste.


Rivi 71: Rivi 75:


Lisäksi muuttujaan sijoitettavan arvon on oltava lainausmerkkien sisällä, jos siihen kuuluu välilyönti. Yksittäisen sanan tai numeron voi sijoittaa ilman lainausmerkkejä:
Lisäksi muuttujaan sijoitettavan arvon on oltava lainausmerkkien sisällä, jos siihen kuuluu välilyönti. Yksittäisen sanan tai numeron voi sijoittaa ilman lainausmerkkejä:
<source lang="bash">
<syntaxhighlight lang="bash">
numero=43
numero=43
</source>
</syntaxhighlight>


== Ehtolauseet ==
== Ehtolauseet ==
Ehdollisia rakenteita luodaan bashille if, then, else ja fi -avainsanoilla. Rakenteen syntaksi on seuraava:
Ehdollisia rakenteita luodaan bashille if, then, else ja fi -avainsanoilla. Rakenteen syntaksi on seuraava:
<source lang="bash">
<syntaxhighlight lang="bash">
if [ ehto ]
if [ ehto ]
then
then
     lauseita
     lauseita
elif [ toinen ehto ]
elif [ toinen ehto ]
then
then
     lauseita
     lauseita
else
else
     muita lauseita
     muita lauseita
fi
fi
</source>
</syntaxhighlight>


Ehdot merkitään hakasulkeiden sisään esimerkiksi seuraavalla tavalla
Ehdot merkitään hakasulkeiden sisään esimerkiksi seuraavalla tavalla
<source lang="bash">
<syntaxhighlight lang="bash">
#!/bin/bash
#!/bin/bash
if [ $PWD = "/" ]
if [ $PWD = "/" ]
then
then
        echo "Tämä skripti suoritetaan juurihakemistossa";
    echo "Tämä skripti suoritetaan juurihakemistossa";
else
else
        echo "Skripti suoritetaan hakemistossa $PWD";
    echo "Skripti suoritetaan hakemistossa $PWD";
fi
fi
</source>
</syntaxhighlight>
 
=== Yhden rivin ehtolauseet ===
Lyhyiden skriptien kanssa.
<syntaxhighlight lang="bash">
[ ehto ] && lauseita || [ toinen ehto ] && lauseita || muita lauseita
 
[ $PWD = "/" ] && printf "\nTämä skripti suoritetaan juurihakemistossa\n" || printf "\nSkripti suoritetaan hakemistossa %s\n" "$PWD"
</syntaxhighlight>


Tässä käytetään vertailuoperaattoria =, joka on tosi, jos merkkijonot ovat samat. Muita vertailuoperaattoreita ovat
Tässä käytetään vertailuoperaattoria =, joka on tosi, jos merkkijonot ovat samat. Muita vertailuoperaattoreita ovat
Rivi 107: Rivi 119:
|-
|-
<!-- taulukko alkaa tästä -->
<!-- taulukko alkaa tästä -->
| !  || Negaatio-operaattori, "Onko seuraava ehto epätosi?"
|-
| -n || Pituus ei ole 0
| -n || Pituus ei ole 0
|-  
|-  
Rivi 139: Rivi 153:


Esimerkiksi seuraavat ehdot ovat tosia
Esimerkiksi seuraavat ehdot ovat tosia
<source lang="bash">
<syntaxhighlight lang="bash">
[ 2 -lt 5 ]
[ 2 -lt 5 ]
[ "moi" != "linux" ]
[ "moi" != "linux" ]
[ 54 -ge 53 ]
[ 54 -ge 53 ]
[ -f "/etc/fstab" ]
[ -f "/etc/fstab" ]
</source>
</syntaxhighlight>


== Silmukat ==
== Silmukat ==
Rivi 150: Rivi 164:
For-silmukka on näppärä monessa tapauksessa, tässä esimerkkinä hakemiston kaikkien tiedostojen läpikäynti.
For-silmukka on näppärä monessa tapauksessa, tässä esimerkkinä hakemiston kaikkien tiedostojen läpikäynti.


<source lang="bash">
<syntaxhighlight lang="bash">
for muuttuja in `ls`  
for muuttuja in `ls`  
do
do
  echo $muuttuja
    echo $muuttuja
done
done
</source>
</syntaxhighlight>
Silmukassa suoritettavat rivit laitetaan siis sanojen <tt>do</tt> ja <tt>done</tt> väliin. Laskurimuuttujaan sijoitetaan vuorotellen <tt>in</tt>:n jälkeen olevat sanat, esimerkiksi tässä tapauksessa konennon [[ls]] tuloste (eli hakemistossa olevien tiedostojen nimet). Ohjelman tuloste voidaan merkitä myös seuraavasti: <tt>$(komento)</tt>. Jos silmukalla on käytävä läpi kaikki kokonaisluvut tietyltä väliltä, voi käyttää komentoa [[seq]], joka tulostaa kokonaisluvut väliltä 1-annettu parametri. Esimerkiksi
Silmukassa suoritettavat rivit laitetaan siis sanojen <tt>do</tt> ja <tt>done</tt> väliin. Laskurimuuttujaan sijoitetaan vuorotellen <tt>in</tt>:n jälkeen olevat sanat, esimerkiksi tässä tapauksessa komennon [[ls]] tuloste (eli hakemistossa olevien tiedostojen nimet). Ohjelman tuloste voidaan merkitä myös seuraavasti: <tt>$(komento)</tt>. Jos silmukalla on käytävä läpi kaikki kokonaisluvut tietyltä väliltä, voi käyttää komentoa [[seq]], joka tulostaa kokonaisluvut väliltä 1-annettu parametri. Esimerkiksi
<source lang="bash">
<syntaxhighlight lang="bash">
echo "Lasketaan kymmeneen:"
echo "Lasketaan kymmeneen:"
for luku in $(seq 10)
for luku in $(seq 10)
do
do
  echo $luku
    echo $luku
done
done
</source>
</syntaxhighlight>


Läpi käytävä joukko voidaan merkitä myös syntaksilla <tt>{alku..loppu}</tt>. Jos esimerkiksi halutaan käydä läpi kaikki merkit c-o, kokeile vaikka kirjoittaa
Läpi käytävä joukko voidaan merkitä myös syntaksilla <tt>{alku..loppu}</tt>. Jos esimerkiksi halutaan käydä läpi kaikki merkit c-o, kokeile vaikka kirjoittaa
for muuttuja in {c..o}; { echo -n "$muuttuja "; sleep 1;}
<syntaxhighlight lang="bash">for muuttuja in {c..o}; { echo -n "$muuttuja "; sleep 1;}</syntaxhighlight>
 
=== While ===
=== While ===
While suorittaa lausekkeita niin kauan kuin ehto on tosi. Kun ehto on epätosi poistutaan loopista joilloin skriptin suoritus jatkuu seuraavalta loogiselta riviltä (while-lausekkeen jälkseiseltä riviltä).
While suorittaa lausekkeita niin kauan kuin ehto on tosi. Kun ehto on epätosi poistutaan loopista jolloin skriptin suoritus jatkuu seuraavalta loogiselta riviltä (while-lausekkeen jälkeiseltä riviltä).
<source lang="bash">
<syntaxhighlight lang="bash">
while [ ehto ]
while [ ehto ]
do
do
  lauseita
    lauseita
done
done


Esimerkki:
Esimerkki:
while [ -f "testi" ]
while [ -f "testi" ]
do
do
  echo "Tiedosto on olemassa."
    echo "Tiedosto on olemassa."
  sleep 1
    sleep 1
done
done
</source>
</syntaxhighlight>
Edellä oleva skripti tarkistaa, onko samassa hakemistossa oleva tiedosto <tt>testi</tt> olemassa. Tätä jatketaan niin kauan kunnes tiedostoa ei enää ole.
Edellä oleva skripti tarkistaa, onko samassa hakemistossa oleva tiedosto <tt>testi</tt> olemassa. Tätä jatketaan niin kauan kunnes tiedostoa ei enää ole.


=== Until ===
=== Until ===
Until on while:n vastakohta. Until-lauseke jatkaa suoritusta niin kauan kunnes ehto on tosi.  
Until on while:n vastakohta. Until-lauseke jatkaa suoritusta niin kauan kunnes ehto on tosi.  
<source lang="bash">
<syntaxhighlight lang="bash">
until [ ehto ]
until [ ehto ]
do
do
  lauseita
    lauseita
done
done
</source>
</syntaxhighlight>


== Funktiot ==
== Funktiot ==
Kuten "oikeissa" ohjelmointikielissä, myös bash-skripteissä on mahdollista käyttää funktioita seuraavalla tavalla
Kuten "oikeissa" ohjelmointikielissä, myös bash-skripteissä on mahdollista käyttää funktioita seuraavalla tavalla


<source lang="bash">
<syntaxhighlight lang="bash">
#!/bin/bash
#!/bin/bash
function Käyttis {
function Käyttis {
Rivi 205: Rivi 220:
Käyttis
Käyttis
echo $os
echo $os
</source>
</syntaxhighlight>


Tulostaisi "Linux".  
Tulostaisi "Linux".  


Funktio määritellään siis syntaksilla
Funktio määritellään siis syntaksilla
<source lang="bash">
<syntaxhighlight lang="bash">


function Funktio {
function Funktio {
  #koodi
  #koodi
}
}
</source>
</syntaxhighlight>
Jos halutaan skriptin toimivan myös [[Sh]]-komentotulkkia käytettäessä, funktion kanssa on käytettävä syntaksia
Jos halutaan skriptin toimivan myös [[Sh]]-komentotulkkia käytettäessä, funktion kanssa on käytettävä syntaksia
<source lang="bash">
<syntaxhighlight lang="bash">
Funktio() { ... }
Funktio() { ... }
</source>
</syntaxhighlight>


Jos muuttujia ei funktiossa erikseen määritellä yksityisiksi, ne ovat julkisia. Eli kun esimerkkiskriptissämme muutimme muuttujan $os arvoa funktiossa, tämä muutos näkyi myös funktion ulkopuolella. Muuttuja voidaan määritellä yksityiseksi avainsanalla <tt>local</tt>:
Jos muuttujia ei funktiossa erikseen määritellä yksityisiksi, ne ovat julkisia. Eli kun esimerkkiskriptissämme muutimme muuttujan $os arvoa funktiossa, tämä muutos näkyi myös funktion ulkopuolella. Muuttuja voidaan määritellä yksityiseksi avainsanalla <tt>local</tt>:


<source lang="bash">
<syntaxhighlight lang="bash">
#!/bin/bash
#!/bin/bash
function Käyttis {
function Käyttis {
Rivi 233: Rivi 248:
Käyttis
Käyttis
echo $os
echo $os
</source>
</syntaxhighlight>


Tulostaisi "Debian".
Tulostaisi "Debian".
Rivi 255: Rivi 270:
Kaikista Linux-järjestelmistä löytyviä ohjelmia on listattu luokkaan [[:Luokka:Komentorivin perustyökalut|Komentorivin perustyökalut]]. Näitä ohjelmia kannattaa selailla. Komentoriviohjelmia on listattu käyttötarkoituksen mukaan myös artikkelissa [[komentorivikomennot]].
Kaikista Linux-järjestelmistä löytyviä ohjelmia on listattu luokkaan [[:Luokka:Komentorivin perustyökalut|Komentorivin perustyökalut]]. Näitä ohjelmia kannattaa selailla. Komentoriviohjelmia on listattu käyttötarkoituksen mukaan myös artikkelissa [[komentorivikomennot]].


Esimerkkinä ladataan kaikki [[LinuCast]]-podcastin [[ogg]]-muotoiset jaksot käyttämällä jokaisesta järjestelmästä löytyviä peruskomentoja [[seq]] ja [[wget]]:
Esimerkkinä ladataan kaikki [[LinuCast]]-podcastin [[ogg]]-muotoiset jaksot käyttämällä jokaisesta järjestelmästä löytyviä peruskomentoja [[seq]] ja [[wget]]:  
  #!/bin/bash
 
for  i in `seq -f"%03g" 1 104`
  (esimerkin sivusto on kuollut ja kuopattu, joten koodi ei toimi)
do
 
<syntaxhighlight lang="bash">
#!/bin/bash
# linucast.sh - LinuCast-podcastin latausskripti
for  i in `seq -f"%03g" 1 104`
do
     wget -c "http://koskisuomi.pp.fi/linucast/LinuCast$i.ogg"
     wget -c "http://koskisuomi.pp.fi/linucast/LinuCast$i.ogg"
done
done
</syntaxhighlight>
 
Esimerkkiohjelma voidaan tallentaa vaikka nimelle <tt>linuxcast.sh</tt> ja sille voidaan antaa [[chmod|suoritusoikeudet]] komennolla
Esimerkkiohjelma voidaan tallentaa vaikka nimelle <tt>linuxcast.sh</tt> ja sille voidaan antaa [[chmod|suoritusoikeudet]] komennolla
  chmod u+rx linucast.sh
  chmod u+rx linucast.sh
Rivi 268: Rivi 290:
*1 tarkoittaa että mistä numerosta aloitetaan
*1 tarkoittaa että mistä numerosta aloitetaan
*104 tarkoittaa kuinka monta jaksoa haetaan, lukua voi kasvattaa jaksojen lisääntyessä.
*104 tarkoittaa kuinka monta jaksoa haetaan, lukua voi kasvattaa jaksojen lisääntyessä.
Esimerkki ohjelmana 2. Ladataan kaikki Full Circle magazinen englanninkieliset pdf-tiedostot palvelimelta. Esimerkissä on käytetty Bash skriptaus koodeja joita löytyy esimerkiksi tältä sivulta.
<syntaxhighlight lang="bash">
#!/bin/bash
# issueLataaja.sh - Ubuntu-aiheisen verkkojulkaisu Full Circle:n artikkelilataaja, kerää ne kaikki!
# Tyhjennetään ruutu
clear
# Haetaan kaikki Full Circlen artikkelit ensimmäisestä beta-julkaisusta (0) kaikkein uusimpaan asti.
# Listataan julkaisut verkkosivulta, joista viimeisin tallennetaan muuttujaksi.
viimeisin_julkaisu=$(curl -s https://fullcirclemagazine.org/downloads/ | grep -oP '(?<=Issue )[0-9]+' | tail -1);
for luku in $(seq 0 $viimeisin_julkaisu)
do
  FILE="issue"$luku"_en.pdf"
# Tarkistetaan onko tiedosto jo olemassa, ennen kuin ladataan se. 
if [ -f $FILE ]; then
  echo " '$FILE' tiedosto on olemassa."
else
  echo " '$FILE' tiedostoa ei ole olemassa. Ladataan se..."
  wget "https://dl.fullcirclemagazine.org/$FILE"
# Pidetään 5 sekunnin tauko latausten välissä, mukana laskuri
for (( i=5; i>0; i--)); do
    sleep 1 &
    printf "\b\b$i"   
    wait
done
fi
done
echo "Lataus valmis"
</syntaxhighlight>
Esimerkkiohjelma voidaan tallentaa vaikka nimelle <tt>issueLataaja.sh</tt> ja sille voidaan antaa [[chmod|suoritusoikeudet]] komennolla
chmod u+rx issueLataaja.sh
Tämän jälkeen komentojono ajettaisiin komennolla
./issueLataaja.sh


== Katso myös ==
== Katso myös ==
*[[Komentorivin perusteet]]
*[[Komentorivin perusteet]]
*[[Komentorivivinkkejä]]
*[[Komentorivivinkkejä]]
*[[ShellCheck]] on ohjelma, joka havaitsee kaikki [[sh]] ja [[bash]]-skriptien ongelmat ja antaa niille parannusehdotukset.
*[[Ohjelmointikielet]] ja erityisesti [[Python]]


==Aiheesta muualla==
==Aiheesta muualla==
*[http://tldp.org/LDP/abs/html/ Advanced Bash-Scripting Guide] - laaja englanninkielinen opas bash-skriptaukseen
*[https://tldp.org/LDP/abs/html/ Advanced Bash-Scripting Guide] - laaja englanninkielinen opas bash-skriptaukseen
*[http://www.panix.com/~elflord/unix/bash-tute.html Pikaopas bash-skriptaukseen] (englanniksi)
*[https://www.panix.com/~elflord/unix/bash-tute.html Pikaopas bash-skriptaukseen] (englanniksi)
*[http://gd.tuwien.ac.at/linuxcommand.org/writing_shell_scripts.php Writing shell scripts] - toinen laaja englanninkielinen opas bash-skriptaukseen
*[https://web.archive.org/web/20170610153335/https://gd.tuwien.ac.at/linuxcommand.org/writing_shell_scripts.php Writing shell scripts] - toinen laaja englanninkielinen opas bash-skriptaukseen - {{InternetArchive}}
*[https://www.shellcheck.net/ ShellCheck] on www-ohjelma, joka havaitsee kaikki [[sh]] ja [[bash]]-skriptien ongelmat ja antaa niille parannusehdotukset.
*[https://explainshell.com/ ExplainShell] on www-ohjelma, joka antaa ohjetekstin annetuille komennoille.
*[https://mywiki.wooledge.org/BashPitfalls Bash Pitfalls] yleisimmät bash-skriptauksen sudenkuopat.
 




[[Luokka:Komentorivi]]
[[Luokka:Komentorivi]]
[[Luokka:Ohjeet]]
[[Luokka:Ohjeet]]

Nykyinen versio 2. heinäkuuta 2024 kello 10.32

Komentorivi on jo yksinään monipuolinen työkalu, mutta skriptien avulla on mahdollista toteuttaa huomattavasti monipuolisempia prosesseja pienellä vaivalla. Tässä oppaassa käsitellään skriptien kirjoittamista Bash-komentotulkille.

Kirjoittaaksesi käyttöjärjestelmäriippumattomia skriptejä on syytä kirjoittaa skriptit POSIX-yhteensopivina POSIX-skripteinä.

Alkuun[muokkaa]

Skripti aloitetaan rivillä

#!/bin/bash

Joka kertoo, että skripti suoritetaan käyttäen bashia riippumatta siitä, mitä komentotulkkia käyttäjä käyttää ajaessaan skriptin. Huomaa, että vaikka rivi alkaa #-merkillä, se ei ole kommentti. Muualla skriptissä #:llä alkavat rivit ovat kommentteja, eikä niitä huomioida.

Skriptejä ei kuitenkaan ole pakko kirjoittaa erilliseen tiedostoon, vaan ne voi kirjoittaa myös suoraan komentoriville. Tällöin eri komentojen väliin laitetaan erottimeksi puolipiste (;).

Ensimmäinen skripti[muokkaa]

Tehdään aluksi yksinkertainen skripti, joka esittelee muutamia perustoimintoja:

#!/bin/bash
echo "Hei, $(whoami), mitä kuuluu"
echo "Olet hakemistossa $(pwd), tiedostolistaus:"
ls

Kuten huomaat, skripteissä käytetään tavallisia komentorivikomentoja, jotka sitten suoritetaan järjestyksessä. Toisaalta kuten myöhemmin huomaamme, skriptit tarjoavat paljon enemmän mahdollisuuksia kuin pelkkä komentojen näpyttely konsoliin.

Tallenna skripti vaikka nimellä eka.sh (sh-päätettä käytetään yleensä skriptien kanssa), anna sille suoritusoikeudet ja aja skripti, jolloin tulostus on suunnilleen seuraavanlainen:

Hei, käyttäjä, mitä kuuluu
Olet hakemistossa /home/kayttaja/ohjelmointi/skriptit, tiedostolistaus:
eka.sh

Esimerkistä nähdään heti muutama perusasia. Ensinnäkin toisella rivillä käytetään ohjelmaa whoami, joka tulostaa käyttäjänimen. Kun ohjelma on $()-merkinnän sisällä, kyseiseen kohtaan "kopioidaan" ajetun ohjelman tuloste.

Toisella rivillä käytetään muuttujaa. Muuttujien edessä on dollarimerkki ($), ja niitä voidaan tunkea vaikka merkkijonojen (jotka erotetaan lainausmerkillä) sisälle. Muuttujia käsitellään tarkemmin myöhemmin. Esimerkissä käyttämämme muuttuja $PWD on ympäristömuuttuja, jonka arvona on aina se hakemisto, jossa käyttäjä on. Voit kokeilla tätä esimerkiksi kirjoittamalla komentoriville komennon echo $PWD.

Viimeisellä rivillä ajetaan normaalisti komentoriviohjelma ls. Voit myös kokeilla korvata tämän rivin rivillä

echo "`ls`"

Merkintä $() voidaan kirjoittaa myös ``, kuten alla esimerkissä. Tällöin kuitenkaan ei voi käyttää sisäkkäisiä komentoja.

Skripti voitaisiin myös kirjoittaa suoraan komentoriville muodossa

echo "Hei, `whoami`, mitä kuuluu"; echo "Olet hakemistossa $PWD, tiedostolistaus:"; ls;

Muuttujat[muokkaa]

Muuttujat määritellään syntaksilla

nimi=arvo

ja niihin viitataan laittamalla muuttujan eteen $

$nimi

Siinä tapauksessa mikäli halutaan, että komennon tulos on muuttuja asetetaan muuttuja tyyliin:

nimi=("komennon nimi ja parametrit")

Tapauksia, joissa käyttäjän tarkoittama muuttuja on epäselvä, tulee käyttää aaltosulkuja muuttujan ympärillä

${foo}bar

kun halutaan tulostaa teksti bar muuttujan foo jälkeen.

Ensimmäisen skriptimme tapauksessa käytimme jo ympäristömuuttujaa $PWD echo:n kanssa. Tehdäänpä samantyyppinen skripti nyt käyttäen itse määrittelemäämme muuttujaa:

#!/bin/bash
HEI="Hei, `whoami`, mitä kuuluu?"
echo $HEI

Kuten huomaat, kun muuttujaan sijoitetaan arvo, voidaan käyttää samoja "kikkoja" kuin muuallakin skriptissä, esimerkiksi tässä tapauksessa sijoitamme muuttujaan merkkijonon jonka sisällä on ohjelman whoami tuloste.

Huomaa, että yhtäsuuruusmerkin on oltava kiinni muuttujan nimessä ja arvossa, eli seuraavat muodot eivät käy:

MUUTTUJA = "terve vaan"
MUUTTUJA= "moi"
MUUTTUJA ="moi"

Lisäksi muuttujaan sijoitettavan arvon on oltava lainausmerkkien sisällä, jos siihen kuuluu välilyönti. Yksittäisen sanan tai numeron voi sijoittaa ilman lainausmerkkejä:

numero=43

Ehtolauseet[muokkaa]

Ehdollisia rakenteita luodaan bashille if, then, else ja fi -avainsanoilla. Rakenteen syntaksi on seuraava:

if [ ehto ]
then
    lauseita
elif [ toinen ehto ]
then
    lauseita
else
    muita lauseita
fi

Ehdot merkitään hakasulkeiden sisään esimerkiksi seuraavalla tavalla

#!/bin/bash
if [ $PWD = "/" ]
then
    echo "Tämä skripti suoritetaan juurihakemistossa";
else
    echo "Skripti suoritetaan hakemistossa $PWD";
fi

Yhden rivin ehtolauseet[muokkaa]

Lyhyiden skriptien kanssa.

[ ehto ] && lauseita || [ toinen ehto ] && lauseita || muita lauseita

[ $PWD = "/" ] && printf "\nTämä skripti suoritetaan juurihakemistossa\n" || printf "\nSkripti suoritetaan hakemistossa %s\n" "$PWD"

Tässä käytetään vertailuoperaattoria =, joka on tosi, jos merkkijonot ovat samat. Muita vertailuoperaattoreita ovat

Operaattori Kuvaus
! Negaatio-operaattori, "Onko seuraava ehto epätosi?"
-n Pituus ei ole 0
-z Pituus on 0
-d Hakemisto on olemassa
-f Tavallinen tiedosto on olemassa
-r Onko tiedostoon lukuoikeus
-w Onko tiedostoon kirjoitusoikeus
-x Onko tiedostoon ajo-oikeus
-eq Kokonaisluvut ovat yhtäsuuret (a = b)
-ne Kokonaisluvut eivät ole yhtä suuret (a != b)
= Merkkijonot ovat samat (myös ==)
!= Merkkijonot eivät ole samat
-lt Kokonaisluku on pienempi kuin toinen
-gt Kokonaisluku on suurempi kuin toinen (a > b)
-le Kokonaisluku on pienempi tai yhtäsuuri kuin toinen (a <= b)
-ge Kokonaisluku on suurempi tai yhtäsuuri kuin toinen (a >= b)

Esimerkiksi seuraavat ehdot ovat tosia

[ 2 -lt 5 ]
[ "moi" != "linux" ]
[ 54 -ge 53 ]
[ -f "/etc/fstab" ]

Silmukat[muokkaa]

For[muokkaa]

For-silmukka on näppärä monessa tapauksessa, tässä esimerkkinä hakemiston kaikkien tiedostojen läpikäynti.

for muuttuja in `ls` 
do
    echo $muuttuja
done

Silmukassa suoritettavat rivit laitetaan siis sanojen do ja done väliin. Laskurimuuttujaan sijoitetaan vuorotellen in:n jälkeen olevat sanat, esimerkiksi tässä tapauksessa komennon ls tuloste (eli hakemistossa olevien tiedostojen nimet). Ohjelman tuloste voidaan merkitä myös seuraavasti: $(komento). Jos silmukalla on käytävä läpi kaikki kokonaisluvut tietyltä väliltä, voi käyttää komentoa seq, joka tulostaa kokonaisluvut väliltä 1-annettu parametri. Esimerkiksi

echo "Lasketaan kymmeneen:"
for luku in $(seq 10)
do
    echo $luku
done

Läpi käytävä joukko voidaan merkitä myös syntaksilla {alku..loppu}. Jos esimerkiksi halutaan käydä läpi kaikki merkit c-o, kokeile vaikka kirjoittaa

for muuttuja in {c..o}; { echo -n "$muuttuja "; sleep 1;}

While[muokkaa]

While suorittaa lausekkeita niin kauan kuin ehto on tosi. Kun ehto on epätosi poistutaan loopista jolloin skriptin suoritus jatkuu seuraavalta loogiselta riviltä (while-lausekkeen jälkeiseltä riviltä).

while [ ehto ]
do
    lauseita
done

Esimerkki:
while [ -f "testi" ]
do
    echo "Tiedosto on olemassa."
    sleep 1
done

Edellä oleva skripti tarkistaa, onko samassa hakemistossa oleva tiedosto testi olemassa. Tätä jatketaan niin kauan kunnes tiedostoa ei enää ole.

Until[muokkaa]

Until on while:n vastakohta. Until-lauseke jatkaa suoritusta niin kauan kunnes ehto on tosi.

until [ ehto ]
do
    lauseita
done

Funktiot[muokkaa]

Kuten "oikeissa" ohjelmointikielissä, myös bash-skripteissä on mahdollista käyttää funktioita seuraavalla tavalla

#!/bin/bash
function Käyttis {
        os="Linux"
}
os="Windows"
#Kutsutaan funktiota
Käyttis
echo $os

Tulostaisi "Linux".

Funktio määritellään siis syntaksilla

function Funktio {
 #koodi
}

Jos halutaan skriptin toimivan myös Sh-komentotulkkia käytettäessä, funktion kanssa on käytettävä syntaksia

Funktio() { ... }

Jos muuttujia ei funktiossa erikseen määritellä yksityisiksi, ne ovat julkisia. Eli kun esimerkkiskriptissämme muutimme muuttujan $os arvoa funktiossa, tämä muutos näkyi myös funktion ulkopuolella. Muuttuja voidaan määritellä yksityiseksi avainsanalla local:

#!/bin/bash
function Käyttis {
        local os        # os paikallinen muuttuja
        os="Gentoo"
}
os="Debian"
#Kutsutaan funktiota
Käyttis
echo $os

Tulostaisi "Debian".

Vinkkejä[muokkaa]

Joukot[muokkaa]

Käytimme jo aiemmin merkintätapaa {1..4} merkitsemään joukkoa, johon kuuluu kaikki välin merkit (esimerkissä 1,2,3,4). Tämä ominaisuus on kuitenkin monipuolisempi. Esimerkiksi jos haluamme luoda Matille, Martalle ja Jormalle työ- ja kotihakemistot, voisimme kirjoittaa lyhyesti näin

mkdir {ma{ti,rta},jorma}n_{työ,koti}hakemisto

Jolloin luotaisiin hakemistot matin_työhakemisto, matin_kotihakemisto, martan_työhakemisto, martan_kotihakemisto, jorman_työhakemisto ja jorman_kotihakemisto.

Puretaanpa hieman tuota komentoa. ma{ti,rta} tuottaa sanat mati ja marta. Kun joukon merkinnän ulkopuolella on n, liitetään jokaisen joukon sisällä olevan alkion perään n, jolloin alaviivaa edellä oleva osuus tuottaa sanat matin, martan ja jorman. Jälkimmäinen osuus toimii samalla tavalla, sanojen työ ja koti perään liitetään sana hakemisto. Näin saamme lyhyellä komennolla aikaan paljon.

Tärkeä huomio on, että {}-joukon tulkitsee bash-komentotulkki eikä ohjelma, jonka yhteydessä {}-joukkoa käytetään. Käytännössä tämä tarkoittaa, että ensin bash ikään kuin avaa joukon ja vasta sen jälkeen suorittaa komentorivin. Tässä esimerkissä mkdir-ohjelma saa parametreikseen vain listan luotavista hakemistoista eikä mkdir edes tiedä, että käytettiin {}-joukkoa:

mkdir matin_työhakemisto matin_kotihakemisto martan_työhakemisto martan_kotihakemisto jorman_työhakemisto jorman_kotihakemisto

Tässä huomataan myös, että komentoja voi käyttää aivan normaalien komentoriviohjelmien kanssa, sillä bash käsittelee syötteen, ja suorittaa skriptit antaen ohjelmalle syötteenä skriptin tulosteen.

Hyödyllisiä ohjelmia[muokkaa]

Unixin filosofian mukaisesti Linuxissa on lukuisia ohjelmia, jotka hoitavat jonkin yksittäisen tehtävän ja tekevät sen hyvin. Näitä pikkuohjelmia käytetäänkin usein skripteissä hoitamaan erilaisia tehtäviä.

Kaikista Linux-järjestelmistä löytyviä ohjelmia on listattu luokkaan Komentorivin perustyökalut. Näitä ohjelmia kannattaa selailla. Komentoriviohjelmia on listattu käyttötarkoituksen mukaan myös artikkelissa komentorivikomennot.

Esimerkkinä ladataan kaikki LinuCast-podcastin ogg-muotoiset jaksot käyttämällä jokaisesta järjestelmästä löytyviä peruskomentoja seq ja wget:

(esimerkin sivusto on kuollut ja kuopattu, joten koodi ei toimi)
#!/bin/bash
# linucast.sh - LinuCast-podcastin latausskripti
for  i in `seq -f"%03g" 1 104`
do
    wget -c "http://koskisuomi.pp.fi/linucast/LinuCast$i.ogg"
done

Esimerkkiohjelma voidaan tallentaa vaikka nimelle linuxcast.sh ja sille voidaan antaa suoritusoikeudet komennolla

chmod u+rx linucast.sh

Tämän jälkeen komentojono ajettaisiin komennolla

./linucast.sh
  • 1 tarkoittaa että mistä numerosta aloitetaan
  • 104 tarkoittaa kuinka monta jaksoa haetaan, lukua voi kasvattaa jaksojen lisääntyessä.

Esimerkki ohjelmana 2. Ladataan kaikki Full Circle magazinen englanninkieliset pdf-tiedostot palvelimelta. Esimerkissä on käytetty Bash skriptaus koodeja joita löytyy esimerkiksi tältä sivulta.

#!/bin/bash
# issueLataaja.sh - Ubuntu-aiheisen verkkojulkaisu Full Circle:n artikkelilataaja, kerää ne kaikki!

# Tyhjennetään ruutu
clear

# Haetaan kaikki Full Circlen artikkelit ensimmäisestä beta-julkaisusta (0) kaikkein uusimpaan asti.

# Listataan julkaisut verkkosivulta, joista viimeisin tallennetaan muuttujaksi.
viimeisin_julkaisu=$(curl -s https://fullcirclemagazine.org/downloads/ | grep -oP '(?<=Issue )[0-9]+' | tail -1);

for luku in $(seq 0 $viimeisin_julkaisu)
do
  FILE="issue"$luku"_en.pdf"

# Tarkistetaan onko tiedosto jo olemassa, ennen kuin ladataan se.  
if [ -f $FILE ]; then
   echo " '$FILE' tiedosto on olemassa."
else
   echo " '$FILE' tiedostoa ei ole olemassa. Ladataan se..."
   wget "https://dl.fullcirclemagazine.org/$FILE"

# Pidetään 5 sekunnin tauko latausten välissä, mukana laskuri

for (( i=5; i>0; i--)); do
    sleep 1 &
    printf "\b\b$i"    
    wait
done
fi
done
echo "Lataus valmis"

Esimerkkiohjelma voidaan tallentaa vaikka nimelle issueLataaja.sh ja sille voidaan antaa suoritusoikeudet komennolla

chmod u+rx issueLataaja.sh

Tämän jälkeen komentojono ajettaisiin komennolla

./issueLataaja.sh

Katso myös[muokkaa]

Aiheesta muualla[muokkaa]