8362501: Update test/hotspot/jtreg/applications/jcstress/README

[sendaoYan]

Hi all,

Currently, this is no documentation on how to run the application/jcstress tests. I think it will be useful to complement the document test/hotspot/jtreg/applications/jcstress/README on how to run the jcstress tests in jtreg.

No behaviour has been change, only update the ducumentation, no risk.

---

Progress

• Change must be properly reviewed (1 review required, with at least 1 Reviewer)
• Change must not contain extraneous whitespace
• Commit message must refer to an issue

Issue

• JDK-8362501: Update test/hotspot/jtreg/applications/jcstress/README (Enhancement - P4)

Reviewers

• Aleksey Shipilev (@shipilev - Reviewer)
• Leonid Mesnik (@lmesnik - Reviewer)

Reviewing

Using git

Checkout this PR locally:
$ git fetch https://git.openjdk.org/jdk.git pull/26369/head:pull/26369
$ git checkout pull/26369

Update a local copy of the PR:
$ git checkout pull/26369
$ git pull https://git.openjdk.org/jdk.git pull/26369/head

Using Skara CLI tools

Checkout this PR locally:
$ git pr checkout 26369

View PR using the GUI difftool:
$ git pr show -t 26369

Using diff file

Download this PR as a diff file:
https://git.openjdk.org/jdk/pull/26369.diff

Using Webrev

Link to Webrev Comment

[bridgekeeper]

👋 Welcome back syan! A progress list of the required criteria for merging this PR into master will be added to the body of your pull request. There are additional pull request commands available for use with this pull request.

[openjdk]

@sendaoYan This change now passes all automated pre-integration checks.

ℹ️ This project also has non-automated pre-integration requirements. Please see the file CONTRIBUTING.md for details.

After integration, the commit message for the final commit will be:

8362501: Update test/hotspot/jtreg/applications/jcstress/README

Reviewed-by: shade, lmesnik

You can use pull request commands such as /summary, /contributor and /issue to adjust it as needed.

At the time when this comment was updated there had been 139 new commits pushed to the master branch:

• a2e86ff: 8364037: Sort share includes: adlc, libadt, metaprogramming
• e2feff8: 8355177: Speed up StringBuilder::append(char[]) via Unsafe::copyMemory
• 16da81e: 8360817: [ubsan] zDirector select_worker_threads - outside the range of representable values issue
• ... and 136 more: https://git.openjdk.org/jdk/compare/1cde536b98f2ebde0c18c65dcbf26254ed402776...master

As there are no conflicts, your changes will automatically be rebased on top of these commits when integrating. If you prefer to avoid this automatic rebasing, please check the documentation for the /integrate command for further details.

➡️ To integrate this PR with the above commit message to the master branch, type /integrate in a new comment.

[openjdk]

@sendaoYan To determine the appropriate audience for reviewing this pull request, one or more labels corresponding to different subsystems will normally be applied automatically. However, no automatic labelling rule matches the changes in this pull request. In order to have an "RFR" email sent to the correct mailing list, you will need to add one or more applicable labels manually using the /label pull request command.

Applicable Labels

• build
• client
• compiler
• core-libs
• graal
• hotspot
• hotspot-compiler
• hotspot-gc
• hotspot-jfr
• hotspot-runtime
• i18n
• ide-support
• javadoc
• jdk
• jmx
• net
• nio
• security
• serviceability
• shenandoah

[sendaoYan]

/cc hotspot-runtime
/cc doc

[openjdk]

@sendaoYan
The hotspot-runtime label was successfully added.

[openjdk]

@sendaoYan
The label doc is not a valid label.
These labels are valid:

• graal
• serviceability
• hotspot
• hotspot-compiler
• ide-support
• i18n
• shenandoah
• jdk
• javadoc
• security
• hotspot-runtime
• jmx
• build
• nio
• client
• core-libs
• compiler
• net
• hotspot-gc
• hotspot-jfr

[mlbridge]

Webrevs

• 04: Full - Incremental (7b52c0b4)
• 03: Full - Incremental (3be2e7f7)
• 02: Full - Incremental (716b97c4)
• 01: Full - Incremental (d024994c)
• 00: Full (78320797)

[sendaoYan]

Hi @dholmes-ora ,can you review this PR again. The PR has been updated according your suggestions.

[dholmes-ora]

Grammatical updates look fine - one further one flagged. I can't review as such as I can't validate the instructions being given as I don't know how to run these tests.

Maybe @lmesnik could review?

[dholmes-ora]

Or @shipilev may be able to review?

[shipilev]

Or @shipilev may be able to review?

(slowly turns in his home office chair and stares curiously at his home server that produces jcstress binaries). Meh, I am on the fence on referencing 3rd party personal websites like mine. So I would defer to others if they are good with it.

[sendaoYan]

Or @shipilev may be able to review?

(slowly turns in his home office chair and stares curiously at his home server that produces jcstress binaries). Meh, I am on the fence on referencing 3rd party personal websites like mine. So I would defer to others if they are good with it.

The README.md in jcstress repo has already referenced your website~

[sendaoYan]

Or @shipilev may be able to review?

(slowly turns in his home office chair and stares curiously at his home server that produces jcstress binaries). Meh, I am on the fence on referencing 3rd party personal websites like mine. So I would defer to others if they are good with it.

I have removed the 3rd party personal websites.

[shipilev]

Looks better. I think we can be less specific in the guidance, see below.

[sendaoYan]

Thanks @shipilev

[sendaoYan]

Looking for 2rd reviewer.

[sendaoYan]

Thanks for the reviews and suggestions @dholmes-ora @shipilev @lmesnik

/integrate

[openjdk]

Going to push as commit 559795b.
Since your change was applied there have been 142 commits pushed to the master branch:

• 413ac74: 8357682: sun.security.provider.certpath.Builder#getMatchingPolicies always returns null
• 3bdac53: 8361212: Remove AffirmTrust root CAs
• 57d02d9: 8362279: [vectorapi] VECTOR_OP_SUADD needs reduction support
• ... and 139 more: https://git.openjdk.org/jdk/compare/1cde536b98f2ebde0c18c65dcbf26254ed402776...master

Your commit was automatically rebased without conflicts.

[openjdk]

@sendaoYan Pushed as commit 559795b.

💡 You may see a message that your pull request was closed with unmerged commits. This can be safely ignored.