bagop: A Perl repository from ole-tange

NAME bagop - mark files and directories for backup and back them up

DESCRIPTION bagop is a tool for flagging specific files and directories that should be backed up.

OPTIONS --dest [[user@]host:][dir] Destination folder. --dest determines where the backup will be saved. dir is the directory where the backup should be saved (defaults to . if a remote host is given). host is the name of the remote host on which the backup is (default: no remote host). user is the username on the remote host (default: your username).

         The syntax is the same as for rsync.

         The default is ~/backup/bagop.

-d
--dryrun Dry run. Do not do the actual backup but show what would be
         done.

-q
--quiet  Quiet. Do not output progress information and warnings. Only
         report errors.

add *paths*
         Add to the backup. Mark *paths* for backing up from now on.
         Adding a directory will add all files and furture files under
         that directory.

del *paths*
delete   Delete from the backup. Mark *paths* for not being backed up
         any more (and NOT impelemented: delete it from the backup).

move *src* *dst*
         The command is equivalent to the `mv` Unix command and indeed
         files and directories can be renamed or moved physically on the
         file system while keeping track of them in the database. If
         multiple *src* paths are given, then the *dst* path must be a
         directory.

commit   Do the actual backup. This will copy the files and directories
         to the backup.

stat *path*
status   Show status. Show the status of the files and directories.

EXAMPLE: Simple use Mark a file foo.gz for backup:

bagop add foo.gz

Mark multiple files for backup:

bagop add *.gz

Mark a directory results/ for backup:

bagop add results/

Copy the marked files and directories to the backup dir

bagop commit

Rename a file already added to the backup

bagop move foo bar

Move files and directories already added to the backup to new_dir/

bagop move foo bar dir/ new_dir/

Show the backup status:

bagop stat

Show the backup status for all files:

bagop stat /

EXAMPLE: backup to a specified destination The default backup destination is '~/backup/bagop'. To use an alternative destination do:

bagop --dest ~/my_backup add *.gz

And commit the backup to that specific destination:

bagop --dest ~/my_backup commit

EXAMPLE: backup to multiple destinations First add files for the first destination and then the second:

bagop --dest ~/my_backup1 add *.gz bagop --dest ~/my_backup2 add *.gz

And then commit both:

bagop --dest ~/my_backup commit bagop --dest ~/my_backup commit

EXAMPLE: backup to a specified host Specify the alternatie host and the optional directory at the host when adding files:

bagop --dest maasha@host1:my_backup add *.gz

And then commit the backup for that host and directory:

bagop --dest maasha@host1:my_backup commit

EXAMPLE: backup to multiple hosts Don't put all eggs in one basket. First add files for the first host and then the second:

bagop --dest maasha@host1: add *.gz bagop --dest maasha@host2: add *.gz

And then commit both:

bagop --dest maasha@host1: commit bagop --dest maasha@host1: commit

Copyright (C) 2012-2013 Ole Tange, http://ole.tange.dk

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU 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 General
Public License for more details.

You should have received a copy of the GNU General Public License along
with this program. If not, see <http://www.gnu.org/licenses/>.

Documentation license I Permission is granted to copy, distribute and/or modify this documentation under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the file fdl.txt.

Documentation license II You are free:

to Share to copy, distribute and transmit the work

to Remix to adapt the work

Under the following conditions:

Attribution
         You must attribute the work in the manner specified by the
         author or licensor (but not in any way that suggests that they
         endorse you or your use of the work).

Share Alike
         If you alter, transform, or build upon this work, you may
         distribute the resulting work only under the same, similar or a
         compatible license.

With the understanding that:

Waiver   Any of the above conditions can be waived if you get permission
         from the copyright holder.

Public Domain
         Where the work or any of its elements is in the public domain
         under applicable law, that status is in no way affected by the
         license.

Other Rights
         In no way are any of the following rights affected by the
         license:

         * Your fair dealing or fair use rights, or other applicable
           copyright exceptions and limitations;

         * The author's moral rights;

         * Rights other persons may have either in the work itself or in
           how the work is used, such as publicity or privacy rights.

Notice   For any reuse or distribution, you must make clear to others
         the license terms of this work.

A copy of the full license is included in the file as cc-by-sa.txt.

ole-tange/bagop