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


NAME
    ReadLink -- Reads the path for a soft filesystem link (V36)

SYNOPSIS
    success = ReadLink( port, lock, path, buffer, size)
    D0                   D1    D2    D3     D4     D5

    BOOL ReadLink( struct MsgPort *, BPTR, STRPTR, STRPTR, ULONG)

FUNCTION
    ReadLink() takes a lock/name pair (usually from a failed attempt
    to use them to access an object with packets), and asks the
    filesystem to find the softlink and fill buffer with the modified
    path string.  You then start the resolution process again by
    calling GetDeviceProc() with the new string from ReadLink().

    Soft-links are resolved at access time by a combination of the
    filesystem (by returning ERROR_IS_SOFT_LINK to dos), and by
    Dos (using ReadLink() to resolve any links that are hit).

INPUTS
    port - msgport of the filesystem
    lock - lock this path is relative to on the filesystem
    path - path that caused the ERROR_IS_SOFT_LINK
    buffer - pointer to buffer for new path from handler.
    size - size of buffer.

RESULT
    Success - boolean

BUGS
    In V36, soft-links didn't work in the ROM filesystem.  This was
    fixed for V37.

SEE ALSO
    MakeLink(), Open(), Lock(), GetDeviceProc()