.\" ----------------------------------------------------------------------------
.\" Man-pagina voor kzrestore.
.\"
.\" Geschreven door Karel Zimmer <info@karelzimmer.nl>.
.\"
.\" Auteursrecht © 2019-2020 Karel Zimmer.
.\" Creative Commons Naamsvermelding-GelijkDelen Internationaal-licentie
.\" <https://creativecommons.org/licenses/by-sa/>.
.\"
.\" RelNum=03.02.02
.\" RelDat=2020-10-04
.\" RelMsg='Scriptspakket versie 365'
.\" ----------------------------------------------------------------------------
.\"
.TH "KZRESTORE" "1" "" "kzscripts 365" "kzrestore"

.SH NAAM
kzrestore \- Back-up terugzetten

.SH SAMENVATTING
.B kzrestore
[OPTIE...] [--] [\fISELECTIE\fR...]

.SH BESCHRIJVING
\fBkzrestore\fR zet bestanden en mappen terug uit een back-up (reservekopie).

Standaard, tenzij \fISELECTIE\fRs zijn opgegeven, wordt alles in de back-up
teruggezet.

Standaard worden back-ups gezocht vanaf /media.
Met optie \fB--source\fR (\fB-s\fR) kan een andere locatie opgegeven worden.

Er wordt gezocht naar een back-up met de naam "backup-COMPUTERNAAM-*.tar".

Standaard wordt de back-up teruggezet in map / (originele plek).
Met optie \fB--target\fR (\fB-t\fR) kan een andere locatie opgegeven worden.

Standaard worden de volgende bestanden NIET teruggezet:
.RS
/home/*/.bash_logout
.br
/home/*/examples.desktop
.br
/home/*/.bashrc
.br
/home/*/.profile
.RE

Met optie \fB--exclude\fR (\fB-e\fR) zijn extra bestanden en mappen uit te
sluiten.

Voor het uitpakken van de back-up wordt tar gebruikt.
De inhoud van de back-up is op te vragen met opdracht:
\fBtar tvf \fIBESTAND\fR\fB [--wildcards \fISELECTIE\fR\fB...]\fR

Met opdracht \fBkzbackup\fR (en \fBkzbackup\fR) zijn individuele -of alle-
bestanden en mappen te bewaren in een enkel archiefbestand.

In een grafische werkomgeving zoals GNOME (e.g. Ubuntu) kan \fBkzrestore\fR
worden gestart door te zoeken naar \fBback\fR, klik op
\fBBack-up terugzetten\fR.
.br
Dan wordt alles in de back-up teruggezet (e.g. alle Persoonlijke mappen).

.SH OPTIES
Lange opties kunnen worden afgekort, zolang de afkorting uniek blijft.

Een argument dat verplicht of optioneel is voor een lange optie, is dat ook voor
de overeenkomstige korte optie.
.TP
\fB-e\fR, \fB--exclude=\fIUITSLUITEN\fR
Sluit bestanden of mappen \fIUITSLUITEN\fR uit.
Mag meerdere keren opgegeven worden.
.TP
\fB-s\fR, \fB--source=\fIBRONMAP\fR
Zoek back-ups vanaf de \fIBRONMAP\fR.
.TP
\fB-t\fR, \fB--target=\fIDOELMAP\fR
Zet bestanden en mappen terug in de \fIDOELMAP\fR.
.TP
\fB-d\fR, \fB--debug\fR
Geef foutopsporingsinformatie weer in het logboek (gebruik 'journalctl -ab
-t kzrestore').
.TP
\fB-g\fR, \fB--gui\fR
Start in grafische modus (gui = graphical user interface).
.TP
\fB-h\fR, \fB--help\fR
Toon een een korte omschrijving van de beschikbare opties.
.TP
\fB-u\fR, \fB--usage\fR
Toon de beschikbare opties.
.TP
\fB-v\fR, \fB--version\fR
Toon de versie, de auteur, en het auteursrecht.
.TP
\fB--\fR
Een -- geeft het einde van de opties aan en schakelt de verdere verwerking van
opties uit.
Alle argumenten na de -- worden behandeld als bestandsnamen en argumenten.
Een argument van - is gelijk aan --.

.SH STOPSTATUS
Normaal wordt afsluitwaarde 0 teruggegeven; als er een fout optreedt, is de
afsluitwaarde 1.
Als er een waarschuwing optreedt, is de afsluitwaarde 2.

.SH MAPPEN
/media
.RS
Als er geen \fIBRON\fR is opegegeven worden de back-ups vanaf deze map
opgezocht.
.RE

/
.RS
Als er geen \fIDOEL\fR is opegegeven wordt de back-up in deze map teruggezet.
.RE

.SH BESTANDEN
/usr/bin/kzcommon.sh
.RS
Scripts variabelen en functies.
.RE

/usr/share/applications/kzrestore
.RS
Bureaublad-configuratiebestand.
.RE

/usr/share/bash-completion/completions/kzrestore
.RS
Tab-completion-script.
.RE

/usr/share/polkit-1/actions/nl.karelzimmer.kzrestore.policy
.RS
PolicyKit actiedefinitiebestand.
.RE

/root/.kzrestore-exclude-dflt
.RS
Standaard uit te sluiten bestanden en mappen.
.RE

/root/.kzrestore-exclude-opt
.RS
Opgegeven uit te sluiten bestanden en mappen.
.RE

.SH NOTITIES
.IP " 1." 4
Checklist installatie
.RS 4
https://karelzimmer.nl
.RE

.SH VOORBEELDEN

\fBkzrestore\fR
.RS
Zet alles in de back-up terug.
Hiervoor is ook starter 'Back-up terugzetten' beschikbaar.
.RE

\fBkzrestore --target /tmp /home/*/Documenten\fR
.RS
Zet alle documenten terug in map /tmp.
.RE

\fBkzrestore --exclude '*.JPG' /home/*/Afbeeldingen\fR
.RS
Zet alle foto's terug, maar geen JPG's.
.RE

.SH AUTEUR
Geschreven door Karel Zimmer <info@karelzimmer.nl>.

.SH AUTEURSRECHT
Auteursrecht © 2007-2020 Karel Zimmer.
.br
GNU Algemene Publieke Licentie <https://www.gnu.org/licenses/gpl.html>.

.SH ZIE OOK
\fBkzbackup\fR(1),
\fBkzcheckname\fR(1),
\fBkzcommon.sh\fR(1),
\fBkzmenu\fR(1),
\fBhttps://karelzimmer.nl\fR

.\" EOF