wlink

link command (WATCOM)

Syntax:

wlink {directive}

Options:

• ALIAS symbol_name=symbol_name{,symbol_name=symbol_name}
• DEBUG [[WATCOM] db_list | CODEVIEW | DWARF]

  where db_list is a list of one or more debugging options, separated by commas. The debugging options are as follows:

  • LINES
  • TYPES
  • LOCALS
  • STATIC
  • ALL
• DISABLE msg_num{,msg_num}
• FILE obj_spec{,obj_spec}

  where obj_spec is defined as

  obj_file[(obj_module)] | library_file[(obj_module)]

• FORMAT form
• LIBFILE obj_file{,obj_file}
• LIBPATH path_name{:path_name}
• LIBRARY library_file{,library_file}
• MODTRACE obj_spec{,obj_spec}
• NAME exe_file
• NEWSEGMENT
• OPTION option{,option}

  where option is one of the following:

  • ARTIFICIAL
  • [NO]CACHE
  • [NO]CASEEXACT
  • CVPACK
  • DOSSEG
  • ELIMINATE
  • HEAPSIZE=n
  • LINEARRELOCS
  • LONGLIVED
  • MANGLEDNAMES
  • MAP[=map_file]
  • MAXERRORS=n
  • NAMELEN=n
  • NODEFAULTLIBS
  • NORELOCS
  • OFFSET=n
  • OSNAME='string'
  • PACKCODE=n
  • PACKDATA=n
  • PRIVILEGE=n
  • QUIET
  • REDEFSOK
  • RESOURCE[=resource_file | 'string']
  • STACK=n
  • STATICS
  • SYMFILE[=symbol_file]
  • UNDEFSOK
  • VERBOSE
• PATH path_name{:path_name}
• REFERENCE symbol_name{,symbol_name}
• SEGMENT seg_desc{,seg_desc}

  where seg_desc is a seg_id followed by one or more seg_attrs, and

  seg_id

  is one of

  • 'seg_name'
  • CLASS 'class_name'
  • TYPE [CODE | DATA]

  seg_attrs

  is one of

  • EXECUTEONLY
  • EXECUTEREAD
  • READONLY
  • READWRITE

• SORT [GLOBAL] [ALPHABETICAL]
• SYMTRACE symbol_name{,symbol_name}
• SYSTEM BEGIN system_name {directive} END
• SYSTEM system_name
• # comment
• @ directive_file

Description:

The wlink utility is used to link object files into an executable file. It uses the directives listed above, where

obj_file

is a file specification for the name of an object file. If no file extension is specified, a file extension of .o is assumed.

library_file

is a file specification for the name of a library file. If library_file appears in a LIBRARY directive, and no file extension is specified, a file extension of .lib is assumed. If library_file appears in a FILE directive, and no file extension is specified, a file extension of .o is assumed.

When a library file is specified in a FILE directive, and obj_module is specified, the object module identified by obj_module is extracted from the library file and included in the executable file. If obj_module isn't specified (that is, only the library file is specified), all object modules in the library are included in the executable file.

obj_module

is the name of an object module contained in a library file or object file.

exe_file

is a file specification for the name of the executable file. No file extension is assumed.

path_name

is a path name.

msg_num

is a message number.

directive_file

is a file specification for the name of a linker directive file. If no file extension is specified, a file extension of .lnk is assumed.

map_file

is a file specification for the name of the map file. If no file extension is specified, a file extension of .map is assumed.

symbol_file

is a file specification for the name of the symbol file. If no file extension is specified, a file extension of .sym is assumed.

symbol_name

is the name of a symbol.

alias_name

is the name of an alias symbol.

system_name

is the name of a system.

comment

is any sequence of characters.

n

represents a value. The complete form of n is as follows:

      [0x]d{d}[k|m]
      

d represents a decimal digit. If 0x is specified, the string of digits represents a hexadecimal number. If k is specified, the value is multiplied by 1024. If m is specified, the value is multiplied by 1024*1024.

See also:

the Linker chapter in the Watcom Compiler & Tools User's Guide