AminetAminet
Search:
82982 packages online
About
Recent
Browse
Search
Upload
Setup
Services

disk/misc/sfsdoctor-1.2-src.lha

Mirror:Random
Showing:ppc-warpupgeneric
No screenshot available
Short:The disk recovery and repair suite
Author:Marek 'March' Szyprowski <marek at amiga.pl>
Uploader:polluks+aminet sdf lonestar org (Stefan Haubenthal)
Type:disk/misc
Version:1.2
Architecture:generic
Date:2020-03-16
Download:http://aminet.net/disk/misc/sfsdoctor-1.2-src.lha - View contents
Readme:http://aminet.net/disk/misc/sfsdoctor-1.2-src.readme
Downloads:224
SFSDoctor - The Disk Recovery and Repair Suite


***** Instalation *****

Instalation is really easy and simple. Just copy SFSDoctor tool somewhere to
your disk. The preferred place is SYS:Tools. SFSDoctor does not need any third
party MUI classes and system add-ons and works even if the system is started
from plain MorphOS 1.4.5 CD. Is is also advised to burn a rescue CD with this
tools to be able to fix disks and recover files after a complete system and disk
crash.


***** Disclaimer *****

Using repair module of this tool DOES MODIFY your disk. Make sure you have
backed up all your important data.

Remember that YOU USE THIS TOOL ON YOUR OWN RISK!

The author, developers, and all concerned cannot and will not take
responsibility for any damage done to your data or disks.


***** Common use cases *****

* Checking disk for errors:

Easiest case. Just select your partition and press 'Check disk' button.


* Repairing non-critical (i.e. checksum error in adminspace block) disk errors:

Select your partition and press 'Scan disk' button. Check if all your files are
listed. Also check if there are any errors reported in the log. Make sure that
all files you want to keep on the disk are 'marked'. Press 'Repair disk' button,
select file to save metadata backup and wait a minute.

WARNING - 'Repair disk' action DOES MODIFY your partition. Please read the
discaimer.


* Recovering files from damaged disk to another partition:

Select your partition and press 'Scan disk' button. If there were critical
errors in disk structure you may even get information, that no SFS filesystem
has been found on the disk. Just ignore this message. If you don't have much
time you may mark 'Quick scan' option. Disabling that option will result in
complete scan, which gives better results, but takes considerably more time.
Also mark the 'Allow location quessing' option. Press 'Find lost files' button
and wait until this operation finishes. After some time (depending on the size
of your partition) you will see the list of files and dirs that has been found
on disk. You may also get an information that some files are colliding with
other ones. Just ignore this.

Select all files you want to recover with 'Mark' option and then press 'Recover
files' button. Some recovered files may be a complete garbage. This usually
happens when you recover one of file that were on colliding file list.


* Repairing disk after serious damage (i.e. quick format, trashed root blocks):

Like in previous paragraph, first you need to use 'Scan disk' module, then 'Find
lost files' module. Selecting 'Allow location guessing' usually is a bad idea,
because it will create a lot of dummy, colliding files. You would get a
directory tree of files found on disk. The log you may also get a list of
colliding files. If you got no collidion files after 'Find lost files' action
you are lucky :)

Colliding files are two (or more) files that occupies the same blocks on disk
(simmilar to 'crossed files' known from FAT checking tools). Such files cannont
normally exist on disk. They very often appears during 'Find lost files' action,
when SFSDoctor find an old file descriptor. That descriptor for some reasons has
not been cleared/reaused. It was describing a file that was deleted, overwritten
or moved to other place on disk. However such files cannot be distinguished from
normal files, that's way they appear in file list. Usually the pair of colliding
files consist of a real, 'normal' file and a 'dead' one.

If you want to repair filesystem structure, there can't be any colliding files
in directory tree. The best way to decide which file from colliding files pair
is real one is to recover both files to another disk with 'Recover files' module
and check the content of recovered files. With this method you should easily
find all 'dead' files in directory tree. This is a bit long and laborius
process, but this really can't be done in other way. Usually if you find one
'dead' file in a directory, then all files in such directory are 'dead'.

You may always check if all files that are 'marked' collides with themself by
pressing 'Check collisions' button. Make sure that all 'dead' files are not
marked. Select 'Repair disk' button. All files that are not marked will be
removed from directory tree, then whole directory tree will be recreated on
disk.

WARNING - 'Repair disk' action DOES MODIFY your partition. Please read the
discaimer.  


* Continue interrupted (power failure, application crash) 'Repair disk' action:

During the disk repair action all information about files is being overwritten
on disk. That's why before this happen so called metadata backup is created.
Make sure that this file is stored on other, working partition (and don't use
Ram Disk for it!). If the repair operation is interrupted, reboot the system
then run SFSDoctor and use 'Load backup' module. Select 'Repair disk' button to
process the operation again.


* Changing the filesystem options (recycled dir presence or case sensitivness)

This operation doesn't really differ from repairing non-critical errors. Select
your partition and press 'Scan disk' button. Check if all your files are listed.
Also check if there are any errors reported in the log. Make sure that all files
you want to keep on the disk are 'marked'. Change filesystem options in 'Repair
disk options' group, then press 'Repair disk' button, select file to save
metadata backup and wait a minute.

WARNING - 'Repair disk' action DOES MODIFY your partition. Please read the
discaimer.


* Operating on badly damaged partition that causes system to crash

It may happen that your partition is damaged so badly that SFS filesystem driver
throws a lot of error requesters, decreases heavily system stability or even
crashes. In such case it is advised to run system from rescue or system CD, then
quickly run SCSIConfig tool and select damaged partition. Change filesystem type
for that partition to FFS. This will prevent SFS driver from loading and
crashing. Make sure that you do not change any other partition parameter. Save
changes and reboot. This operation does not modify or affect any data on the
partition.

Damaged partition is now not visible, but the system operates stable. Run
SFSDoctor and select 'Show all' option in device group. The damaged partition
should be now listed in device list and you can operate on it. When you finish
the repair run SCSIConfig and change filesystem type back to SFS. After reboot
the partition will be visible again.

ADVISE: Do not try to quick format such partition and then restore data from it.
Although it is possible, it will cause damage to the directory tree and some
files. The method with changing filesystem type usually allows to repeair the
disk completely without any loosing any file.


***** Configuration options *****

There are 2 tooltypes that changes the amount of memory used by SFSDoctor for
disk cache buffers:

* BUFFERSIZE - size of single buffer in bytes - this is the amount of data read
in
  single disk access; in most cases the default value is the right one

* NUMBUFFERS - total number of buffers - SFSDoctor will consume
  (BUFFERSIZE * NUMBUFFERS) bytes of memory; higher number of buffers usually
  speeds up scan and check operations


***** Known problems *****

* Window title bar gets corrupted when device list is ghosted - this is known
  MUI 3.9 bug

* You may get an information that your partition is being used by other
  applications even if you just started the system and there are no other
programs
  running - this is problably caused by an assign made during system startup.


***** Thanks *****

The author would like to thank following people: 

* John Hendrikx - for SmartFileSystem
* Marcin 'Morgoth' Kurek - for help in understanding SFS structures, source code
  examples and libDeviceIO library
* Michal 'kiero' Wozniak - for patience, help in finding bugs, alpha and beta
  testing
* Krzysztof 'Tarnak' Kretus and Michal 'Rzookol' Zukowski - for beeing so brave
  to do alpha and beta testing
* Tomasz 'Kaczus' Kaczanowski - for suggestions, help in development and beta
  testing
* Marian 'MaaG' Guc - for AutoDocReader and help in development
* whole #castor-cvs team - for motivation and help with MUI problems
* Tokai and JoBBo - for really nice icons
* Stefan Stuntz - for MUI
* Dietmar Eilert - for MorphED
* Targhan - for managing SFSDoctor bounty donations
* all who I forgot to list here

Special thanks to people who donated this project:
* amigaharry
* Weiseb
* Henes
* saragaglia
* GerdK
* roschmyr
* pegasosuser
* RMS
* DrB


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

SFSDoctor has been written by Marek 'March' Szyprowski.
Contact: <marek at amiga.pl> 

Copyright (C) 2005-2007  Marek 'March' Szyprowski.

SFSDoctor is a free software.



Contents of disk/misc/sfsdoctor-1.2-src.lha
 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                    0       0 100.0% -lh0- 0000 Dec 25  2006 SFSDoctor/bin/.dummy
[generic]                 6415   17208  37.3% -lh5- 9fa4 Jan 13  2007 SFSDoctor/bin/catalogs/polski/sfsdoctor.catalog
[generic]                 7023    7023 100.0% -lh0- 1d23 May 26  2006 SFSDoctor/bin/SFSDoctor.info
[generic]                 1028    2711  37.9% -lh5- 8b17 Jan  4  2007 SFSDoctor/config.mk
[generic]                  196     492  39.8% -lh5- 8341 Dec 31  2006 SFSDoctor/config_gcc2.mk
[generic]                  323     905  35.7% -lh5- ff0d Jan  4  2007 SFSDoctor/config_gcc4.mk
[generic]                  159     468  34.0% -lh5- ddf1 Jan  4  2007 SFSDoctor/config_toplevel.mk
[generic]                 1496    3318  45.1% -lh5- 430a Jan 13  2007 SFSDoctor/doc/Changelog
[generic]                  712    1218  58.5% -lh5- cc54 Mar 26  2006 SFSDoctor/doc/LICENSE
[generic]                 3718    9034  41.2% -lh5- 2740 Jan 11  2007 SFSDoctor/doc/Readme
[generic]                12125   36697  33.0% -lh5- 4aa3 Jan 13  2007 SFSDoctor/locale/polski/SFSDoctor.ct
[generic]                  135     341  39.6% -lh5- 50ed Jan  4  2007 SFSDoctor/Makefile
[generic]                 4575    4732  96.7% -lh5- ea57 Dec 24  2003 SFSDoctor/release/SFSDoctor.info
[generic]                 7151    7285  98.2% -lh5- f434 Dec 24  2003 SFSDoctor/release/SFSDoctor/Changelog.info
[generic]                 7151    7285  98.2% -lh5- f434 Dec 24  2003 SFSDoctor/release/SFSDoctor/Readme.info
[generic]                 7023    7023 100.0% -lh0- 1d23 Mar 18  2006 SFSDoctor/release/SFSDoctor/SFSDoctor.info
[generic]                 4674    4755  98.3% -lh5- 8746 Mar 18  2006 SFSDoctor/release/SFSDoctor/SFSDoctor2.info
[generic]                  889    2947  30.2% -lh5- e9c3 Jan  4  2007 SFSDoctor/rules.mk
[generic]                  709    2002  35.4% -lh5- cef4 Jan  4  2007 SFSDoctor/rules_eval.mk
[generic]                  338     916  36.9% -lh5- 6747 Jan  4  2007 SFSDoctor/src/config_eval.mk
[generic]                  364     994  36.6% -lh5- 7ab7 Jan  4  2007 SFSDoctor/src/config_parse.mk
[generic]                  420    1180  35.6% -lh5- ef7f Jan  4  2007 SFSDoctor/src/config_project.mk
[generic]                  359     640  56.1% -lh5- 7744 Sep 13  2006 SFSDoctor/src/include/chsign.h
[generic]                  188     493  38.1% -lh5- d340 Dec 25  2006 SFSDoctor/src/Makefile
[generic]                    0       0 100.0% -lh0- 0000 Dec 25  2006 SFSDoctor/src/sfsdoctor/.objs/.dummy
[generic]                 3059   10643  28.7% -lh5- 5a33 Jan 13  2007 SFSDoctor/src/sfsdoctor/act_backupfile.c
[generic]                 4704   20848  22.6% -lh5- cd26 Jan 13  2007 SFSDoctor/src/sfsdoctor/act_checkdisk.c
[generic]                 4497   15744  28.6% -lh5- 75aa Jan  9  2007 SFSDoctor/src/sfsdoctor/act_rebuild.c
[generic]                 1391    3606  38.6% -lh5- d4ad Jan 13  2007 SFSDoctor/src/sfsdoctor/act_salvage.c
[generic]                 3555   12436  28.6% -lh5- 9288 Jan  9  2007 SFSDoctor/src/sfsdoctor/act_scandisk.c
[generic]                 3263   12547  26.0% -lh5- 1c54 Nov 21  2005 SFSDoctor/src/sfsdoctor/asfs_adminspace.c
[generic]                  934    2829  33.0% -lh5- b8ea Nov 21  2005 SFSDoctor/src/sfsdoctor/asfs_cbuffer.c
[generic]                  965    2329  41.4% -lh5- 49b4 Dec 21  2005 SFSDoctor/src/sfsdoctor/asfs_dir.c
[generic]                 5217   20751  25.1% -lh5- 6a45 Nov 22  2005 SFSDoctor/src/sfsdoctor/asfs_extents.c
[generic]                  649    1444  44.9% -lh5- 1300 Dec 25  2006 SFSDoctor/src/sfsdoctor/asfs_namei.c
[generic]                 3391   13171  25.7% -lh5- 4ea0 Nov 21  2005 SFSDoctor/src/sfsdoctor/asfs_nodes.c
[generic]                 6506   24558  26.5% -lh5- 64c7 Dec  4  2005 SFSDoctor/src/sfsdoctor/asfs_objects.c
[generic]                 2541    7121  35.7% -lh5- fb0d Dec 25  2006 SFSDoctor/src/sfsdoctor/asfs_structures.h
[generic]                 1753    6102  28.7% -lh5- 2eaa May 28  2006 SFSDoctor/src/sfsdoctor/asfs_wraper.h
[generic]                  180     493  36.5% -lh5- 7e72 Jan  4  2007 SFSDoctor/src/sfsdoctor/config.mk
[generic]                 2674   12133  22.0% -lh5- c4a9 Jan  9  2007 SFSDoctor/src/sfsdoctor/find_containers.c
[generic]                 2795   10501  26.6% -lh5- c863 Jan  9  2007 SFSDoctor/src/sfsdoctor/find_extents.c
[generic]                 3103   10085  30.8% -lh5- 709f Jan  9  2007 SFSDoctor/src/sfsdoctor/find_main.c
[generic]                 2409    9581  25.1% -lh5- 426f Jan  9  2007 SFSDoctor/src/sfsdoctor/fs_check.c
[generic]                 2032    6943  29.3% -lh5- 2af1 Dec 25  2006 SFSDoctor/src/sfsdoctor/fs_common.c
[generic]                 1136    3611  31.5% -lh5- 70b8 Dec 25  2006 SFSDoctor/src/sfsdoctor/fs_protos.h
[generic]                 1551    4526  34.3% -lh5- 3d33 Dec 25  2006 SFSDoctor/src/sfsdoctor/fs_read.c
[generic]                  965    2615  36.9% -lh5- d71c Dec 25  2006 SFSDoctor/src/sfsdoctor/fs_structures.h
[generic]                 1271    3506  36.3% -lh5- d986 May 26  2006 SFSDoctor/src/sfsdoctor/gui_classes.h
[generic]                 1565    4130  37.9% -lh5- 6b93 Jan  9  2007 SFSDoctor/src/sfsdoctor/gui_devlist.c
[generic]                 5250   30936  17.0% -lh5- fb71 Jan 10  2007 SFSDoctor/src/sfsdoctor/gui_main.c
[generic]                 1771    8876  20.0% -lh5- 8a63 Jan  9  2007 SFSDoctor/src/sfsdoctor/gui_notifs.c
[generic]                 1482    4020  36.9% -lh5- ba82 Jan 13  2007 SFSDoctor/src/sfsdoctor/gui_objectlist.c
[generic]                 3227   13871  23.3% -lh5- cd87 Jan 10  2007 SFSDoctor/src/sfsdoctor/gui_selector.c
[generic]                  751    2067  36.3% -lh5- e491 Jan  8  2007 SFSDoctor/src/sfsdoctor/gui_util.h
[generic]                 5346   25471  21.0% -lh5- a95f Jan 13  2007 SFSDoctor/src/sfsdoctor/gui_worker.c
[generic]                  236     834  28.3% -lh5- 8ffe Jan 21  2005 SFSDoctor/src/sfsdoctor/include/bitfuncs_protos.h
[generic]                  823    3042  27.1% -lh5- b3cf Apr 13  2006 SFSDoctor/src/sfsdoctor/include/clib/fsdevice_protos.h
[generic]                 1484    6481  22.9% -lh5- ac50 Sep 25  2006 SFSDoctor/src/sfsdoctor/include/clib/fssupport_protos.h
[generic]                 1944    6826  28.5% -lh5- 882c Jan 21  2005 SFSDoctor/src/sfsdoctor/include/deviceio.h
[generic]                  595    2049  29.0% -lh5- 0b56 Dec 25  2006 SFSDoctor/src/sfsdoctor/include/deviceio_protos.h
[generic]                   90     141  63.8% -lh5- bc79 May 28  2006 SFSDoctor/src/sfsdoctor/include/devio.h
[generic]                  390     792  49.2% -lh5- 1f5e Sep 13  2006 SFSDoctor/src/sfsdoctor/include/fsdevice/cache.h
[generic]                 1034    2984  34.7% -lh5- 2d09 Sep 13  2006 SFSDoctor/src/sfsdoctor/include/fsdevice/geometry.h
[generic]                 2928    9428  31.1% -lh5- 772a Sep 13  2006 SFSDoctor/src/sfsdoctor/include/fsdevice/io.h
[generic]                  162     343  47.2% -lh5- 9203 Apr 13  2006 SFSDoctor/src/sfsdoctor/include/fsdevice/macros.h
[generic]                  150     238  63.0% -lh5- 3c7b Apr 13  2006 SFSDoctor/src/sfsdoctor/include/fssupport/clipboard.h
[generic]                  289     631  45.8% -lh5- d7c8 Nov  2  2006 SFSDoctor/src/sfsdoctor/include/fssupport/macros.h
[generic]                  363     786  46.2% -lh5- d06d Aug 20  2006 SFSDoctor/src/sfsdoctor/include/fssupport/message.h
[generic]                  309     505  61.2% -lh5- b363 Apr 13  2006 SFSDoctor/src/sfsdoctor/include/fssupport/req.h
[generic]                  467    1450  32.2% -lh5- acc4 Apr 13  2006 SFSDoctor/src/sfsdoctor/include/fssupport/simplecache.h
[generic]                  377    1011  37.3% -lh5- 9a56 Apr 13  2006 SFSDoctor/src/sfsdoctor/include/fssupport/simpletree.h
[generic]                  159     377  42.2% -lh5- 9378 Apr 13  2006 SFSDoctor/src/sfsdoctor/include/fssupport/tagbase.h
[generic]                  487    1296  37.6% -lh5- e4b6 Apr 13  2006 SFSDoctor/src/sfsdoctor/include/fssupport/timer.h
[generic]                  372    1195  31.1% -lh5- b1c6 Jun  4  2006 SFSDoctor/src/sfsdoctor/include/libraries/fsdevice.h
[generic]                  415    1337  31.0% -lh5- da47 Jun  4  2006 SFSDoctor/src/sfsdoctor/include/libraries/fssupport.h
[generic]                  216     428  50.5% -lh5- 2d00 Apr 15  2006 SFSDoctor/src/sfsdoctor/include/mfs_tagbase.h
[generic]                  212     478  44.4% -lh5- 1fa1 May 25  2006 SFSDoctor/src/sfsdoctor/include/mui_wraper.h
[generic]                  959    6101  15.7% -lh5- 0b68 Dec 17  2006 SFSDoctor/src/sfsdoctor/include/ppcinline/fsdevice.h
[generic]                 1962   16319  12.0% -lh5- a5f3 Dec 17  2006 SFSDoctor/src/sfsdoctor/include/ppcinline/fssupport.h
[generic]                  293     680  43.1% -lh5- 2cf4 Dec 17  2006 SFSDoctor/src/sfsdoctor/include/proto/fsdevice.h
[generic]                  295     689  42.8% -lh5- 85e2 Dec 17  2006 SFSDoctor/src/sfsdoctor/include/proto/fssupport.h
[generic]                  537    1133  47.4% -lh5- 4b09 Jul 16  2006 SFSDoctor/src/sfsdoctor/include/resources.h
[generic]                 1328    7323  18.1% -lh5- c947 Oct 31  2006 SFSDoctor/src/sfsdoctor/include/resources_protos.h
[generic]                 6010   17854  33.7% -lh5- fe64 Jan 21  2005 SFSDoctor/src/sfsdoctor/lib/libbitfuncs.a
[generic]                30078   85634  35.1% -lh5- a543 Jan 21  2005 SFSDoctor/src/sfsdoctor/lib/libdeviceio.a
[generic]                20492   57038  35.9% -lh5- 92c4 Dec 25  2006 SFSDoctor/src/sfsdoctor/lib/libresources.a
[generic]                  712    1218  58.5% -lh5- cc54 Mar 26  2006 SFSDoctor/src/sfsdoctor/LICENSE
[generic]                 6379   22162  28.8% -lh5- 1ec0 Jan 13  2007 SFSDoctor/src/sfsdoctor/locale/SFSDoctor.cd
[generic]                  534    1689  31.6% -lh5- 48f1 Jan 10  2007 SFSDoctor/src/sfsdoctor/Makefile
[generic]                  367     890  41.2% -lh5- 5dc1 Jun 17  2006 SFSDoctor/src/sfsdoctor/SFSDoctor_rev.h
[generic]                    4       4 100.0% -lh0- 92fb Jan  4  2007 SFSDoctor/src/sfsdoctor/SFSDoctor_rev.ver
[generic]                13362   32600  41.0% -lh5- b22a Jan  4  2007 SFSDoctor/tools/apwd
[generic]                 4881    8236  59.3% -lh5- 424f Apr 13  2006 SFSDoctor/tools/bump
[generic]                  444     911  48.7% -lh5- c094 Jan  4  2007 SFSDoctor/tools/bump-c
[generic]                 2918    7292  40.0% -lh5- ad98 Dec 25  2006 SFSDoctor/tools/fixdeps
[generic]                39044   99144  39.4% -lh5- b5bf Jan  4  2007 SFSDoctor/tools/flexcat
[generic]                  414     899  46.1% -lh5- 4638 Jan 10  2007 SFSDoctor/tools/lib/C_c.sd
[generic]                  237     472  50.2% -lh5- 95ce Jan 10  2007 SFSDoctor/tools/lib/C_h.sd
[generic]                 2693    6844  39.3% -lh5- 148e Jan  4  2007 SFSDoctor/tools/rpath
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total       100 files  294549  844945  34.9%            Mar 17 00:16

Aminet © 1992-2020 Urban Müller and the Aminet team. Aminet contact address: <aminetaminet net>