1()                         PMDK Programmer's Manual                         ()
2
3
4

NAME

6       pmdk-convert - upgrade pool files layout version
7

SYNOPSIS

9              $ pmdk-convert <file>
10

DESCRIPTION

12       The  pmdk-convert  performs  a  conversion of the specified pool to the
13       newest layout supported by this  tool.   Currently  only  libpmemobj(7)
14       pools are supported.
15
16       The conversion process is not fail-safe - power interruption may damage
17       the pool.  It is advised to have a backup of the  pool  before  conver‐
18       sion.
19
20       This tool doesn't support remote replicas.  Before a conversion all re‐
21       mote replicas have to be removed from the pool  by  pmempool  transform
22       command.
23
24   Options:
25       -V, --version
26
27       Display version information and exit.
28
29       -h, --help
30
31       Display  help  and the list of supported layouts and corresponding PMDK
32       versions.
33
34       -f, --from=pmdk-version
35
36       Convert from specified PMDK version.  This option is exclusive with  -F
37       option.
38
39       -F, --from-layout=version
40
41       Convert  from  specified layout version.  This option is exclusive with
42       -f option.
43
44       -t, --to=version
45
46       convert to specified PMDK version.  This option is  exclusive  with  -T
47       option.
48
49       -T, --to-layout=version
50
51       Convert  to specified layout version.  This option is exclusive with -t
52       option.
53
54       -X, --force-yes=[question] reply positively to specified question  pos‐
55       sible questions: - fail-safety - 1.2-pmemmutex
56

EXAMPLE

58              $ pmempool convert pool.obj
59
60       Updates pool.obj to the latest layout version.
61
62              $ pmempool convert pool.obj --from=1.2 --to=1.4
63
64       Updates pool.obj from PMDK 1.2 to PMDK 1.4
65

SEE ALSO

67       pmempool(1),   libpmemblk(7),  libpmemlog(7),  libpmemobj(7),  libpmem‐
68       pool(7) and <http://pmem.io>
69
70
71
72PMDK - pmem Tools version 1.5     2019-01-30                                ()
Impressum