hpux man page for acc_link

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)