/*
 * SDPL README: Quick reference for sdpl
 *
 *   Copyright (C) 2001, 2002, Jocelyn MAYER <jma@netgem.com>
 *
 *   Permission is granted to copy, distribute and/or modify this document
 *   under the terms of the GNU Free Documentation License, Version 1.1
 *   or any later version published by the Free Software Foundation;
 *   with no Invariant Sections with Front-Cover Texts being TITLE, 
 *   and noBack-Cover Texts.
 *   A copy of the license is included in the section entitled "GNU
 *   Free Documentation License".
 */

TITLE:
/*
 * Simple Disk Partition Layer
 *
 * Documentation: README
 *
 */

-------------------------------------------------------------------------------
1/ Build sdpl:

To make it, you should simply need to do "make"
You'll get a beautiful configuration panel...
Then, redo make to build everything.
then "make install" to install libraries and programs.

You also can do "make size" to control the size of built objects.

-------------------------------------------------------------------------------
2/ Use of sdpl:

*************************************************************************
I STRONGLY RECOMMAND THAT YOU DON'T USE KERNEL MODULE IN YOUR MAIN KERNEL
*************************************************************************

Why ???
Hum, I only use this code with a User-Mode Kernel
(refer to http://user-mode-linux.sourceforge.net/)
using a ram disk drive for tests.

If you don't know what it's all about,
I suggest that you wait for 1.0 version before testing 
the kernel module...

Still here ???
OK, I made tests with ramdisks and loop device.
Now, we can say we're in beta tests.
I know have a kernel module which is usuable,
without kernel crashes.
I succeeded making ext2 and minix filesystems
and using them, with "entrelaced" partitions.
What I mean is that my test layer had been done
so that partitions are not contiguous,
they have holes... One of the worst case, I think...

Be carefull !!!
There can still be some BUGS in modules...
One good point is that it won't crash the kernel.

-------------------------------------------------------------------------------
3/ Missing:

Yes, I know,
no configure / automake / autoconf by now...

-------------------------------------------------------------------------------
4/ BUGS: is it a joke ???

No bugs, for sure, but the ones I didn't found.
Seriously, remember that this project is now in beta stage,
so bugs reports will be welcome,
if you can find some, of course :=) !

-------------------------------------------------------------------------------
5/ File in the main download area:

What you'll find here:

- patch_sdpl-V.N_KV.bz2/gz : patch to apply to kernel version KV 
                             to get sdpl version V.N

- sdpl-V.N.bz2/gz : standalone sdpl modules and utilities.

- sdplmod-V.N_kKV.bz2/gz : precompiled kernel modules against kernel KV,
                           for sdpl version V.N
  In this archive, you'll find ALL sdpl modules version.
  There are three branches:
  * sdplmod : standard version.
  * sdplmod_64 : 64 bits version.
  * sdplmod_e : embedded version.
  Then, you have each branch compiled with all of the 4 debug levels.
  So, you get sdplmod_debug0.o
              sdplmod_debug1.o
              ...
  Note that these modules are larger that the one you'll get compiling
  sources by yourself because, in my Makefile, I ask gcc to do size
  optimisation, as the kernel is compiled for speed optimisation.

-------------------------------------------------------------------------------