



ファイルをバックアップする。世代管理(ローテーション)・アーカイブも可能。
use File::Backup;
パッケージをロードする。
my $backed = backup( %args);
%args に指定できるパラメタは、以下の通り。
debug => 0 | 1
from => $PATH
to => $PATH
keep => $NUMBER:保存する世代数、デフォルトは7。
0を指定すると、バックアップファイルをパージするだけで終了するので注意。
timeformat => $STRING:バックアップファイル名に使用するタイムスタンプのフォーマット
デフォルトはYYYY-MM-DD_hh-mm-ss
archive => 0 | 1:バックアップファイルをアーカイブする。デフォルトは1。
archiver => $PATH_TO_PROGRAM:デフォルトはtar。
archive_flags => $COMMAND_SWITCHES:アーカイバに渡すオプションスイッチ。
archive_prefix => $STRING:アーカイブファイル名に付加する文字列。
archive_suffix => $STRING :アーカイブファイルの拡張子、デフォルトは.tar。
compressor => $PATH_TO_PROGRAM:デフォルトはgzip。
compress_flags => $COMMAND_SWITCHES :コンプレッサに渡すオプションスイッチ。
compress => 0 | 1:アーカイブファイルを圧縮する。デフォルトは1。
compress_suffix => $STRING:圧縮ファイルの拡張子、デフォルトは.gz。
lock => 0 | 1 :アーカイブファイルをロックする。デフォルトは1。
存在しないディレクトリをfromに指定してしまうと、ロック待ちが発生するので注意。
purge_first => 0 | 1 :バックアップする前にパージする。デフォルトは0。
戻り値は、fromの$PATHをキー、toの$PATHを値としたハッシュ。
バックアップに失敗した場合は、戻らずにdieする。