## pyre volume reclaim

Show or set whether freed space is handed back; trim a file volume now

### Synopsis

A Pyre volume is a block device in 4 MiB blocks. Deleting files frees
nothing by itself: a block leaves the store only when a discard (TRIM,
UNMAP) says all of it is free. With reclaim on (the default) an iSCSI
volume's target advertises UNMAP and the computer that mounted the disk
trims it (fstrim in a Linux guest, Optimize-Volume -ReTrim on Windows,
discard=on on a Proxmox disk); an SMB/NFS volume's appliance trims its
own filesystem on every delete, and --now trims it at once.

Space comes back on the hub's schedule: the current size after the next
upload, the stored total when history lets the old versions go. The
limits (4 MiB units, the stacks that pass discards) print with the
setting.

```
pyre volume reclaim <volume> [flags]
```

### Examples

```
  pyre volume reclaim files
  pyre volume reclaim files --now
  pyre volume reclaim vmdisks --off
```

### Options

```
  -h, --help   help for reclaim
      --now    SMB/NFS: trim the volume's filesystem now
      --off    keep freed blocks (no UNMAP advertised, no discard on delete)
      --on     hand freed space back (the default)
```

### Options inherited from parent commands

```
      --api string       API base URL (default from the profile, or https://api.pyredata.io)
      --ca-cert string   PEM file with an extra CA to trust (self-hosted managers)
      --insecure         skip TLS certificate verification (lab use only)
  -o, --output string    output format: table, json or plain (default "table")
      --profile string   config profile to use (see: pyre config)
  -q, --quiet            print results only, no notices
      --token string     API token (default from the profile; prefer PYRE_TOKEN in scripts)
  -y, --yes              answer yes to every confirmation (for scripts)
```

### SEE ALSO

* [pyre volume](pyre_volume.md)	 - Create, list, resize and delete volumes