chiark / gitweb /
debian: Split into multiple packages.
authorMark Wooding <mdw@distorted.org.uk>
Tue, 16 Jul 2013 18:16:50 +0000 (19:16 +0100)
committerMark Wooding <mdw@distorted.org.uk>
Tue, 16 Jul 2013 20:03:12 +0000 (21:03 +0100)
Makefile.am
debian/.gitignore
debian/control
debian/fshash.install [new file with mode: 0644]
debian/rfreezefs.install [new file with mode: 0644]
debian/rsync-backup.install [new file with mode: 0644]

index 18bceaa24d47de894d3f24444506bca76c924ae5..f943ad4006c01e0f0824b96eafe42ae40605e1e6 100644 (file)
@@ -124,4 +124,14 @@ EXTRA_DIST         += debian/copyright debian/changelog
 EXTRA_DIST             += debian/control debian/rules
 EXTRA_DIST             += debian/compat
 
+## fshash
+EXTRA_DIST             += debian/fshash.install
+
+## rfreezefs
+EXTRA_DIST             += debian/rfreezefs.install
+
+## rsync-backup
+EXTRA_DIST             += debian/rsync-backup.install
+EXTRA_DIST             += debian/rsync-backup.examples
+
 ###----- That's all, folks --------------------------------------------------
index 3a6cded2065038588e81402a9e9dd7f72daa9a3d..aa7dc1acb1706022815d9f05d954af6802f95e4d 100644 (file)
@@ -3,3 +3,6 @@
 rsync-backup
 files
 substvars
+fshash
+rfreezefs
+tmp
index 4c0df732be8aab5f70a2ebb851616ac33f72ebce..39a21a4889a0df24329db239efec0084f819023e 100644 (file)
@@ -6,17 +6,58 @@ XS-Python-Version: >= 2.5
 Build-Depends: mlib-dev (>= 2.2.1), debhelper (>= 8.1)
 Standards-Version: 3.1.1
 
+Package: fshash
+Architecture: all
+Depends: python
+Description: Calculate a digest of a filesystem.
+ The `fshash' program generates digests of filesystems.  It aims to provide
+ three properties:
+ .
+   * Completeness: the digest describes everything `interesting' about the
+     filesystem, such that two filesystems which are interestingly different
+     will have different digests.
+ .
+   * Canonicalness: if two filesystems aren't different in any interesting
+     way, then their digests should be identical.
+ .
+   * Readability: given two subtly different filesystems, it should be easy
+     for a human equipped with digests for them and diff(1) to work out what
+     the differences actually are.
+ .
+ The digests include cryptographic hashes of the files.  These can take time
+ to compute, so `fshash' can keep a cache of hashes.
+
+Package: rfreezefs
+Architecture: linux-any
+Depends: ${shlibs:Depends}
+Recommends: ssh-server
+Description: Freeze filesystems safely under remote control.
+ Filesystems can be `frozen', i.e., placed in a consistent state, with write
+ operations delayed.  This is useful when taking snapshots, and LVM (for
+ example) freezes filesystems mounted on a logical volume automatically when
+ taking a snapshot.  This doesn't work if the filesystem is mounted on a
+ separate machine from the one hosting the block device, e.g., if the volume
+ is provided by a VM host to its guest, or as a remote block device.
+ .
+ The `rfreezefs' program explicitly freezes a filesystem so that a consistent
+ snapshot can be taken.  It goes to considerable lengths to avoid unpleasant
+ conditions such as deadlocks while filesystems are frozen.
+
 Package: rsync-backup
-Architecture: any
-Depends: ${shlibs:Depends}, rsync, openssh-client
+Architecture: all
+Depends: rsync, openssh-client, fshash
 Recommends: lvm2
+Suggests: rfreezefs
 Description: Yet another `rsync --link-dest' backup script.
  It uses rsync's ability to create hardlinks from (apparently) similar
- existing local trees to make incremental dumps efficient, even from remote
+ existing local trees to make incremental dumps efficient, even from remote
  sources.  Restoring files is easy because the backups created are just
- directories full of files, exactly as they were on the source - and this is
- verified using the fshash(1) program (included).
+ directories full of files, exactly as they were on the source -- and this is
+ verified using `fshash'.
  .
  The script does more than just running rsync.  It is also responsible for
  creating and removing snapshots of volumes to be backed up, and expiring old
  dumps according to a user-specified retention policy.
+ .
+ The `fshash' package is required on the server and all of the clients.  The
+ `rfreezefs' package may be useful on clients which are VM guests.
diff --git a/debian/fshash.install b/debian/fshash.install
new file mode 100644 (file)
index 0000000..9ff8405
--- /dev/null
@@ -0,0 +1,2 @@
+/usr/bin/fshash
+/usr/share/man/man1/fshash.1
diff --git a/debian/rfreezefs.install b/debian/rfreezefs.install
new file mode 100644 (file)
index 0000000..2c42276
--- /dev/null
@@ -0,0 +1,2 @@
+/usr/sbin/rfreezefs
+/usr/share/man/man8/rfreezefs.8
diff --git a/debian/rsync-backup.install b/debian/rsync-backup.install
new file mode 100644 (file)
index 0000000..9156279
--- /dev/null
@@ -0,0 +1,4 @@
+/usr/sbin/rsync-backup
+/usr/sbin/update-bkp-index
+/usr/share/man/man8/rsync-backup.8
+/usr/share/man/man8/update-bkp-index.8