List slots, one line each, in the format slot:label.LOAD slot device drive
Load the volume in slot slot into drive drive.LOADED slot device drive
Print the slot number currently loaded into drive drive, or print 0 if the drive is unloaded.SLOTS
Print the number of slots.UNLOAD slot device drive
Unload the volume currently loaded in drive drive.Vchanger also implements the following undocumented comands LISTALL
List drive status followed by slot status, one line for each drive or slot, in the format type:number:status:label, where type is D for a drive or S for a slot, number is the drive or slot number, status is E for empty or F for full, and label is the volume label (barcode).Additionally, the following extended commands are supported. CREATEVOLS mag_ndx count [start]
Create count volume files on the magazine indexed by mag_ndx. Magazines are directories and/or filesystems that have been defined in the vchanger(5) configuration file given by config. The magazine index is based on the order in which the Magazine directives appear in the configuration file, where index zero is the first occurrence. Optionally, start specifies the minimum integer uniqueness number to append to a prefix string when generating filenames for the created volume files. The default is to use a uniqueness number greater than highest number currently used for any volume file on the selected magazine.LISTMAGS
List the status of all assigned magazines (directories and filesystems), one per line, in the format mag:count:start:mnt, where mag is zero-based index of the magazines specified in configuration file config, count is the number of volume files on that magazine, start is the virtual slot number of the beginning of the range of slots mapped to the magazine’s volume files, and mnt is the magazine’s directory/mountpoint if mounted, or blank if not currently mounted.REFRESH
Refresh state information for the autochanger defined by the configuration file config, issuing an update slots command to Bacula if required.Bacula Interaction By default, vcahgner will invoke bconsole and issue commands to Bacula when certain operator actions are needed. When anything happens that changes the current set of volume files being used, vchanger will invoke bconsole and issue an update slots command. For example, when the operator attaches a removable drive defined as one of the changer’s magazines, the volume files on the removable drive must be mapped to virtual slots. Since the volume-to-slot mapping will have changed, Bacula will need to be informed of the change via the update slots command. The REFRESH command can be invoked to force vchanger to update state info and trigger update slots if needed. Additionally, when new volumes are created with the CREATEVOLS command, vchanger will invoke bconsole and issue a label barcodes command to write volume labels on the newly created volume files.
Override the default user to run as when invoked by root. The default is normally specified in the configuration file given by config.-g, --group=gid
Override the default group to run as when invoked by root. The default is normally specified in the configuration file given by config.--pool=pool
Overrides the name of the pool into which volumes created by the CREATEVOLS command will be placed when vchanger is configured to label new volumes by sending Bacula a label barcodes command. The default is given by the Default Pool setting in the configuration file.-l, --label=prefix
Overrides the default volume label prefix when generating names for new volume files created by the CREATEVOLS command. The default is name_ndx, where name is the autochanger name and ndx is the magazine index.--help
Displays command help for the vchanger command.--version
Displays vchanger version information.