[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]

    AddBuffers -- Changes the number of buffers for a filesystem (V36)

    success = AddBuffers(filesystem, number)
    D0                     D1          D2

    BOOL AddBuffers(STRPTR, LONG)

    Adds buffers to a filesystem.  If it succeeds, the number of current
    buffers is returned in IoErr().  Note that "number" may be negative.
    The amount of memory used per buffer, and any limits on the number of
    buffers, are dependant on the filesystem in question.
    If the call succeeds, the number of buffers in use on the filesystem
    will be returned by IoErr().

    filesystem - Name of device to add buffers to (with ':').
    number     - Number of buffers to add.  May be negative.

    success    - Success or failure of command.

    The V36 ROM filesystem (FFS/OFS) doesn't return the right number of
    buffers unless preceded by an AddBuffers(fs,-1) (in-use buffers aren't
    counted).  This is fixed in V37.

    The V37 and before ROM filesystem doesn't return success, it returns
    the number of buffers.  The best way to test for this is to consider
    0 (FALSE) failure, -1 (DOSTRUE) to mean that IoErr() will have the
    number of buffers, and any other positive value to be the number of
    buffers.  It may be fixed in some future ROM revision.