DLL Programmer's Guide for TNS/R Systems

Essential DLL Facility Controls
DLL Programmer’s Guide for TNS/R Systems—522203-002
2-4
File-Name Qualification
•
The -dllname nameofdll option, when used by itself, also assigns
nameofdll to the file.
•
You can use both the -dllname and -o options with the same name in each.
The following example of the first option gives the resulting DLL the name mainout
and also stores it in a file named mainout.
ld linkfile1 linkfile2 -dll -o mainout
-soname is a synonym for -dllname.
If you do not insert either a -dllname or a -o option, the linker will assign the
same default name to both the DLL and the output file. If the linker is running on a
Guardian host, that name is aout; otherwise, it is a.out.
File-Name Qualification
The linker distinguishes between:
•
an unqualified, or simple file name, which identifies a file within a directory or
subvolume but which must be appended to the directory or subvolume definition
and expanded with file-name augmentation according to the file system, as
described in Augmenting Library Names Automatically in Searches on page 5-2
•
a partially qualified file name, which identifies the file uniquely in the file system
where the name is used.
•
a fully qualified file name: for Guardian, has $vol.subvol.name, perhaps prefaced
by \system; for OSS, begins with /.
The linker identifies a qualified file name as one that contains:
•
On Guardian – a period, backward slash, or dollar sign
•
On OSS – a forward slash
•
On Win32 – a forward slash, a backward slash, or a colon
All other file names are regarded as unqualified.
For any stand-alone file name (specifying a linker input), the handling is much the
same:
•
Guardian: apply the =_DEFAULTS define to fill in any system, volume, or subvol
that is missing. (This is a no-op for a fully qualified name).
•
OSS: if it's "absolute" (begins with a /), take it as is; otherwise append it to the
current working directory.
•
Win32: as above, except for drive: and \ issues.
The distinctions become more important for file names specified by the -lib (-l) option.
In this case, only unqualified names are subject to searching through the list of paths.
Partially or fully qualified names are treated as above.