New MiNT system calls: Slbopen()

Slbopen()

LONG Slbopen(name, path, minver, sl, fn)

CHAR *name;
CHAR *path;
LONG minver;
LONG *sl;
LONG *fn;

Slbopen() open a MagiC-style shared library.

Opcode 22 (0x016)

Availability Available as of FreeMiNT version 1.15.4.

Parameters name specifies the filename of the shared library to open (without path). The filename should exactly match the name stored in the library header, including possible extension, possible dots and casing.
path is the path where to search for the library. If NULL, the current directory is assumed.
minver minimum version number of the library.
sl a pointer to a longword which will be filled with the library handle upon return from the call.
fn a pointer to a longword which will be filled with the pointer that should be jumped through in order to use a function of the library.

Binding
pea fn pea sl move.l #minver,-(sp) pea path pea name move.w #$0016,-(sp) trap #1 lea 22(sp),sp

Return Value Slbopen() returns a positive version number of the successfully opened library, or a negative GEMDOS error code otherwise.

Caveats The original implementation performs PATH searching for the library of the specified filename, if the path parameter passed to the Slbopen() function is NULL. Current FreeMiNT versions do NOT support this behaviour, the library is attempted to be loaded from the current directory instead.
The Slbopen() call must me made from user mode, or SIGSYS will be generated otherwise in order to kill the calling process.

See Also Slbclose(),

	Slbopen() open a MagiC-style shared library.

Opcode	22 (0x016)

Availability	Available as of FreeMiNT version 1.15.4.

Parameters	name specifies the filename of the shared library to open (without path). The filename should exactly match the name stored in the library header, including possible extension, possible dots and casing. path is the path where to search for the library. If NULL, the current directory is assumed. minver minimum version number of the library. sl a pointer to a longword which will be filled with the library handle upon return from the call. fn a pointer to a longword which will be filled with the pointer that should be jumped through in order to use a function of the library.

Binding	pea fn pea sl move.l #minver,-(sp) pea path pea name move.w #$0016,-(sp) trap #1 lea 22(sp),sp

Return Value	Slbopen() returns a positive version number of the successfully opened library, or a negative GEMDOS error code otherwise.

Caveats	The original implementation performs PATH searching for the library of the specified filename, if the path parameter passed to the Slbopen() function is NULL. Current FreeMiNT versions do NOT support this behaviour, the library is attempted to be loaded from the current directory instead. The Slbopen() call must me made from user mode, or SIGSYS will be generated otherwise in order to kill the calling process.

See Also	Slbclose(),