RFR: 8328914: Document the java.security.debug property in javadoc [v10]

Sean Mullan mullan at openjdk.org
Fri Feb 28 21:34:57 UTC 2025


On Tue, 25 Feb 2025 18:53:34 GMT, Koushik Muthukrishnan Thirupattur <duke at openjdk.org> wrote:

>> java.security.debug is a widely used debug system property for JDK security libs. It's time to capture details about this property via javadoc.
>> 
>> ![image](https://github.com/user-attachments/assets/0c9a79f3-4cb2-414c-af1d-eac2590740ea)
>> 
>> 
>> NOTE : We are adding a new html file (similar to the Networking Properties [here](https://download.java.net/java/early_access/jdk25/docs/api/java.base/java/net/doc-files/net-properties.html#networking-properties-heading)) for documenting security-related properties, and over time, we will add more properties to this page.
>
> Koushik Muthukrishnan Thirupattur has updated the pull request incrementally with one additional commit since the last revision:
> 
>   8328914: Document the java.security.debug property in javadoc

src/java.base/share/classes/java/security/doc-files/security-related-system-properties.html line 75:

> 73:     set the <code>java.security.debug</code> system property on the command line as follows:
> 74:     <pre><code>java -Djava.security.debug=all+thread+timestamp MyApp</code></pre>
> 75:         <p> To monitor security access, you can set the <code>java.security.debug</code> system property,

This paragraph should be first, before the "Printing Thread and Timestamp Information" section. It describe the general syntax of the property, whereas the thread and timestamp are more specific options.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/23569#discussion_r1976031081


More information about the security-dev mailing list