pmtx(1)
| PMTX(1) | Proxmox Backup | PMTX(1) |
NAME
pmtx - Control SCSI media changer devices (tape autoloaders)
SYNOPSIS
pmtx help [{<command>}] [OPTIONS]
Get help about specified command (or sub-command).
- <command> (<string>)
- Command. This may be a list in order to specify nested sub-commands. Can be specified more than once.
Optional parameters:
- --verbose <boolean>
- Verbose help.
----
pmtx inquiry
Inquiry
----
pmtx inventory
Inventory
----
pmtx load <slot> [OPTIONS]
Load
- <slot> (<integer>)
- Storage slot number (source).
Optional parameters:
- --drivenum <integer>
- Target drive number (defaults to Drive 0)
----
pmtx scan
Scan for existing tape changer devices
----
pmtx status
Changer Status
----
pmtx transfer <from> <to>
Transfer
- <from> (<integer>)
- Source storage slot number.
- <to> (<integer>)
- Target storage slot number.
----
pmtx unload [OPTIONS]
Unload
Optional parameters:
- --drivenum <integer>
- Target drive number (defaults to Drive 0)
- --slot <integer>
- Storage slot number (target). If omitted, defaults to the slot that the drive was loaded from.
COMMON OPTIONS
All command supports the following parameters to specify the changer device:
- --device <path>
- Path to Linux generic SCSI device (e.g. '/dev/sg4')
- --changer <name>
- Use changer from Proxmox Backup Server configuration.
Commands generating output supports the --output-format parameter. It accepts the following values:
- text
- Text format (default). Human readable.
- json
- JSON (single line).
- json-pretty
- JSON (multiple lines, nicely formatted).
DESCRIPTION
The pmtx command controls SCSI media changer devices (tape autoloader).
ENVIRONMENT
- CHANGER
- If set, replaces the --device option
- PROXMOX_TAPE_DRIVE
- If set, use the Proxmox Backup Server configuration to find the associated changer device.
COPYRIGHT AND DISCLAIMER
Copyright (C) 2019-2025, Proxmox Server Solutions GmbH
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see <http://www.gnu.org/licenses/>
Author
Proxmox Support Team
Copyright
2019-2025, Proxmox Server Solutions GmbH
| Thursday, 21 May 2026 | <devbuild> |