John Harrison > backup-1.5 > backup

Download:
backup-1.5.tar.gz

Annotate this POD

View/Report Bugs
Source  

NAME ^

backup - renames multiple files to have their timestamp in the filename

SYNOPSIS ^

backup-c ] [ -f ] [ -m ] [ -n ] [ -u ] [ -v ] [ files ]

DESCRIPTION ^

backup backs up the filenames supplied to copies which include the original file's timestamp in their name.

e.g.

    backup FILE

would create FILE.<timestamp>

If no filenames are given on the command line, filenames will be read via standard input (as 'rename' command does).

If the argument --move (or one of its forms) is given the file will be renamed (the default is to create a copy).

    backup --mv FILE

OPTIONS ^

-m, --mv, --move

Move: move the file instead of copying it.

-c, --cp, --copy

Copy: (default action so ignored) This is the default because it may be safer to copy a file than go renaming it if it is in use (e.g. a log file) but it will use more disk space!

-v, --verbose

Verbose: print names of files successfully backed up.

-n, --no-act

No Action: show what files would have been backed up.

-f, --force

Force: overwrite existing files.

-u, --usage, --help

Usage: show usage

ENVIRONMENT ^

No environment variables are used.

AUTHOR ^

John G. Harrison http://www.aotea.org/john/

COPYRIGHT ^

Copyright (C) 2005, John G. Harrison, all rights reserved.

This is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO ^

mv(1), perl(1), localtime(3), rename(1)

DIAGNOSTICS ^

If the new filename already exists or the file already has the timestamp in its name you'll get an error.

TODO ^

Perhaps timestamp formatting could be specified on the command line (ala date).

The shell script version has two options, --mvtn and --cptn

BUGS ^

The --copy option doesn't work on directories, it creates a file then fails.

The --move option works on a directory if the target doesn't already exist. (move would overwrite an empty target dir or fail on a non-empty target dir)

If you find any bugs or have suggestions, please let the me know... (the best contact method is via my website, because this email address gets much too much spam)

syntax highlighting: