make/README.pre-components
author ysr
Mon, 16 Aug 2010 15:58:42 -0700
changeset 6258 68f252c6e825
parent 3305 7ca56c8ba510
permissions -rw-r--r--
6948538: CMS: BOT walkers can fall into object allocation and initialization cracks Summary: GC workers now recognize an intermediate transient state of blocks which are allocated but have not yet completed initialization. blk_start() calls do not attempt to determine the size of a block in the transient state, rather waiting for the block to become initialized so that it is safe to query its size. Audited and ensured the order of initialization of object fields (klass, free bit and size) to respect block state transition protocol. Also included some new assertion checking code enabled in debug mode. Reviewed-by: chrisphi, johnc, poonam
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
     1
README-pre-components:
fd16c54261b3 Initial load
duke
parents:
diff changeset
     2
---------------------
fd16c54261b3 Initial load
duke
parents:
diff changeset
     3
Current pre-components are langtools, jaxws, jaxp, and corba.
fd16c54261b3 Initial load
duke
parents:
diff changeset
     4
fd16c54261b3 Initial load
duke
parents:
diff changeset
     5
Pre-components can use ant to build but must have a make/Makefile for
fd16c54261b3 Initial load
duke
parents:
diff changeset
     6
building (a GNU make Makefile).
fd16c54261b3 Initial load
duke
parents:
diff changeset
     7
All ant knowledge is being isolated in the workspaces that use it.
fd16c54261b3 Initial load
duke
parents:
diff changeset
     8
fd16c54261b3 Initial load
duke
parents:
diff changeset
     9
Also for various reasons it is nice to have a Makefile wrapper over the
fd16c54261b3 Initial load
duke
parents:
diff changeset
    10
running of ant, but in general having to do
fd16c54261b3 Initial load
duke
parents:
diff changeset
    11
anything with shell commands is much easier to do in a Makefile
fd16c54261b3 Initial load
duke
parents:
diff changeset
    12
than in an ant script.
fd16c54261b3 Initial load
duke
parents:
diff changeset
    13
fd16c54261b3 Initial load
duke
parents:
diff changeset
    14
The make/makefile rules are:
fd16c54261b3 Initial load
duke
parents:
diff changeset
    15
fd16c54261b3 Initial load
duke
parents:
diff changeset
    16
 Variables:
fd16c54261b3 Initial load
duke
parents:
diff changeset
    17
  ALT_BOOTDIR           The jdk home to use to build, if provided
fd16c54261b3 Initial load
duke
parents:
diff changeset
    18
  ALT_LANGTOOLS_DIST    The dist area from a langtools build to use, if provided
fd16c54261b3 Initial load
duke
parents:
diff changeset
    19
  ALT_OUTPUTDIR         Parent dir of build and dist directories, if provided
fd16c54261b3 Initial load
duke
parents:
diff changeset
    20
  VARIANT               If DBG, debug build, if OPT, optimized build
3305
7ca56c8ba510 6854244: change source/target used to compile JDK to 7
jjg
parents: 1117
diff changeset
    21
  TARGET_CLASS_VERSION  The classfile version number (currently 7)
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    22
  ANT_HOME              Home of ant to use, if provided
fd16c54261b3 Initial load
duke
parents:
diff changeset
    23
  QUIET                 If defined, be quiet
fd16c54261b3 Initial load
duke
parents:
diff changeset
    24
  VERBOSE               If defined, be verbose
fd16c54261b3 Initial load
duke
parents:
diff changeset
    25
  JDK_VERSION           Version being built
fd16c54261b3 Initial load
duke
parents:
diff changeset
    26
  FULL_VERSION          Full version string for this jdk build
fd16c54261b3 Initial load
duke
parents:
diff changeset
    27
  MILESTONE             fcs, beta, internal or empty
fd16c54261b3 Initial load
duke
parents:
diff changeset
    28
  BUILD_NUMBER          Number of the jdk build
fd16c54261b3 Initial load
duke
parents:
diff changeset
    29
  JPRT_ARCHIVE_BUNDLE   Path to zip bundle to create for JPRT
fd16c54261b3 Initial load
duke
parents:
diff changeset
    30
fd16c54261b3 Initial load
duke
parents:
diff changeset
    31
 Targets:
fd16c54261b3 Initial load
duke
parents:
diff changeset
    32
  all                   Build everything, including dist
fd16c54261b3 Initial load
duke
parents:
diff changeset
    33
  build                 Build build area
fd16c54261b3 Initial load
duke
parents:
diff changeset
    34
  clean                 Clean up
fd16c54261b3 Initial load
duke
parents:
diff changeset
    35
  clobber               Same as clean (don't ask)
fd16c54261b3 Initial load
duke
parents:
diff changeset
    36
  sanity                Perform any sanity checks, exit non-zero if errors
fd16c54261b3 Initial load
duke
parents:
diff changeset
    37
  jprt_build_product    JPRT product build, zip results into JPRT_ARCHIVE_BUNDLE
fd16c54261b3 Initial load
duke
parents:
diff changeset
    38
  jprt_build_debug      JPRT debug build, zip results into JPRT_ARCHIVE_BUNDLE
fd16c54261b3 Initial load
duke
parents:
diff changeset
    39
  jprt_build_fastdebug  JPRT fastdebug build, zip results into JPRT_ARCHIVE_BUNDLE
fd16c54261b3 Initial load
duke
parents:
diff changeset
    40
fd16c54261b3 Initial load
duke
parents:
diff changeset
    41
Then of course we expect a dist/lib/classes.jar, dist/lib/src.zip and dist/lib/bin.zip.