2 Linking

2 Linking🔗ℹ

procedure
(link-extension quiet?
input-files
output-file) → any
  quiet? : any/c
  input-files : (listof path-string?)
  output-file : path-string?

Links object files to create an extension (normally of a form that can be loaded with load-extension).

The quiet? argument indicates whether command should be echoed to the current output port. The input-files argument is list of compiled object filenames, and output-file is the destination extension filename.

2.1 Linking Parameters🔗ℹ

parameter
(current-extension-linker) → (or/c path-string? #f)
(current-extension-linker linker) → void?
linker : (or/c path-string? #f)

A parameter that determines the executable used as a linker.

The default is set by searching for an executable using the PATH environment variable, or by using the LD or MZSCHEME_DYNEXT_LINKER environment variable if it is defined (and the latter takes precedence). On Windows, it looks for "cl.exe", then "ld.exe" (gcc), then "ilink32.exe" (Borland). On Cygwin, Solaris, FreeBSD 2.x, or HP/UX, it looks for "ld". On other Unix variants, it looks for "cc". #f indicates that no linker could be found.

parameter
(current-extension-linker-flags)
→ (listof (or/c path-string? (-> (listof string?))))
(current-extension-linker-flags flags) → void?
flags : (listof (or/c path-string? (-> (listof string?))))

A parameter that determines flags provided to the linker. See also expand-for-link-variant.

On Windows, default is (list "/LD") for "cl.exe", (list "--dll") for "ld.exe", and (list "/Tpd" "/c") for "ilink32.exe". On Unix, the default varies greatly among platforms. If the LDFLAGS or MZSCHEME_DYNEXT_LINKER_FLAGS (the latter takes precedence) environment variable is defined, then its value is parsed as a list of strings that is appended before the defaults.

parameter
(current-make-link-input-strings)
→ (-> path-string? (listof string?))
(current-make-link-input-strings proc) → void?
proc : (-> path-string? (listof string?))

A parameter that processes linker input arguments; the parameter value takes an input file path and returns a list of strings for the command line. The default is list.

parameter
(current-make-link-output-strings)
→ (-> path-string? (listof string?))
(current-make-link-output-strings proc) → void?
proc : (-> path-string? (listof string?))

A parameter that processes linker output arguments; the parameter value takes an output file path and returns a list of strings for the command line.

On Windows, the default converts "file" to (list "/Fefile") for "cl.exe", something like (list "-e" "_dll_entry@12" "-o" "file") for "ld.exe", and something complex for "ilink32.exe". On Unix, the default converts "file" to (list "-o" "file").

parameter
(current-standard-link-libraries)
→ (listof (or/c path-string? (-> (listof string?))))
(current-standard-link-libraries libs) → void?
libs : (listof (or/c path-string? (-> (listof string?))))

A parameter that determines libraries supplied to the linker, in addition to other inputs. See also expand-for-link-variant.

For most platforms, the default is

(list (build-path (collection-path "mzscheme" "lib")
(system-library-subpath)
(mzdyn-thunk)))

where mzdyn-thunk produces (list "mzdyn.o") for the 'cgc variant and (list "mzdyn3m.o") for the '3m variant. See also current-use-mzdyn).

parameter
(current-use-mzdyn) → boolean?
(current-use-mzdyn use-mzdyn?) → void?
use-mzdyn? : boolean?

A parameter that determines whether the default standard link libraries include the "mzdyn" library which allows the resulting file to be loaded via load-extension. Defaults to #t.

parameter
(link-variant) → (or/c 'normal 'cgc '3m)
(link-variant variant-symbol) → void?
variant-symbol : (or/c 'normal 'cgc '3m)

A parameter that indicates the target for linking, where 'normal is an alias for the result of (system-type 'gc).

2.2 Helper Functions🔗ℹ

procedure
(use-standard-linker name) → void?
name : (or/c 'cc 'gcc 'msvc 'borland 'cw)

Sets the parameters described in Linking Parameters for a particular known linker.

procedure
(expand-for-link-variant l) → any
   l :
(listof (or/c path?
              string?
              (-> (listof string?))))

The same as expand-for-compile-variant.

2.3 Signature🔗ℹ

(require dynext/link-sig)

package: dynext-lib

signature
dynext:link^ : signature

Includes everything exported by the dynext/link module.

2.4 Unit🔗ℹ

(require dynext/link-unit)

package: dynext-lib

value
dynext:link@ : unit?

Imports nothing, exports dynext:link^.