Skip to content

Commit ac00cf6

Browse files
committed
Update documentation.
1 parent c3916c2 commit ac00cf6

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

substratevm/src/com.oracle.svm.core/src/com/oracle/svm/core/imagelayer/NativeImageLayers.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -93,10 +93,10 @@ In the future we will eventually provide a solution to refine the resource inclu
9393

9494
##### `--layer-create` suboption `package=<package-name>`
9595

96-
Suboption `package` allows the inclusion of individual Java packages. For this kind of inclusion it does not matter if the specified package is from a classpath-entry or part of a module, both are supported.
96+
Suboption `package` allows the inclusion of individual Java packages. For this kind of inclusion it does not matter if the specified package is from a classpath entry or part of a module, both are supported.
9797
Contrary to the `module` suboption, resources are not also automatically included. If resource inclusion is needed, the usual ways can be used (`resource-config.json`, `reachability-metadata.json` or resource related Feature API).
9898

99-
##### `--layer-create` suboption `path=<classpath entry>`
99+
##### `--layer-create` suboption `path=<classpath-entry>`
100100

101101
This is a convenience suboption that requires a `classpath entry`.
102102
If the provided entry is not also specified in the classpath of the given `native-image` invocation, an error message is shown.
@@ -207,13 +207,15 @@ At build time a shared layer is stored in a layer archive that contains the foll
207207

208208
```shell
209209
[shared-layer.nil] # shared layer archive file
210-
├── shared-layer.json # snapshot of the shared layer metadata; used by subsequent build processes
210+
├── shared-layer.lsb # snapshot of the shared layer metadata; used by subsequent build processes
211+
├── shared-layer.big # serialized shared layer compiler graphs; used by subsequent build processes
211212
├── shared-layer.so # shared object of the shared layer; used by subsequent build processes and at run time
212213
└── shared-layer.properties # contains info about layer input data
213214
```
214215

215216
The layer snapshot file will be consumed by subsequent build processes that depend on this layer.
216217
It contains Native Image metadata, such as the analysis universe and available image singletons.
218+
Sharing compiler graphs between layers enables cross-layer optimizations such as inlining.
217219
The shared object file will be used at build time for symbol resolution, and at run time for application execution.
218220
The layer properties file contains metadata that uniquely identifies this layer: the options used to create the
219221
layer, all the input files and their checksum.

0 commit comments

Comments
 (0)