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


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

SYNOPSIS
    success = AddBuffers(filesystem, number)
    D0                     D1          D2

    BOOL AddBuffers(STRPTR, LONG)

FUNCTION
    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().

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

RESULT
    success    - Success or failure of command.

BUGS
    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.

SEE ALSO
    IoErr()