Short:        Flush all filesystem buffers to disk
Author:       davide.cutugno@gmail.com (Davide Cutugno)
Uploader:     davide cutugno gmail com (Davide Cutugno)
Type:         disk/misc
Version:      1.0
Architecture: m68k-amigaos >= 2.0.4

                      ____  _     _     _____ _           _     
                     |  _ (_)   | |   |  ___| |         | |    
                     | | | |_ ___| | __| |__ | |_   _ ___| |__  
                     | | | | / __| |/ /|  __|| | | | / __| '_  
                     | |/ /| __    < | |___| | |_| __  | | |
                     |___/ |_|___/_|_|_|   |_|__,_|___/_| |_|
                     =============================================
                                    Version 1.0
                              (c) 2025 Davide Cutugno


INTRODUCTION
===========================================================================

DiskFlush is a utility that ensures all filesystem buffers are written to
disk. It's especially useful before performing a fast reboot to prevent any
data loss from cached writes that haven't yet been committed to disk.

When the Amiga filesystem caches data, there's always a short delay before
it actually writes that data to physical media. DiskFlush forces an immediate
write of all cached data across all mounted volumes.


REQUIREMENTS
===========================================================================

- AmigaOS 2.0 or higher


INSTALLATION
===========================================================================

Simply copy DiskFlush to a location in your path, such as:
    C:      (System commands directory)
    SYS:Tools  (Common tools directory)
    

USAGE
===========================================================================

    DiskFlush [QUIET] [VERBOSE]
    
Options:
    QUIET   - Suppresses all progress messages
    VERBOSE - Displays detailed progress information for each operation


OPERATION
===========================================================================

DiskFlush performs the following operations for each mounted volume:

1. Sends ACTION_FLUSH packet to write all dirty buffers to disk
2. Sends ACTION_INHIBIT with DOSTRUE to perform disk driver update
3. Sends ACTION_INHIBIT with DOSFALSE to release the inhibition

This ensures a complete synchronization of all cached data with physical
media across all mounted drives in your system.


EXAMPLES
===========================================================================

Standard use (shows essential messages):
    DiskFlush
    
Silent operation (suppresses all messages):
    DiskFlush QUIET
    
Verbose operation with detailed messages:
    DiskFlush VERBOSE
    
Before reboot:
    DiskFlush
    reboot


HISTORY
===========================================================================

1.0 (16.5.2025)
- First public release


LEGAL
===========================================================================

Copyright © 2025 Davide Cutugno
All Rights Reserved.

This software is provided as-is, without any express or implied warranty.
In no event will the author be held liable for any damages arising from
the use of this software.

Permission is granted to anyone to use this software for any purpose,
except commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
   claim that you wrote the original software.
2. Altered versions must be plainly marked as such, and must not be
   misrepresented as being the original software.
3. This notice may not be removed or altered from any distribution.


CONTACT
===========================================================================

For bug reports, suggestions, or other communications:

    Davide Cutugno

Thank you for using DiskFlush!