Short: Tool to change the size of a SFS partition
Author: Marek Szyprowski <marek@amiga.pl>
Uploader: Marek Szyprowski <marek@amiga.pl>
Type: disk/misc
Architecture: ppc-morphos

SFSresize is (simple) tool that fixes the SFS filesystem after changing
partition size (currently only shrinking is supported).


*** IMPORTANT NOTICE ***

ME AND ALL PEOPLE MENTIONED IN THIS DOCUMENTATION TAKE NO RESPONSIBILITY FOR ANY
DATA LOSES OR DAMAGE CAUSED BY THIS PROGRAM. THE PROGRAM IS PROVIDED "AS IS" IN
HOPE THAT IT WILL BE USEFUL, BUT WITHOUT WARRANTY OF ANY KIND. YOU USE IT AT
YOUR OWN RISK! REMEMBER, YOU HAVE BEEN WARNED.


*** Required tools ***

SFSCheck - available on Aminet (disk/misc)


*** Usage ***

First, please read whole documentation BEFORE doing anything.

To change the size of your SFS filesystem please strictly follow these steps:

1. Do the complete defragmentation of your partition. Use 'Defrag' tool from
MorphOS v1.4.5 or 'SFSCheck' tool on earlier systems. Make sure that your
filesystem doesn't have any errors.

2. Check how much you can shrink your partition. Run SFSresize with CHECK option
(type 'SFSresize <DRIVE> CHECK' in shell, where <DRIVE> is name of the drive
with your filesystem). The program will show the number of last allocated block
and the minimal size of the filesystem. You cannot make your partition smaller
than that value.

3. Do the backup of all important metadata from your filesystem. Type 'SFSresize
<DRIVE> BACKUP' in shell and wait a while. The program will create a few files
with all important metadata that will be changed during the resize. Names of
these files use following filename scheme:
backup_<metadata_type>_<start_block>_<block_count>
After doing the backup make sure that no program will modify data on this
filesystem.
Make sure that those backup files are saved to a safe place (not RAM: or
partition that will be resized).

4. Run your favourite hard disk partitioning tool. Save or write down all
parameters of your partition. Especially important are: 'start cylinder' and
'end cylinder'. Change the size of your partition by reducing 'end cylinder'
parameter (this will automatically modify 'total blocks' and 'size' parameters).
Do not touch other parameters of the partition. Remember about the limit from
point 2.

5. Reboot your system. The partition will disapear from Ambient screen.

6. Resize and fix the partition. Run SFSresize with PERFORM option - type in
shell: 'SFSresize <DRIVE> PERFORM', then confirm that you know what you are
doing. If you see any error message you will be in trouble...

7. When resizing finishes check the partition with SFSCheck tool (type in shell
'SFSCheck <DRIVE>'). There SHOULD be no errors. If there are any, you are in
trouble...

8. Reboot your system. The partition should be visible on Ambient screen again.
Congratulation. Operation finished!


*** If something went wrong... ***

First. Don't panic. Don't do any silly things like formating the partition.

Restore all partition parameters in your hard disk partitioning tool and then
reboot.

Use SFSresize tool with RESTORE option (type 'SFSrestore <DRIVE> RESTORE' in
shell). Make sure that all backup files that were created in point 3 are in
current directory. After this please reboot. All changes SHOULD be undone.

If there are still problems you have bad luck. You can try to recover you data
with SFSRecoverTool (it is available somewhere on internet).


*** History ***

v1.0 (20.06.2005) - first public version

v0.1 (30.05.2005) - (unofficial) first working version


*** Furute ***

- partition enlarging support
- maybe GUI


*** Author, contact and copyright infos ***

SFSresize has been written by Marek 'March' Szyprowski <marek@amiga.pl>.
Mail me if you have any suggestions or found a bug.

Copyright (C) 2005  Marek 'March' Szyprowski <marek@amiga.pl>

SFSresize uses libDeviceIO by Marcin Kurek (Morgoth/Dreamolers-CAPS).


*** Thanks ***

Marcin Kurek (Morgoth/Dreamolers-CAPS) - for libDeviceIO and SFScheck tool

GrxMrx - for testing and motivation