---
name: "pmdk-convert"
section: "1"
platform: "linux"
package: "pmdk-convert"
version: "1.7-1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/pmdk-convert"
---

# pmdk-convert(1)

upgrade pool files layout version

## NAME

**pmdk-convert** - upgrade pool files layout version

## SYNOPSIS

-

  ```
  $ pmdk-convert <file>
  ```

## DESCRIPTION

The **pmdk-convert** performs a conversion of the specified pool to the newest layout supported by this tool. Currently only [**libpmemobj**(7)](/libpmemobj/7.md) pools are supported.

The conversion process is not fail-safe - power interruption may damage the pool. It is advised to have a backup of the pool before conversion.

This tool doesn't support remote replicas. Before a conversion all remote replicas have to be removed from the pool by **pmempool transform** command.

### Options:

`-V, --version`

Display version information and exit.

`-h, --help`

Display help and the list of supported layouts and corresponding PMDK versions.

`-f, --from=pmdk-version`

Convert from specified PMDK version. This option is exclusive with -F option.

`-F, --from-layout=version`

Convert from specified layout version. This option is exclusive with -f option.

`-t, --to=version`

convert to specified PMDK version. This option is exclusive with -T option.

`-T, --to-layout=version`

Convert to specified layout version. This option is exclusive with -t option.

`-X, --force-yes=[question]` reply positively to specified question possible questions: - fail-safety - 1.2-pmemmutex

## EXAMPLE

-

  ```
  $ pmempool convert pool.obj
  ```

Updates pool.obj to the latest layout version.

-

  ```
  $ pmempool convert pool.obj --from=1.2 --to=1.4
  ```

Updates pool.obj from PMDK 1.2 to PMDK 1.4

## SEE ALSO

[**pmempool**(1)](/pmempool/1.md), [**libpmemblk**(7)](/libpmemblk/7.md), [**libpmemlog**(7)](/libpmemlog/7.md), [**libpmemobj**(7)](/libpmemobj/7.md), [**libpmempool**(7)](/libpmempool/7.md) and **\<http://pmem.io\>**