.1. Rsync GUI
1. NAME
rsync_gui.pl - a front end to rsync, it saves having to remember all those command line parameters you used last time.
2. SYNOPSIS
rsync_gui.pl [ [--message] [--nomessage] [-m]
[--verbose] [--noverbose] [-v]
[--version]
[--help]
]
3. DESCRIPTION
This script will help you enter the correct parameters to run the rsync command and therefore replicate or copy one directory tree to another place.
When using the include and exclude options please note that rsync command line parameters are built up in the following orderthe following:
--exclude-from --exclude [--exclude] --include-from --include [--include]
The Check buttons allow the user to test the currently entered values. For the User/Host tab this will try to ssh to the host machine using the user name provided. It is assumed that you have setup ssh so that you do not need to enter a password. Ask your tem leader or local GTI/ETP how to do this if you are not sure. On the Directories tab this will test the the source directory exists and is readable by the current user. The destination directory will be tested for write permissions. If there is a User/Host specified then these tests will be carried out remotely via a ssh connection.
4. OPTIONS
4.1. --message
This will redirect both STDOUT and STDERR from the rsync command and store it in a file $HOME/rsync_mssg.log. The date and time along with the command line used will also be saved to the message log.
4.2. --verbose
Turns on some extra trace displays and sends them to STDERR.
4.3. --version
You already worked this out {{INLINE:<img src="../img/smiley.jpg">}} It prints the version of the script.
4.4. --help
Prints out the help text.
5. FILES
5.1. $HOME/.rsync_guirc
This file is read in when the script first runs during its initialisation. Any values saved in this file will be loaded as defaults. If you use similar values each time you run this script it can save time adding them back again and save mistakes.
-
The values can be saved to the file via the Menu File-> Save Defaults or the short-cut key <CTRL-S>. These values can also be reloaded with Menu File-> Load Defaults or the short-cut key <CTRL-L>.
5.2. $HOME/rsync_msg.log
This file will be appended to with the STOIO and STDERR output from the rsync command that is built up and then run. The option is turned on via the main menu Tools->Preferences...->save message. Take care this file can get very large, if you use the verbose and other reporting switches for rsync.
6. BUGS, FEEDBACK and REQUESTS
If you find any bugs, features or weird behaviour with the script, or if you have an ideas for an additional feature, please contact the email address "richard_perl at mythicalbeast dot co dot uk".
When reporting bugs please send any .rsync_guirc and message files you collected when this script was run.
7. AUTHOR
Richard Brown
Copyright 2007,
8. LICENSE
License ------- This package 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place,Suite 330, Boston, MA 02111-1307, USA