aCC_link(1) General Commands Manual aCC_link(1)
NAME
aCC_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 unresolved exter-
nal references. Because a library is searched when its name is encountered, placement of a is significant. 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 cur-
rently 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 environment 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 com-
mand-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 section.
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 locations. 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 result-
ing 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 seconds for user processes, system calls, and total processing 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 standard 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
provided 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 vari-
able 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 compiler 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 language C, ANS X3.159-1989.
See the HP aC++ Online help.
Bundled aC++ link - Limited Functionality aCC_link(1)
