br - Breakup and Reunite Scripts

Introduction

Breakup and Reunite (hereinafter referred to as B & R, because it's easier to type) are a set of two scripts that automate the task of splitting files over a certain size threshold into smaller chunks using the UNIX "split" command and then recombining those chunks when needed.

What use is it?

I wrote it to split files to where they would be suitable for transfer over Amazon's S3 service, but it could be used for any file maintenance task, especially in backup scripts.

How do I install it?

Just run the "install" command that comes with this package. You can also just copy the breakup and reunite scripts that come with this package into your executable path (this script copies them into /usr/local/bin for you).

Can I uninstall it?

Just use the "uninstall" command. But why would you want to do that? :)

Does it run on x platform?

I've only tested it on Linux, and I know for sure it will NOT run on Windows due to the lack of UNIX tools like split and cat. I'm reasonably sure it will run on most UNIX derivatives.

Is it safe to use?

I've tested it in a variety of situations and the files that it produces recombine into a file that is the exact same as the original. That said, I cannot guarantee it will work properly and it comes with NO WARRANTY OF ANY KIND. Use it at your own risk.

Requirements

  • Ruby 1.8.2 or later
  • The GNU 'split' command (I have not run across a major Linux distro that didn't have this)

Download

Usage

Just run the breakup command to see a summary of usage. You can also run the reunite command to see how to use it as well.

I have a suggestion/patch for it!

Great! Please e-mail it to me at rob @ nospam @ ocstech.com. I'll gladly consider any suggestions for improvements or patches.

Can I include it in x software package?

Yes, as long as you adhere to the terms of the GPL version 2 license.