cc_bundled man page on HP-UX

Printed from http://www.polarhome.com/service/man/?qf=cc_bundled&af=0&tf=2&of=HP-UX

cc_bundled(1)							 cc_bundled(1)

NAME
       cc_bundled: cc - bundled C compiler

SYNOPSIS
       [options] files

DESCRIPTION
       invokes the HP-UX bundled compiler.  C source code is compiled directly
       to object code.

       The command uses the (Itanium(R)-based systems) or (PA-RISC,  Precision
       Architecture)  compiler for preprocessing, syntax and type checking, as
       well as for code generation.

       accepts several types of arguments as files:

       Arguments whose names end with
		   are understood to be C source files.	 Each file is compiled
		   and	the resulting object file is left in a file having the
		   corresponding base name, but suffixed with instead of  How‐
		   ever,  if a single C source file is compiled and linked all
		   in one step, the file is deleted.

       Arguments whose names end with
		   are understood to be assembly source files and  are	assem‐
		   bled, producing a file for each file.

       Arguments whose names end with
		   are taken to be preprocessed source files.  (See the option
		   below.)  Each object file is left in a file having the cor‐
		   responding name, but suffixed with instead of the suffix.

       Arguments of the form
		   cause  the linker to search the library (Itanium-based sys‐
		   tems) or (PA-RISC) or in an attempt	to  resolve  currently
		   unresolved  external	 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 (Itanium-based  sys‐
		   tems)  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 compiler through  the	 envi‐
       ronment	variable  as  well as on the command line.  The compiler 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 verti‐
       cal  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 compiler 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 (Itanium-based  systems)  or
       (PA-RISC).

       The following options are recognized by

       Suppress the link edit phase of the compilation,
		      and force an object file to be produced for each or file
		      even if only one program is compiled.  Object files pro‐
		      duced  from  C programs must be linked before being exe‐
		      cuted.

       Define	      name  to	the  preprocessor  pass,   as	if   by
		      '#define'.

       Preprocess named C files and send the result to standard output.

       Change the algorithm used by the preprocessor pass for
		      finding include files to also search in directory
		      dir.  See the HP C Online Help.

       The directory of the including file is no longer used as
		      the starting point to look up files enclosed with
		      double  quotes  They  start  at  the  first Files
		      enclosed with are looked up with the  paths  fol‐
		      lowing

       Refer to the   and  explanations (fourth and fifth items) in the
		      section.

       Change the algorithm used by the linker to search for
		      (Itanium-based  systems)	or  (PA-RISC)  or   The
		      option  causes ld to search in dir before search‐
		      ing 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  Specifies the name of the
		      object file when used with

       Preprocess     named C files and leave the result in correspond‐
		      ing files suffixed with

       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 option, the option
		      is  ignored, regardless of the order in which the
		      options were specified.

       Compile the named C files, and leave the
		      assembly language output in  corresponding  files
		      suffixed with

       Substitute or insert subprocess
		      x	 with  name  where x is one or more of a set of
		      identifiers indicating the subprocess(es).   This
		      option  works  in two modes:  1) if x is a single
		      identifier, name represents the full path name of
		      the  new	subprocess; 2) if x is a set of identi‐
		      fiers, name represents  a	 prefix	 to  which  the
		      standard	suffixes  are concatenated to construct
		      the full path names of the new subprocesses.

		      The x can take one or more of the values:

		      Assembler; standard suffix is

		      Compiler body; standard suffix is:
			   (Itanium-based systems), or
			   (PA-RISC)

		      Linker; standard suffix is

		      C preprocessor; standard suffix is

		      All subprocesses.

       Undefines any  name that has been defined prior to  the	prepro‐
		      cessing stage of compilation.

       Enable verbose mode, which produces a step-by-step description
		      of the compilation process on standard error.

       Display	the  version numbers of the current compiler and linker
       (if
		      the linker is executed).

       Suppress warning messages.

       Pass the comma-separated argument(s)
		      to subprocess x, where x can assume  one	of  the
		      values listed under the option as well as (driver
		      program) but not (all subprocesses).  The	 option
		      specification  allows additional, implementation-
		      specific options to be recognized by the compiler
		      driver.

   Itanium-based Systems Only Options
       Instead of using standard output for the
		      option,  place  the  output from each file into a
		      file with the corresponding .suffix.

       Do not bind anything to address zero.
		      This ld(1) option allows	run-time  detection  of
		      null  pointers.	See the note on pointers below.
		      (Itanium-based system only)

       Generate subprocess information for a given command line without
		      running the subprocesses.	 (Itanium-based systems
		      only)

       This option outputs the double quoted ("") enclosed include file
       dependency
		      information in the format for make(1).  With  the
		      output goes to stdout.  With the output goes to a
		      file with the suffix The directory and prefix  of
		      this  file  is the same as the object file, which
		      can be affected by the option.

		      NOTE:  Specify  to  suppress  generation	of  the
		      object  file.  In this case, no preprocessor out‐
		      put is generated.	 (Itanium-based systems only).

       Same as	      except both and enclosed include files are output
		      as dependencies.	(Itanium-based systems only).

       Disallow all anachronistic constructs.  Ordinarily the
		      compiler	gives warnings about anachronistic con‐
		      structs; using the option, the compiler will  not
		      compile code containing anachronistic constructs.
		      (Itanium-based systems only).

       Generate separate timing	 information  for  compilation	subpro‐
       cesses.
		      For  each subprocess, estimated time is generated
		      in seconds for user processes, system calls,  and
		      total  processing	 time.	 (Itanium-based systems
		      only).

       Treats "plain" char data type as unsigned char.
		      (Overloading and mangling are  unchanged.)   This
		      option  is  to  help in porting applications from
		      environments where unqualified (plain) char  type
		      is  treated  as  unsigned	 char  instead	of  the
		      default treatment	 as  signed  char.   Since  all
		      unqualified  char	 types	in the compilation unit
		      will be affected by this option (including  those
		      headers  that  define  external and system inter‐
		      faces) it is necessary to compile the  interfaces
		      used in a single program uniformly.

       Warn about all questionable constructs.	Without the
		      option,  the  compiler issues warnings only about
		      constructs that  are  almost  certainly  problems
		      (Itanium-based systems only).

       Selectively suppresses any specified warning messages, where
		      arg1 through argn are valid compiler warning mes‐
		      sage numbers.  (Itanium-based systems only).

       Selectively interpret any specified warning or future error mes‐
       sages as errors.
		      arg1 through argn are valid compiler message num‐
		      bers.  (Itanium-based systems only).

   System Dependent Options
       The compiler 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.  Defines __LP64__ to the preprocessor.

       Use the instruction scheduler tuned to the
	      model  specified.	  If  this option is not used, the com‐
	      piler uses the instruction scheduler for the architecture
	      on which the program is compiled.

   Options (other)
       Any  other  options that are not defined will generate a warning
       to standard error.

       Other arguments are taken to be HP C  compatible	 object	 files,
       typically produced by an earlier run, or perhaps libraries of HP
       cc 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 ini‐
       tialized	 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 variable.  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).

       allows you to set the maximum number of errors you want the com‐
       piler  to  report  before  it terminates compilation.  (Itanium-
       based systems only).

       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 compiler itself are intended to
       be self-explanatory.  Occasional messages may be produced by the
       assembler or the link editor.

       If  any	errors	occur  before is completed, a non-zero value is
       returned.  Otherwise, zero is returned.

DEPENDENCIES
       If is specified along with any of the above options, the	 option
       is  ignored,  regardless	 of the order in which the options were
       specified.

       Refer to the  System  Dependent	Options	 subsection  above  for
       information about operating system dependent options, for 32-bit
       or 64-bit data models and for the instruction scheduler.

FILES
       C input file

       previously preprocessed cc input file

       object file

       shared library, created with
	      on Itanium-based systems

       shared library, created with
	      on PA-RISC

       linked executable output file

       temporary files used by the compiler
	      (Itanium-based systems)

       temporary files used by the compiler
	      (PA-RISC systems) C driver

       C driver
	      C Compiler (Itanium-based systems)

       C Compiler
	      (PA-RISC systems)

       preprocessor, to assemble
	      files C compiler message catalog (Itanium-based systems)

       C compiler message catalog
	      (PA-RISC systems) assembler, as(1)

       link editor,
	      ld(1)

       Runtime startup
	      (PA-RISC systems)

       Standard directory for
	      files

   Other Libraries
       standard C library, see HP-UX Reference Section (3).   (Itanium-
       based systems)

       standard C library, see
	      HP-UX Reference Section (3).  (Itanium-based systems)

       Standard C library (archive version), see
	      HP-UX Reference Section (3).  (PA-RISC)

       Standard C library (shared version), see
	      HP-UX Reference Section (3).  (PA-RISC)

       Math Library
	      (Itanium-based system)

       Math Library
	      (Itanium-based systems)

       Math Library
	      (PA-RISC systems)

       Dynamic loader library
	      (Itanium-based systems)

       Dynamic loader library
	      (Itanium-based systems)

       Dynamic loader library
	      (PA-RISC systems)

       Dynamic loader
	      (Itanium-based systems)

       Dynamic loader
	      (Itanium-based systems)

       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  (Itanium-
       based systems) or (PA-RISC systems)

       Other topics available are: Compiler Pragmas, Floating Installa‐
       tion and Implementation Defined aspects of the compiler.

       Information is also available on the web at:

   Profiling and Debugging Tools
       gprof(1)	       display call graph profile data
       monitor(3C)     prepare execution profile
       wdb(1)	       C, C++ and Fortran symbolic debugger
       gdb(1)	       C, C++ and Fortran symbolic debugger
       adb(1)	       absolute debugger

   System Tools
       as(1)	       translate assembly code to machine code
       cpp(1)	       invoke the C language preprocessor
       cc(1)	       C 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
       American National Standard for Information Systems - Programming
       language C, ANS X3.159-1989.

       See the HP C Online help.

		  Bundled C Compiler - Limited Functionality	 cc_bundled(1)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net