rescatux/rescatux

This is Rescatux, a Debian Live CD aimed at easy rescue.

Please visit the official web page of Rescatux, for more information.
The URL is <http://www.supergrubdisk.org/rescatux/>.

== OBTAIN SOURCE CODE ==

You can obtain most recent source code from out git repository by issuing:

  git clone http://git.code.sf.net/p/rescatux/git rescatux-git

== BUILD INSTRUCTIONS ==

In order to build Rescatux in a Wheezy system or Wheezy chroot you need these packages:

live-build (patched as below)
imagemagick # Needed for logo generation
syslinux # Needed for logo generation

== About chntpw build ==

Till the current bug in sampasswd (it does not save its changes)
and till samunlock is added upstream we need to build this program on our own.

Get chntpw source code from:

* branch : chntpw-ng-1.01
* repository : https://github.com/adrian15/chntpw

You might need to run:

ln -s /usr/include/asm-generic /usr/include/asm

so that the upstream source code builds ok

Then run (inside a Jessie chroot):
make

so that: samunlock, sampasswd, samunlock.static and sampasswd.static are generated.

Path to samunlock directory should be set at: make_common's CHNTPW_PATH variable.

== About tails-greeter build ==

I am using a tails-greeter fork while I try to get it integrated properly into Debian Live. Here there is how you need to build it (inside a Wheezy chroot):

git clone https://github.com/adrian15/tails-greeter.git
cd greeter
git checkout rescatux_0.32
dpkg-buildpackage -us -uc

You need to define the deb path at: make_common's RESCATUX_TAILS_GREETER variable.

== Debian Live needed patches ==

A per current version of live-build package it needs patching (On your wheezy or wheezy chroot system) so that two features work ok:
* Arch autodetection in Isolinux bootloader
* Support for loopback.cfg

If you want to know if the patches are no longer needed please check these associated bugs. You will see in which live-build version they are finally fixed.

* https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=757697
* https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=757883

Here there is a mini script for applying these patches.

#!/bin/bash
CURRENT_DIR=$(pwd)
cd /
BACKUP_SUFFIX="_backup_rescatux_$(date +'%F-%H-%M')"
cp -a /usr/lib/live/build/binary_syslinux /usr/lib/live/build/binary_syslinux${BACKUP_SUFFIX}
cp -a /usr/lib/live/build/binary /usr/lib/live/build/binary${BACKUP_SUFFIX}
patch -p1 < ${CURRENT_DIR}/debian-live-patches/debian_live_cpu64bit_detection.diff
patch -p1 < ${CURRENT_DIR}/debian-live-patches/debian_live_loopback_cfg_support.diff
cd ${CURRENT_DIR}

The patches are found in: debian-live-patches directory.

=== Isolinux based image ===

Edit these variables from make_common file if needed:

MIRROR_BOOTSTRAP
MIRROR_CHROOT
SID_MIRROR
BACKPORTED_PASSWD
CHNTPW_PATH

Using an Wheezy system or chroot run at the Rescatux source code directory:

  ./make_rescatux.sh

This will generate an image like:
  rescatux-0.30b7.iso
in rescatux-release directory.

=== SG2D based image ===

You need to have installed GNU GRUB2 in your system, at least the grub-mkrescue and grub-mkfont binaries.
You also need to have Super Grub2 Disk source code.

Edit SG2D_SOURCE_DIRECTORY variable in make_rescatux_sg2d.sh file.
Its value should be path to your Super Grub2 Disk source code directory.

Using an unstable/wheezey system or chroot run at the Rescatux source code directory:

  ./make_rescatux.sh

  and then:

  ./make_rescatux_sg2d.sh

This will generate an image like:
  rescatux_cdrom_usb_hybrid_i386_486-amd64_0.30b8_sg2d.iso

=== Make source code ===

Just run:

  ./make_source_code.sh

in order to generate a file like:

  rescatux_source_code_0.30b6.tar.gz

which will be found on:

rescatux-release directory.

=== Release ===

The files that usually conform a release are:

Rescatux iso:

  rescatux-0.30b7.iso

Rescatux iso md5sum file:

  rescatux-0.30b7.iso.md5

Rescatux source code:

  rescatux_source_code_0.30b8.tar.gz

which will be found on:

rescatux-release directory.

=== Other notes ===

You can change Rescatux version at VERSION file.

=== About Rescatux logo ===

New Rescatux logo ( 06 July 2014 ) is a mixed and modified image based on these three pictures:

* A Gnu wearing a jacket
** Author: Sarah Katzenell Rabkin
** Url: https://www.gnu.org/graphics/gnu-jacket.html
** License: Creative Commons Attribution-Sharealike 2.0
license (http://www.gnu.org/licenses/license-list.html#ccbysa).
* Tux
** Author: lewing@isc.tamu.edu and The GIMP
** Url: http://commons.wikimedia.org/wiki/File:Tux.png
** License: Permission to use and/or modify this image is granted provided you acknowledge me lewing@isc.tamu.edu and The GIMP if someone asks.
* Thermometer
** Author: Via Wikimedia commons
** License: CC-BY-SA-3.0 (http://creativecommons.org/licenses/by-sa/3.0/)]
** Url: http://commons.wikimedia.org/wiki/File:Clinical_thermometer_38.7.JPG

You can find it at: live-config/bootloaders/{extlinux,isolinux,pxelinux,syslinux}/splash.svg.in