Skip to content

Latest commit

 

History

History
45 lines (31 loc) · 1.33 KB

AddBuffers.md

File metadata and controls

45 lines (31 loc) · 1.33 KB
Raw

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