Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.15.5  Slbopen                                                    TOS

 Name:         »Slbopen« - Open a shared library

 Opcode:       22 (0x016)

 Syntax:       int32_t Slbopen( int8_t *name, int8_t *path, int32_t 
               min_ver, SHARED_LIB *sl, SLB_EXEC *fn );

 Description:  The function Slbopen opens a shared library.

                Parameter  Meaning



                name       The name of the library, in capitals, incl. 
                           extension (".SLB"). The library name is the 
                           filename as well.

                path       Path where the library is first looked for 
                           (the path must be terminated in MagiC 5.20 
                           with '\'; this is no longer necessary in 
                           MagiC 6). If the parameter is NULL, or the 
                           library was not found in the specified 
                           bath, then it will be looked for in the 
                           XTENSION folder.(!nl) From MagiC 6 onwards 
                           the environmental variable SLBPATH will be 
                           evaluated. As in PATH, it contains a list 
                           of the search paths, each separated by ';'. 
                           If the variable is defined, then no extra 
                           search will be made in the XTENSION folder.

                           With FreeMiNT an attempt will be made to 
                           load the library from the current directory 
                           if path is NULL.

                min_ver    Lowest required version number of the 
                           library

                sl         Pointer to the descriptor

                fn         Pointer to the function pointer

 Return value:

                >= 0    All OK, version number of the library
                ERANGE  Version number too low
                EACCDN  Library already opened by the process
                EFILNF  Library not found
                ENSMEM  Insufficient memory available

 Availability: As of MagiC 5.20 and FreeMiNT 1.15.4.

 Group:        System functions

 See also:     Binding   Slbclose   Shared libraries