Skip to content
API Documentation
BastionGuard™
SnapshotBackendBox Class Reference
Inheritance diagram for SnapshotBackendBox:

Public Member Functions

signal void type_changed ()
 SnapshotBackendBox (Gtk.Window _parent_window)
void init_backend ()
void refresh ()

Private Member Functions

void build_ui ()
void add_opt_rsync (Gtk.Box hbox)
void add_opt_btrfs (Gtk.Box hbox)
bool check_for_btrfs_tools ()
void add_description ()
void update_description ()

Private Attributes

Gtk.CheckButton opt_rsync
Gtk.CheckButton opt_btrfs
Gtk.Label lbl_description
Gtk.Window parent_window

Detailed Description

Definition at line 35 of file SnapshotBackendBox.vala.

Constructor & Destructor Documentation

◆ SnapshotBackendBox()

SnapshotBackendBox.SnapshotBackendBox ( Gtk.Window _parent_window)
inline

Definition at line 44 of file SnapshotBackendBox.vala.

44 {
45
46 log_debug("SnapshotBackendBox: SnapshotBackendBox()");
47
48 //base(Gtk.Orientation.VERTICAL, 6); // issue with vala
49 GLib.Object(orientation: Gtk.Orientation.VERTICAL, spacing: 6); // work-around
50 parent_window = _parent_window;
51 margin_top = 12;
52 margin_bottom = 12;
53 margin_start = 12;
54 margin_end = 12;
55
56 build_ui();
57
58 refresh();
59
60 log_debug("SnapshotBackendBox: SnapshotBackendBox(): exit");
61 }
TeeJee.Logging.log_debug
void log_debug(string message)
Definition TeeJee.Logging.vala:118

References build_ui(), TeeJee.Logging.log_debug(), parent_window, and refresh().

Referenced by SettingsWindow.build_pages(), and SetupWizardWindow.build_pages().

Member Function Documentation

◆ add_description()

void SnapshotBackendBox.add_description ( )
inlineprivate

Definition at line 143 of file SnapshotBackendBox.vala.

143 {
144
145 Gtk.Expander expander = new Gtk.Expander(_("Help"));
146 expander.use_markup = true;
147 expander.margin_top = 12;
148 this.append(expander);
149
150 // scrolled
151 var scrolled = new Gtk.ScrolledWindow();
152 scrolled.margin_top = 6;
153 //scrolled.expand = true;
154 scrolled.set_size_request(-1,200);
155 scrolled.hscrollbar_policy = Gtk.PolicyType.NEVER;
156 scrolled.vscrollbar_policy = Gtk.PolicyType.AUTOMATIC;
157 expander.set_child(scrolled);
158
159 var lbl = new Gtk.Label("");
160 lbl.set_use_markup(true);
161 lbl.xalign = (float) 0.0;
162 lbl.yalign = (float) 0.0;
163 lbl.wrap = true;
164 lbl.wrap_mode = Pango.WrapMode.WORD;
165 lbl.margin_start = 12;
166 lbl.margin_end = 12;
167 lbl.margin_top = 12;
168 lbl.margin_bottom = 12;
169 lbl.vexpand = true;
170 scrolled.set_child(lbl);
171
172 lbl_description = lbl;
173 }
_
#define _(s)
Definition BastionGuard-mailproxy.cpp:47

References _, and lbl_description.

Referenced by build_ui().

◆ add_opt_btrfs()

void SnapshotBackendBox.add_opt_btrfs ( Gtk.Box hbox)
inlineprivate

Definition at line 96 of file SnapshotBackendBox.vala.

96 {
97
98 var opt = new Gtk.CheckButton.with_label(_("BTRFS"));
99 opt.set_group(opt_rsync);
100 opt.set_tooltip_markup(_("Create snapshots using BTRFS"));
101 hbox.append(opt);
102 opt_btrfs = opt;
103
104 if (!check_for_btrfs_tools()) {
105 opt.sensitive = false;
106 opt_rsync.active = true;
107 }
108
109 opt_btrfs.toggled.connect(()=>{
110 if (opt_btrfs.active){
111 App.btrfs_mode = true;
112 init_backend();
113 type_changed();
114 update_description();
115 }
116 });
117 }
SnapshotBackendBox.opt_rsync
Gtk.CheckButton opt_rsync
Definition SnapshotBackendBox.vala:37
SnapshotBackendBox.opt_btrfs
Gtk.CheckButton opt_btrfs
Definition SnapshotBackendBox.vala:38
SnapshotBackendBox.type_changed
signal void type_changed()

References _, check_for_btrfs_tools(), init_backend(), opt_btrfs, opt_rsync, type_changed(), and update_description().

Referenced by build_ui().

◆ add_opt_rsync()

void SnapshotBackendBox.add_opt_rsync ( Gtk.Box hbox)
inlineprivate

Definition at line 78 of file SnapshotBackendBox.vala.

78 {
79
80 var opt = new Gtk.CheckButton.with_label(_("RSYNC"));
81 opt.set_tooltip_markup(_("Create snapshots using RSYNC tool and hard-links"));
82 hbox.append(opt);
83 opt_rsync = opt;
84
85 opt_rsync.toggled.connect(()=>{
86 if (opt_rsync.active){
87 App.btrfs_mode = false;
88 Main.first_snapshot_size = 0;
89 init_backend();
90 type_changed();
91 update_description();
92 }
93 });
94 }

References _, Main.first_snapshot_size, init_backend(), opt_rsync, type_changed(), and update_description().

Referenced by build_ui().

◆ build_ui()

void SnapshotBackendBox.build_ui ( )
inlineprivate

Definition at line 63 of file SnapshotBackendBox.vala.

63 {
64
65 add_label_header(this, _("Select Snapshot Type"), true);
66
67 var vbox = new Gtk.Box(Gtk.Orientation.VERTICAL, 6);
68 //hbox.homogeneous = true;
69 append(vbox);
70
71 add_opt_rsync(vbox);
72
73 add_opt_btrfs(vbox);
74
75 add_description();
76 }
SnapshotBackendBox.add_opt_btrfs
void add_opt_btrfs(Gtk.Box hbox)
Definition SnapshotBackendBox.vala:96
SnapshotBackendBox.add_opt_rsync
void add_opt_rsync(Gtk.Box hbox)
Definition SnapshotBackendBox.vala:78

References _, add_description(), add_opt_btrfs(), and add_opt_rsync().

Referenced by SnapshotBackendBox().

◆ check_for_btrfs_tools()

bool SnapshotBackendBox.check_for_btrfs_tools ( )
inlineprivate

Definition at line 119 of file SnapshotBackendBox.vala.

119 {
120 try {
121 const string args[] = {"lsblk", "-o", "FSTYPE", null};
122 var proc = new Subprocess.newv(
123 args,
124 SubprocessFlags.STDOUT_PIPE | SubprocessFlags.STDERR_SILENCE
125 );
126
127 Bytes stdout;
128 if (proc.communicate(null, null, out stdout, null)) {
129 string output = (string) Bytes.unref_to_data(stdout);
130
131 if (output.contains("btrfs")) {
132 return true;
133 }
134 }
135 }
136 catch (Error e) {
137 log_error (e.message);
138 }
139
140 return false;
141 }
TeeJee.Logging.log_error
void log_error(string message, bool highlight=false, bool is_warning=false)
Definition TeeJee.Logging.vala:74

References Error, and TeeJee.Logging.log_error().

Referenced by add_opt_btrfs().

◆ init_backend()

void SnapshotBackendBox.init_backend ( )
inline

Definition at line 213 of file SnapshotBackendBox.vala.

213 {
214
215 App.try_select_default_device_for_backup(parent_window);
216 }
App
Main App
Definition AppConsole.vala:38
Main.try_select_default_device_for_backup
void try_select_default_device_for_backup(Gtk.Window? parent_win)
Definition Main.vala:4110

References App, parent_window, and Main.try_select_default_device_for_backup().

Referenced by add_opt_btrfs(), and add_opt_rsync().

◆ refresh()

void SnapshotBackendBox.refresh ( )
inline

Definition at line 218 of file SnapshotBackendBox.vala.

218 {
219
220 opt_btrfs.active = App.btrfs_mode;
221 type_changed();
222 update_description();
223 }
Main.btrfs_mode
bool btrfs_mode
Definition Main.vala:52

References App, Main.btrfs_mode, type_changed(), and update_description().

Referenced by SettingsWindow.init_delayed(), SetupWizardWindow.initialize_tab(), and SnapshotBackendBox().

◆ type_changed()

signal void SnapshotBackendBox.type_changed ( )

Referenced by add_opt_btrfs(), add_opt_rsync(), SettingsWindow.connect_signals(), and refresh().

◆ update_description()

void SnapshotBackendBox.update_description ( )
inlineprivate

Definition at line 175 of file SnapshotBackendBox.vala.

175 {
176
177 string bullet = "• ";
178
179 if (opt_btrfs.active){
180 string txt = "<b>" + _("BTRFS Snapshots") + "</b>\n\n";
181
182 txt += bullet + _("Snapshots are created using the built-in features of the BTRFS file system.") + "\n\n";
183
184 txt += bullet + _("Snapshots are created and restored instantly. Snapshot creation is an atomic transaction at the file system level.") + "\n\n";
185
186 txt += bullet + _("Snapshots are restored by replacing system subvolumes. Since files are never copied, deleted or overwritten, there is no risk of data loss. The existing system is preserved as a new snapshot after restore.") + "\n\n";
187
188 txt += bullet + _("Snapshots are perfect, byte-for-byte copies of the system. Nothing is excluded.") + "\n\n";
189
190 txt += bullet + _("Snapshots are saved on the same disk from which they are created (system disk). Storage on other disks is not supported. If system disk fails then snapshots stored on it will be lost along with the system.") + "\n\n";
191
192 txt += bullet + _("Size of BTRFS snapshots are initially zero. As system files gradually change with time, data gets written to new data blocks which take up disk space (copy-on-write). Files in the snapshot continue to point to original data blocks.") + "\n\n";
193
194 txt += bullet + _("OS must be installed on a BTRFS partition with Ubuntu-type subvolume layout (@ and @home subvolumes). Other layouts are not supported.") + "\n\n";
195
196 lbl_description.label = txt;
197 }
198 else{
199 string txt = "<b>" + _("RSYNC Snapshots") + "</b>\n\n";
200
201 txt += bullet + _("Snapshots are created by creating copies of system files using rsync, and hard-linking unchanged files from previous snapshot.") + "\n\n";
202
203 txt += bullet + _("All files are copied when first snapshot is created. Subsequent snapshots are incremental. Unchanged files will be hard-linked from the previous snapshot if available.") + "\n\n";
204
205 txt += bullet + _("Snapshots can be saved to any disk formatted with a Linux file system. Saving snapshots to non-system or external disk allows the system to be restored even if system disk is damaged or re-formatted.") + "\n\n";
206
207 txt += bullet + _("Files and directories can be excluded to save disk space.") + "\n\n";
208
209 lbl_description.label = txt;
210 }
211 }

References _, and opt_btrfs.

Referenced by add_opt_btrfs(), add_opt_rsync(), and refresh().

Member Data Documentation

◆ lbl_description

Gtk.Label SnapshotBackendBox.lbl_description
private

Definition at line 39 of file SnapshotBackendBox.vala.

Referenced by add_description().

◆ opt_btrfs

Gtk.CheckButton SnapshotBackendBox.opt_btrfs
private

Definition at line 38 of file SnapshotBackendBox.vala.

Referenced by add_opt_btrfs(), and update_description().

◆ opt_rsync

Gtk.CheckButton SnapshotBackendBox.opt_rsync
private

Definition at line 37 of file SnapshotBackendBox.vala.

Referenced by add_opt_btrfs(), and add_opt_rsync().

◆ parent_window

Gtk.Window SnapshotBackendBox.parent_window
private

Definition at line 40 of file SnapshotBackendBox.vala.

Referenced by init_backend(), and SnapshotBackendBox().

The documentation for this class was generated from the following file: