Provided by: weresync_1.1.5-1_all bug

NAME

       weresync - clone linux drives incrementally

       weresync-gui - GUI interface for the weresync program.

SYNOPSIS

       weresync [ options ] [-g ROOT_PARTITION] [-B BOOT_PARTITION]
              [-E EFI_PARTITION] [-L BOOTLOADER] [-l LVM_SOURCE [LVM_TARGET]] source target

       weresync-gui

DESCRIPTION

       WereSync  clones linux drives incrementally producing a bootable clone. Clones produced by
       WereSync will have different UUIDs than the original drive, but WereSync will  update  the
       fstab  and  bootloader to allow the clone to properly boot. Clones can be created with one
       command or one button click, using weresync or weresync-gui respectively.

OPTIONS

       The weresync-gui command takes  no  arguments.  These  arguments  apply  to  the  weresync
       command.

       --h, --help
              Displays help message.

       -C, --check-and-partition
              Checks if all partitions are large enough and formatted correctly to allow drive to
              be copied. If the partitions are not valid, the target drive will be re-partitioned
              and reformatted. If unset, no checking occurs.

       -s, --source-mask MASK
              A  string  to  be  passed  to  format()  that  will  produce a partition identifier
              (/dev/sda1 or such) of the source drive when passed two arguments:  the  identifier
              ("/dev/sda") and a partition number in that order. Defaults to "{0}{1}"

       -t, --target-mask MASK
              A  string  to  be  passed  to  format()  that  will  produce a partition identifier
              (/dev/sda1 or such) of the source drive when passed two arguments:  the  identifier
              ("/dev/sda") and a partition number in that order. Defaults to "{0}{1}".

       -e, --excluded-partitions LIST
              A  list  of comma separated partition numbers that should not be searched or copied
              at any time. These partitions will still be formatted if -C is passed. Defaults  to
              empty.

       -b, --break-on-error
              If  passed  the program will halt if there are any errors copying. This flag is not
              recommended because it will halt even if encountering a normal issue, like  a  swap
              partition.

       -g, --root-partition PART_NUM
              The  partition  mounted  on  /. It is recommended to pass this always, but WereSync
              will attempt to find the main partition even if it is not passed.

       -B, --boot-partition PART_NUM
              The partition that should be mounted on /boot of the grub_partition. If you have  a
              separate boot partition, you must use this flag.

       -E, --efi-partition PART_NUM
              The  partition that should be mounted on /boot/efi of the grub_partition. If passed
              this will create the /boot/efi folder if it does not exist and  pass  it  to  grub.
              Required if you have an EFI partition.

       -m, --source-mount DIR
              The  directory  to mount partitions from the source drive on. Cannot be the same as
              --target-mount. If unset, WereSync generates a randomly named directory in the /tmp
              dir.

       -M, --target-mount DIR
              The  directory  to mount partitions from the target drive on. Cannot be the same as
              --source-mount. If unset, WereSync generates a randomly named directory in the /tmp
              dir.

       -r, --rsync-args RSYNC_ARGS
              The  arguments  to  be passed to the rsync instance used to copy files. Defaults to
              "-aAXxH --delete"

       -l, --lvm SOURCE [TARGET]
              This argument expects either one or two arguments  specifying  the  logical  volume
              groups  to copy from and to, respectively. If no target VG is passed, WereSync will
              use the VG SOURCE-copy. If the target does not exist, WereSync will create it.

       -L, --bootloader BOOTLOADER
              The plugin to use to install the bootloader. Such  plugins  can  be  found  at  the
              bottom of the help message. Defaults to using the "uuid_copy" plugin.

       -v, --verbose
              Makes WereSync increase output and include more minor details.

       -d, --debug
              Causes  a  huge  amount  of  output,  useful for debugging the program. Usually not
              needed for casual use.

COPYRIGHT

       Copyright 2016 Daniel Manila

       Licensed under the Apache License, Version 2.0 (the "License"); you may not use this  file
       except in compliance with the License.  You may obtain a copy of the License at

         http://www.apache.org/licenses/LICENSE-2.0

       Unless  required by applicable law or agreed to in writing, software distributed under the
       License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY  KIND,
       either  express  or  implied.   See  the  License  for  the  specific  language  governing
       permissions and limitations under the License.

EXAMPLES

       To copy /dev/sda to /dev/sdb on a UEFI system use:

          sudo weresync -C -L grub2 -E 1 -g 2 /dev/sda /dev/sdb

       This example uses grub2 as  the  bootloader  (for  most  other  UEFI  bootloaders  use  -L
       uuid_copy or omit the -L option all together) with the efi partition on /dev/sda1, and the
       root partition on /dev/sda2.

       Subsequent copies should omit the -C option, since it could cause weresync to  repartition
       /dev/sdb  again,  thus  deleting existing data and making weresync's incremental abilities
       useless.

       To copy /dev/sda to /dev/sdb on a BIOS/Legacy system use:

          sudo weresync -C -L grub2 -g 1 /dev/sda /dev/sdb

       This example uses grub2 as the bootloader (other bootloaders, such  as  syslinux,  may  be
       passed to the -L option) and has the root partition on /dev/sda1.  The omittance of the -E
       option signals to WereSync that this is not a a UEFI drive.

       As above, subsequent copies should be initiated without the -C option.

       The gui can simply be run with:

          sudo weresync-gui

SEE ALSO

       Full  documentation  can  be  found  at  WereSync's  documentation  on  Read   The   Docs:
       https://weresync.readthedocs.io/en/master/

AUTHOR

       Daniel Manila <dmv@springwater7.org>