Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8280543

Update the "java" and "jcmd" tool specification for CDS

    XMLWordPrintable

Details

    • b08

    Backports

      Description

        [1] Warnings text for -Xshare:cds should be updated - similar to JDK-8277241

        [2] In the "java" tool specification, under the "Creating a Shared Archive File and Using It to Run an Application", we should add information about creating CDS archives using the "jcmd" command.

        Also, since there are several methods for creating a CDS archive (-Xshare:dump vs -XX:CreateArchiveAtExit vs jcmd), we should add an overview section to compare the different methods.

        Some clean up is needed:

        - Discussion of obsolete flags (such as -XX:UseAppCDS) should be removed.

        - Discussion of uncommon error conditions (such as array classes in the classlist) should also be removed.

        (Current version: https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#application-class-data-sharing )

        [3] The "jcmd" tool specification currently has only minimal documentation for the "VM.cds" command. More details should be added.

        (Current version:
        https://docs.oracle.com/en/java/javase/17/docs/specs/man/jcmd.html )

        Attachments

          Issue Links

            backported by

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8281570 Update the "java" and "jcmd" tool specification for CDS

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8283545 Update the "java" and "jcmd" tool specification for CDS

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved
            relates to

            Bug - A problem which impairs or prevents the functions of the product. JDK-8277241 java -Xshare:on document needs to be updated

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved

            Enhancement - null JDK-8259070 Add jcmd option to dump CDS

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved

            Enhancement - null JDK-8277242 CDS docs should discuss dumping with jcmd VM.cds

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved
            links to

            Commit Commit openjdk/jdk17u-dev/d6eb2818

            Commit Commit openjdk/jdk/39165613

            Review Review openjdk/jdk17u-dev/277

            Review Review openjdk/jdk/7255

            Activity

              People

                iklam Ioi Lam
                iklam Ioi Lam
                Votes:
                0 Vote for this issue
                Watchers:
                4 Start watching this issue

                Dates

                  Created:
                  Updated:
                  Resolved: