TRUEIMAGEMNT(8)                                                     System Manager's Manual                                                     TRUEIMAGEMNT(8)



NAME
       trueimagemnt - Acronis Backup & Recovery 10 Server for Linux command line image mount tool

SYNOPSIS
       trueimagemnt [-h|--help] [-l|--list] [-m|--mount mountpoint] [-u|--umount mountpoint] [-s|--stop pid] [-f|--filename archive filename] [-p|--password
       password] [-t|--fstype filesystem type] [-i|--index partition index] [-w|--read-write] [-d|--description archive description] [-k|--keepdev] [-o|--loop]

DESCRIPTION
       The trueimagemnt is designed to restore files from partition/disk image.  It mounts Acronis True Image archives as if they are kernel space block
       devices. The program implements the user level part of the Acronis True Image user mode block device service. The large part of functionality is handled
       by the snumbd kernel module.

       The trueimagemnt configures kernel space block device and forks a child which handles access to specified archive file.

COMMANDS
       -h|--help
            Shows usage.

       -l|--list
            Lists already mounted user mode block devices.

       -m|--mount
            Mounts the archive image specified by -f|--filename option into the folder specified by the mountpoint option.

            The partition index should be specified by the -i|--index option. Image file contents (partitions and their indices) may be listed by the
            trueimagecmd --list --filename:filename command.

            To mount an incremental image, you must have all previous incremental images and the initial full image. If any of the successive images is
            missing, mounting is impossible.

       -u|--umount mountpoint
            Unmounts the device mounted at mountpoint, destroys the kernel space block device and stops the user space daemon.

       -s|--stop pid
            Destroys the kernel space block device and stops the user space daemon specified by pid. This command should be used if an error occurs while the
            mounting and unmounted user space daemon/kernel space block device pair survives. Such a pair is listed by the -l|--list command with none written
            in the mountpoint field.

OPTIONS
       -f|--filename archive filename
               The image file name. trueimagemnt transparently supports Network File System (NFS) and Samba network access. To access an NFS network drive,
               specify the image filename as follows:

               nfs://hostname/share name:/remote filename

               For example:

               trueimagemnt -m /mnt/md1 -f nfs://dhcp6-223.acronis.com/sdb3/nfs_root:/mike/md1.tib -i 2

               mounts /mike/md1.tib archive, located on dhcp6-223.acronis.com node in /sdb3/nfs_root directory exported by NFS.

               To get Samba network access, specify the image file name as follows:

               smb://hostname/share name/remote filename

               The hostname may be specified with the username and password as: username:password@hostname

               For example:

               trueimagemnt -m /mnt/md1 -f smb://dhcp6-223.acronis.com/sdb3/mike/md1.tib -i 2

               mounts /mike/md1.tib archive. /mike/md1.tib is located on dhcp6-223.acronis.com node in /sdb3 directory exported by Samba.

       -p|--password password
               Specifies the password to explore password protected images.

       -t|--fstype filesystem type
               Specifies the explicit filesytem type to be passed to the standard mount command.  This option is useful if the standard mount command can't
               guess the filesystem type for some reason.

       -i|--index partition index
               Index of the partition.

       -w|--read-write
               Opens the image in read-write mode. After umount, all changed data will be saved into the archive with a new index.

       -d|--description archive description
               If an image is mounted in read-write mode, the program assumes that the image will be modified, and creates an incremental archive file to
               capture the changes. The option enables you to list the forthcoming changes in the comment to this file.

       -k|--keepdev
               Keeps the kernel space block device and user space daemon if an error occurs while mounting. This option may be used to get raw access to imaged
               partition data.

       -o|--loop
               Switches the mount command to test(loop) mode. The option enables you to mount the archive image specified by the -f|--filename option into the
               folder specified by the mountpoint option. The partition index should be specified by the -i|--index option. Image file contents (partitions and
               their indices) may be listed by the trueimagecmd --list --filename:filename command.

EXAMPLES
       * To get list of mounted archives use the command:

        trueimagemnt --list

       * To mount archive backup.tib of partition with index 2 to directory /mnt/backup use the following command:

        trueimagemnt --mount /mnt/backup --filename backup.tib --index 2

       * To get list of partitions (and their indices) saved into backup.tib use the following command:

        trueimagecmd --list --filename:backup.tib

       * To umount partition mounted at /mnt/backup:

        trueimagemnt --umount /mnt/backup

SEE ALSO
       trueimagecmd

BUGS
       Please report bugs to <support@acronis.com>

COPYRIGHT
       Copyright (C) Acronis 2000-2009



October 2016                                                                Acronis                                                             TRUEIMAGEMNT(8)