File: writeboosttab.5

package info (click to toggle)
writeboost 1.20160718-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 96 kB
  • sloc: sh: 142; makefile: 20
file content (89 lines) | stat: -rw-r--r-- 2,313 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
.TH WRITEBOOSTTAB 5 "2015-05-07" "writeboost" "File Formats"
.SH NAME
writeboosttab - mappings of cache(d) devices
.SH SYNOPSIS
.B /etc/writeboosttab
.
.SH DESCRIPTION
The file
.B writeboosttab
contains information about mappings between caching and cached block devices
for writeboost utility.

Each mapping is described on a separate line;
Empty lines and lines starting with '#' are ignored;
Fields on each line are separated by tabs or spaces;

.B The first field
.RI ( dm_name )
.RS
This field describes the name of device-mapepr block device that will be
created as result of mapping.
.LP
Typically after successful mapping the
.I dm_name
will appear in the
.I /dev/mapper
folder.
.RE

.B The second field
.RI ( hdd_device )
.RS
This field describes path to the cached block device, typically "slow"
(rotational) HDD.
.RE

.B The third field
.RI ( ssd_device ).
.RS
This field describes path to the caching block device, typically "fast" SSD.
.RE

.B The forth field
.RI ( options )
.RS
This optional field describes comma-separated list of options passed to
dm-writeboost.
.RE

It is recommended to use reliable paths to block devices like
.I /dev/disk/by-uuid/{UUID}
or similar.
.
.SH EXAMPLES
The following is an example of an entry in the
.B /etc/writeboosttab
file:
.sp
.RS 4
.nf
 cached_hdd  /dev/disk/by-uuid/2e8260bc-024c-4252-a695-a73898c974c7  /dev/disk/by-partuuid/43372b68-3407-45fa-9b2f-61afe9c26a68  writeback_threshold=70,sync_data_interval=3600
.fi
.RE
.
.SH FILES
.IR /etc/writeboosttab
.
.SH "SEE ALSO"
.BR writeboost (8)
.
.SH AUTHOR
 Dmitry Smirnov <onlyjob@member.fsf.org>
.
.SH COPYRIGHT
 Copyright 2015 Libre Solutions Pty Ltd (http://raid6.com.au)
.
.SH LICENSE
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 2 of the License, or
 (at your option) any later version.

 This package is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program. If not, see <http://www.gnu.org/licenses/>.