.\" # -------------------------------------------------------------------------
.\" # Man-pagina voor kzrestore.
.\" #
.\" # Geschreven door Karel Zimmer <info@karelzimmer.nl>.
.\" #
.\" # Auteursrecht (c) 2019-2021 Karel Zimmer.
.\" # Creative Commons Naamsvermelding-GelijkDelen Internationaal-licentie
.\" # <https://creativecommons.org/licenses/by-sa/4.0/>.
.\" #
.\" # RelNum=04.01.01
.\" # RelDat=2021-01-11
.\" # -------------------------------------------------------------------------
.\"
.TH KZRESTORE 1 "" "kzscripts 365"

.SH NAAM
kzrestore \- backup terugzetten

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

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

Standaard, tenzij \fISELECTIE\fRs zijn opgegeven, wordt alles in de backup
teruggezet.

Met \fISELECTIE\fR kan een selectie van mappen en bestanden worden teruggezet.
.br
Er wordt in de backup gezocht met jokertekens (*), dus als bijvoorbeeld
'python' als \fISELECTIE\fR wordt opgegeven, dan wordt zowel
'/home/USER/python' als '/home/USER/Documenten/python.odt' teruggezet.

Voor het terugzetten van de backup wordt tar gebruikt.
.br
De inhoud van de backup is op te vragen met opdracht:
.RS
\fBtar\fR tvf \fIBESTAND\fR [--wildcards \fISELECTIE\fR...]
.RE

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

Er wordt gezocht naar een backup met de naam "backup-<computernaam>-*.tar".

Standaard wordt de backup 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.

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
\fBBackup terugzetten\fR.
.br
Dan wordt alles in de backup teruggezet (e.g. alle Persoonlijke mappen).

.SH OPTIES
.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 backups 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 backups vanaf deze map
opgezocht.
.RE

.SH BESTANDEN
/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 backup terug.
Hiervoor is ook starter 'Backup 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 (c) 2007-2021 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

.SH BESCHIKBAARHEID
Opdracht kzrestore is onderdeel van het pakket kzscripts en is beschikbaar
vanaf Karel Zimmer Linux Scripts
⟨https://karelzimmer.nl/html/linux.html#scripts⟩.

.\" # EOF