diff --git a/docs/reference-manual/native-image/BuildOutput.md b/docs/reference-manual/native-image/BuildOutput.md index dff527cf4fc6..2c08aea59f75 100644 --- a/docs/reference-manual/native-image/BuildOutput.md +++ b/docs/reference-manual/native-image/BuildOutput.md @@ -256,10 +256,14 @@ This data typically contains internal information for Native Image and should no This shows whether Java deserialization is included in the native executable or not. If not included, the attack surface of the executable is reduced as the executable cannot be exploited with attacks based on Java deserialization. -#### Embedded SBOM -Number of components and the size of the embedded Software Bill of Materials (SBOM). -Use `--enable-sbom` to include an SBOM in the native executable. -For more information, see [Inspection Tool](InspectTool.md) +#### Software Bill of Material (SBOM) +This section indicates whether a SBOM was assembled and in what ways it was stored. +The storage formats include: `embed`, which embeds the SBOM in the binary; `classpath`, which saves the SBOM to the classpath; and `export`, which includes the SBOM as a JSON build artifact. +Use `--enable-sbom` to activate this feature which defaults to the `embed` option. +When embedded, the SBOM size is displayed. +The number of components is always displayed. + +For more information, see [Software Bill of Materials](../../security/native-image.md). #### Backwards-Edge Control-Flow Integrity (CFI) Control-Flow Integrity (CFI) can be enforced with the experimental `-H:CFI=HW` option. diff --git a/docs/security/native-image.md b/docs/security/native-image.md index 5c1227eb9084..1b68d5747849 100644 --- a/docs/security/native-image.md +++ b/docs/security/native-image.md @@ -23,8 +23,9 @@ Developers should run the `native-image` builder in a dedicated environment, suc ## Software Bill of Materials -GraalVM Native Image can embed a Software Bill of Materials (SBOM) at build time to detect any libraries that may be susceptible to known security vulnerabilities. -Native Image provides the `--enable-sbom` option to embed an SBOM into a native executable (only available in Oracle GraalVM). +GraalVM Native Image can assemble a Software Bill of Materials (SBOM) at build time to detect any libraries that may be susceptible to known security vulnerabilities. +Native Image provides the `--enable-sbom` option to embed an SBOM into a native executable (only available in Oracle GraalVM). +In addition to being embedded, the SBOM can be added to the classpath or exported as a JSON by using `--enable-sbom=classpath,export`. The CycloneDX format is supported and the default. To embed a CycloneDX SBOM into a native executable, pass the `--enable-sbom` option to the `native-image` command.