===== Releasing =====
//This document covers the various areas you need to know to release RSBAC :)//





==== mr ====
mr is the release tool (svn://svn.rsbac.org/rsbac-misc/mkrelease). Use it to make tarballs and stuff to release :)

<code>
  -a, --archive                 Create release archive in DESTDIR
  -a24                          Enable 2.4 kernel fetching and archiving (required for -rd, -d 24, -c 24)
  -d, --diff 24|26|ALL          Shows a diff with trunk
  -rd, --rdiff                  Shows a diff between RSBAC code of
                                2.4 and 2.6 kernels
  -c, --compile utils|24|26|ALL         Test compilation
  -t, --tag                     Create tags SVN side
  -s, --sign                    Signs and hash packages in DESTDIR 
  -l, --clean                   Clean temporary files after execution
  -h, --help                    This cruft
</code>

You should first test kernel&utils compilation, then check the rdiff (if there is a difference between 2.4 and 2.6 common code, we have a prob), and the diff (its a smart diff, will only show RSBAC diff which are not in common code, with kernel trunk). This will also check that diffs are only rsbac related and not some kernel merge error.
Read and check it as much as humanely possible in a decent time.

Make the release with -a -s (and -l to clean up)

Don't forget to check the packages created, upload them to the release server and make a tag with -t (or by hand) before it's too late :)

Note: 2.4 support is deprecated and the tool does not make 2.4 kernels by default. You need the -a24 option.


Here's a sample run to make patches and tarballs:

<code>
  # cd rsbac-misc/mkrelease
  # ./mr -a /home/kang/test 1.4.2
  Using /home/kang/test/rsbac-1.4.2 with RSBAC 1.4.2
  Using temporary directory /home/kang/test/rsbac-1.4.2/rsbac_tmp_28102009
  
  Last chance to cancel, proceeding in 3 seconds...
  SVK Synchronising tree...
  [...]
  Detected kernel 2.6.31.5
  Tag NOT found for 1.4.2, using trunk/branches (trunk)
  SVK Fetching your tree...
  SVK Getting the 2.6 vanilla kernel...
  SVK Getting the 2.6 rsbac kernel...
  SVK Getting the RSBAC utilities...
  PACKING 2.6 RSBAC archive...
  PACKING RSBAC admin utils...
  PACKING Full Linux kernel + RSBAC 2.6
  SVK Fetching your tree...
  SVK Making patches... 
  2.6
  Loading hunks
  Sorting 0 hunks
  Done
  # ls -l /home/kang/test/rsbac-1.4.2/
  total 62520
  -rw-r--r-- 1 kang kang 63158324 2009-10-28 14:01 linux-2.6.31.5-rsbac-1.4.2.tar.bz2
  -rw-r--r-- 1 kang kang    54090 2009-10-28 14:01 patch-linux-2.6.31.5-rsbac-1.4.2.diff.bz2
  -rw-r--r-- 1 kang kang   324914 2009-10-28 13:59 rsbac-admin-1.4.2.tar.bz2
  -rw-r--r-- 1 kang kang   387117 2009-10-28 13:59 rsbac-common-2.6-1.4.2.tar.bz2
  drwxr-xr-x 4 kang kang     4096 2009-10-28 13:59 rsbac_tmp_28102009
</code>

==== Versions ====

Bump RSBAC admin tools versions:
  * main/libs/Makefile
  * main/tools/Makefile
  * main/tools/src/scripts/rsbac_*menu
  * main/headers/rsbac/types.h
  * main/tools/Changes
  * debian/*

Bump kernel version:
  * include/rsbac/types.h, both kernels
  * Documentation/rsbac/Changes, both kernels