-
Notifications
You must be signed in to change notification settings - Fork 21
/
help.txt
99 lines (86 loc) · 5.26 KB
/
help.txt
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
90
91
92
93
94
95
96
97
98
99
ParPar
High performance PAR2 creation tool
-----------------------------------
Usage: parpar -s <slice_size/count> -o <output> [options] [--] <input1> [<input2>...]
Unless otherwise specified, all options take one parameter.
PAR2 Options:
-s, --input-slices Slice/block size or number of input slices/blocks.
To specify exact slice size, append a size suffix
to the number. Examples:
`-s2000`: selects a slice size so that there
are 2000 input slices
`-s1M`: sets the slice size to 1 megabyte
`-s1024B`: set the slice size to 1 kilobyte
This option must be specified.
par2cmdline's default equivalent: `-s2000`
Multipar/par2j's default equivalent: `-s0.5w*10`
-S, --auto-slice-size Automatically scale up input slice size if the
number of input slices would exceed the maximum
allowed.
This option takes no parameters.
-r, --recovery-slices Number of recovery slices to generate. You can
append a suffix to auto-calculate this, as in the
following examples:
`-r100`: generates 100 recovery slices
`-r15.7%`: generates 15.7% recovery
`-r2.5M`: generates 2.5MB of recovery
Default is 0, which generates no recovery.
-f, --filepath-format How to format input file paths, can be either:
basename: discard paths
keep: retain full paths as specified
common: discard common parts of paths; falls
back to basename if there is no common
path
outrel: path computed relative to output
path: path computed relative to that specified
in `--filepath-base`
Default is `common`, or `path` if `--filepath-base`
is specified.
-B, --filepath-base The base path to use when computing paths when
`--filepath-format=path` is used.
Default is `.` (i.e. current working directory)
Output Options:
-o, --out Base PAR2 file name. A .par2 extension will be
appeneded if not supplied.
-O, --overwrite Overwrite existing files if they exist. This
option doesn't take any parameters.
Note that this will not delete existing PAR2
recovery files that match the base PAR2 name, but
wouldn't be written to.
-d, --slice-dist Specify how recovery slices are distributed
amongst output files. Can be:
equal: each file contains `--slices-per-file`
slices
uniform: like `equal` but try to distribute
slices evenly distributed amongst
files
pow2: power-of-2 sizing scheme (default)
-p, --slices-per-file Specify the maximum number of slices each file
may contain.
Default 65535
Performance Options:
-m, --memory Maximum amount of memory to use for computing
recovery. ParPar will run multiple passes on input
data to generate recovery if insufficient memory
is allowed, so increasing this value can improve
performance. Default is auto-detected based on
total/free RAM, typically 75% of free RAM up to
8192MB.
-t, --threads Limit number of threads to use. Default equals
number of CPU cores/threads.
Other Options:
All of the following options take no parameters.
-R, --recurse If specified, recurse into subdirectories. If
`--no-recurse` is specified, do not traverse
subdirectories. The default is to traverse
directories given on the command line without
recursion.
-q, --quiet Suppress information output. Errors will still be
displayed
-?, --help Displays this list of options
--help-full Displays full list of options
--version Print application version number and exit
------------------
Examples
parpar -s 1M -r 64 -o my_recovery.par2 file1 file2
Generate 64MB of PAR2 recovery files from file1 and file2, named "my_recovery"