aCC_link(1)aCC_link(1)NAMEaCC_link - bundled aC++ driver for linking only
SYNOPSIS
[options] files
DESCRIPTION
invokes the HP-UX linker.
The command is made available for linking aC++ objects for deployment
on enduser systems. This command explicitly disallows certain options
used to compile. It also disallows, with an error, any files that look
like source files.
accepts several types of arguments as files:
Arguments of the form
cause the linker to search the library (Integrity servers)
or (PA-RISC) or in an attempt to resolve currently unre‐
solved external references. Because a library is searched
when its name is encountered, placement of a is signifi‐
cant. If a file contains an unresolved external reference,
the library containing the definition must be placed after
the file on the command line. See ld(1) for further
details.
Arguments of the form
cause the linker to search the library (Integrity servers)
or (PA-RISC) or (depending on suffix) in an attempt to
resolve currently unresolved external references. It is
similar to the option except the current state of the
option is not important.
Other Suffixes
All other arguments, such as those names ending with or are
taken to be relocatable object files and are passed to (see
ld(1)) to be included in the link operation.
Arguments and options can be passed to the driver through the environ‐
ment variable as well as on the command line. The driver reads the
value of and divides these options into two sets; those options which
appear before a vertical bar delimited by whitespace, and those options
which appear after the vertical bar. The first set of options is
placed before any of the command-line parameters to the second set of
options is placed after the command-line parameters to If the vertical
bar is not present, all options are placed before the command-line
parameters. For example (in sh(1) notation),
is equivalent to
When set, the environment variable specifies a directory to be used by
the linker for temporary files, overriding the default directory
Options
for more information about any option, see the To invoke the online
help, use your HTML browser to use the URL
The following options are recognized by
Cause the linker
ld(1) to create a shared library rather than a normal
executable file. Object files processed with this
option must contain position independent code (PIC).
For details see ld(1), HP-UX Linker and Libraries Online
User's Guide and the Programming on HP-UX manual.
Not allowed.
Not allowed.
Refer to the and explanations (first and second items) in the sec‐
tion.
Change the algorithm used by the linker to search for
(Integrity servers) or (PA-RISC) or The option causes ld
to search in dir before searching in the default loca‐
tions. This option is effective only if it precedes the
option on the command line. See ld(1) for details.
Specify outfile as the name for the linker output file. The
default name is
Not allowed.
Not allowed.
Cause the output of the linker to be stripped of symbol table
information. See strip(1) for more details. The use of
this option prevents the use of a symbolic debugger on
the resulting program. Also see ld(1) for additional
details.
If is specified with any other conflicting option, the
option is ignored, regardless of the order in which the
options were specified.
Enable verbose mode, which produces a step-by-step description
of the linking process on standard error.
Display the version numbers of the current driver and linker (if
the linker is executed).
Pass the comma-separated argument(s)
to the linker subprocess. The option specification
allows additional, implementation-specific options to be
recognized by the aCC_link driver.
Do not bind anything to address zero.
This ld(1) option allows run-time detection of null
pointers. See the note on pointers below.
Generate subprocess information for a given command line without
running the subprocesses.
Generate separate timing information for compilation subprocesses.
For each subprocess, estimated time is generated in sec‐
onds for user processes, system calls, and total pro‐
cessing time.
System Dependent Options
The driver supports the following additional operating system dependent
options.
Generate code using either the
ILP32 or LP64 data model. Defined values for data_model are:
Use the ILP32 data model. The sizes of the int, long and
pointer data
types are 32-bits.
Use the LP64 data model. The size of the int data type is
32-bits, and
the sizes of the long and pointer data types are 64-bits.
Options (other)
Any other options that are not defined will generate a warning to stan‐
dard error.
Other arguments are taken to be aC++ compatible object files, typically
produced by an earlier run, or perhaps libraries of aC++ compatible
routines. These files, together with the results of any compilations
specified, are linked (in the order given) to produce an executable
program with the name
Pointers
Accessing the object of a NULL (zero) pointer is technically illegal,
but many systems have permitted it in the past. The following is pro‐
vided to maximize portability of code. If the hardware is able to
return zero for reads of location zero (when accessing at least 8- and
16-bit quantities), it must do so unless the flag is present. The flag
requests that be generated if an access to location zero is attempted.
Writes of location zero may be detected as errors even if reads are
not. If the hardware cannot assure that location zero acts as if it
was initialized to zero or is locked at zero, the hardware should act
as if the flag is always set.
EXTERNAL INFLUENCES
Environment Variables
determines the language in which messages are displayed.
If is not specified in the environment or is set to the empty string,
the value of is used as a default for each unspecified or empty vari‐
able. If is not specified or is set to the empty string, a default of
(see lang(5)) is used instead of If any internationalization variable
contains an invalid setting, behaves as if all internationalization
variables are set to See environ(5).
is used as a prefix for all references to tool set components and must
be set when you use a non-native development kit or a toolset installed
at an alternative location. Some of the toolset components are com‐
piler drivers, Compiler Applications, Preprocessor, Linker, and object
file tools.
is used as a prefix for all references to target set components and
must also be set when using a non-native development kit. Some of the
target set components are header files, archive libraries, and shared
libraries.
International Code Set Support
Single byte and multibyte character code sets are supported.
DIAGNOSTICS
The diagnostics produced by the aCC_link itself are intended to be
self-explanatory. Occasional messages may be produced by the link edi‐
tor.
If any errors occur before is completed, a non-zero value is returned.
Otherwise, zero is returned.
DEPENDENCIES
Refer to the System Dependent Options subsection above for information
about operating system dependent options, for 32-bit or 64-bit data
models.
FILES
object file
shared library, created with
on Integrity servers
shared library, created with
on PA-RISC systems
linked executable output file
temporary files used by the driver or linker
aCC_link driver aCC_link message catalog
link editor,
ld(1)
Runtime startup
(PA-RISC systems)
subspace definitions for executables (PA-RISC 32)
subspace definitions for shared libraries via
(PA-RISC 32)
Other Libraries
standard C library, see HP-UX Reference Section (3). (Integrity
servers)
standard C library, see
HP-UX Reference Section (3). (Integrity servers)
Standard C library (archive version), see
HP-UX Reference Section (3). (PA-RISC systems)
Standard C library (shared version), see
HP-UX Reference Section (3). (PA-RISC systems)
Math Library
(Integrity servers)
Math Library
(Integrity servers)
Math Library
(PA-RISC systems)
Dynamic loader library
(Integrity servers)
Dynamic loader library
(Integrity servers)
Dynamic loader library
(PA-RISC systems)
Dynamic loader
(Integrity servers)
Dynamic loader
(Integrity servers)
Dynamic loader
(PA-RISC systems)
SEE ALSO
Online help
The online help can be displayed using a default HTML browser, or you
can invoke your own HTML browser with the URL
Other topics available are: Compiler Pragmas, Floating Installation and
Implementation Defined aspects of the compiler.
Information is also available on the web at:
Debugging Tools
wdb(1) C, C++ and Fortran symbolic debugger
gdb(1) C, C++ and Fortran symbolic debugger
adb(1) absolute debugger
System Tools
aCC(1) aC++ compiler
ld(1) invoke the link editor
Miscellaneous
strip(1) strip symbol and line number information from an object
file
crt0(3) execution startup routine
end(3C) symbol of the last locations in program
exit(2) termination of a process
Tutorials and Standards Documents
ISO/IEC 14882-1998 - Programming Languages C++.
American National Standard for Information Systems - Programming lan‐
guage C, ANS X3.159-1989.
See the HP aC++ Online help.
Bundled aC++ link - Limited Functionality aCC_link(1)