blob: c3417a9ba08d368b4a072d622aca851f575098b1 [file] [view] [edit]
# llvm-extract-bundle-entry - extract an offload bundle entry
```{program} llvm-extract-bundle-entry
```
## SYNOPSIS
{program}`llvm-extract-bundle-entry` \[*options*\] URI
## DESCRIPTION
{program}`llvm-extract-offload-entry` is a tool thet takes a URI argument and
generates a code object file by extracting an offload bundle entry specified
by the URI given.
The URI syntax is defined as:
```{code-block} bnf
<code_object_uri> ::= <file_uri> | <memory_uri>
<file_uri> ::= "file://"<extract_file><range_specifier>
<memory_uri> ::= "memory://"<process_id><range_specifier>
<range_specifier> ::= [ "#" | "?" ]"offset="<number>"&size="<number>
<extract_file> ::= URI_ENCODED_OS_FILE_PATH
<process_id> ::= DECIMAL_NUMBER
<number> ::= DECIMAL_NUMBER
```
The output is always written to a file, whose name is generated from the URI input given.
## OPTIONS
The following options are either agnostic of the file format or apply to
multiple file formats.
:::{option} --help, -h
Print a summary of command line options.
:::
:::{option} -o <file>
Write output to \<file>. Multiple input files cannot be used in combination
with -o.
:::
:::{option} --version, -V
Display the version of the {program}`llvm-extract-bundle-entry` executable.
:::
## EXIT STATUS
{program}`llvm-extract-bundle-entry` exits with a non-zero exit code if there is an error.
Otherwise, it exits with code 0.
## BUGS
To report bugs, please visit \<<https://github.com/llvm/llvm-project/issues?q=state%3Aopen%20label%3Allvm-extract-bundle-entry>>.