1FSREMAP(8)              System Administration Utilities             FSREMAP(8)
2
3
4

NAME

6       fsremap - manual page for fsremap 0.9.4
7

SYNOPSIS

9       fsremap [OPTION]... DEVICE LOOP-FILE [ZERO-FILE]
10       fsremap [OPTION]... --resume-job=JOB_ID DEVICE
11

DESCRIPTION

13       Replace  the  contents  of  DEVICE with the contents of LOOP-FILE, i.e.
14       write LOOP-FILE onto DEVICE even if LOOP-FILE is inside a  file  system
15       _inside_ DEVICE
16
17       Mandatory  arguments  to  long  options are mandatory for short options
18       too.
19
20       --     end of options. treat subsequent parameters as arguments even if
21              they start with '-'
22
23       -a, --no-questions
24              automatic run: do not ask any question
25
26       --clear=all
27              clear all free blocks after remapping (default)
28
29       --clear=minimal
30              (DANGEROUS) clear only overwritten free blocks after remapping
31
32       --clear=none
33              (DANGEROUS) do not clear any free blocks after remapping
34
35       --cmd-umount=CMD
36              command to unmount DEVICE (default: /bin/umount)
37
38       --cmd-losetup=CMD 'losetup' command (default: /sbin/losetup)
39
40       --color=MODE
41              set messages color. MODE is one of: auto (default), none, ansi
42
43       --device-mount-point=DIR
44              set device mount point (needed by --io=prealloc)
45
46       -f, --force-run
47              continue even if some sanity checks fail
48
49       -i, --interactive
50              ask confirmation after analysis, before actual work
51
52       --io=posix
53              use posix I/O (default)
54
55       --io=prealloc
56              use posix I/O with EXPERIMENTAL preallocated files
57
58       --io=self-test
59              perform in-memory self-test with random data
60
61       --io=test
62              use  test  I/O.  Arguments  are: DEVICE-LENGTH LOOP-FILE-EXTENTS
63              FREE-SPACE-EXTENTS
64
65       --loop-device=LOOP-DEVICE
66              loop device to disconnect (needed by --io=prealloc)
67
68       --loop-mount-point=DIR
69              set loop file mount point (needed by --io=prealloc)
70
71       -m, --mem-buffer=RAM_SIZE[k|M|G|T|P|E|Z|Y]
72              set RAM buffer size (default: autodetect)
73
74       -n, --no-action, --simulate-run
75              do not actually read or write any disk block
76
77       --questions=MODE
78              set interactive mode. MODE is one of: no: never  ask  questions,
79              abort  on  errors  (default)  yes:  ask  questions  in  case  of
80              user-fixable errors extra: also ask confirmation before  danger‐
81              ous steps
82
83       -q, --quiet
84              be quiet, print less output
85
86       -qq    be very quiet, only print warnings or errors
87
88       --resume-job=NUM
89              resume  the  interrupted  job  NUM. The only non-option argument
90              must be DEVICE. Do _not_ pass LOOP-FILE as argument, or you will
91              LOSE YOUR DATA!
92
93       -s, --secondary-storage=SECONDARY_SIZE[k|M|G|T|P|E|Z|Y]
94              set secondary storage file length (default: autodetect)
95
96       -t, --temp-dir=DIR
97              write  storage  and  log files inside DIR (default: /var/tmp/fs‐
98              transform)
99
100       --ui-tty=TTY
101              show full-text progress on tty device TTY
102
103       -v, --verbose
104              be verbose
105
106       -vv    be very verbose
107
108       -vvv   be incredibly verbose (warning: prints lots of output)
109
110       -xp, --exact-primary-storage=PRIMARY_SIZE[k|M|G|T|P|E|Z|Y]
111              set _exact_ primary storage length, or fail
112
113              (default: autodetect)
114
115       -xs, --exact-secondary-storage=SECONDARY_SIZE[k|M|G|T|P|E|Z|Y]
116              set _exact_ secondary storage length, or fail
117
118              (default: autodetect)
119
120       --x-OPTION=VALUE
121              set internal, undocumented option. for maintainers only
122
123       --help display this help and exit
124
125       --version
126              output version information and exit
127
128
129
130fsremap 0.9.4                    January 2023                       FSREMAP(8)