% ll-cli-run 1

NAME

ll-cli-run - Run applications

SYNOPSIS

ll-cli run [options] app [command...]

DESCRIPTION

The ll-cli run command can start a Linyaps application. This command supports running applications by name, or executing commands in the container instead of running the application.

Advanced users can use the ll-cli runtime configuration to persist environment variables, mounts, devices, and instances globally or for one application.

OPTIONS

-h, --help : Print help information and exit

--help-all : Expand all help information

--file FILES:FILE... : Pass files to the application running in the sandbox

--url URLS... : Pass URLs to the application running in the sandbox

--env ENV... : Set environment variables for the application (format: KEY=VALUE)

--base REF : Specify the base environment used for application execution

--runtime REF : Specify the runtime used for application execution

--workdir PATH : Specify the application's working directory

--extensions REF... : Specify extensions used for application execution (multiple extensions separated by commas)

--enable-xdp, --disable-xdp : Enable or disable xdg-desktop-portal integration in the sandbox; if both are specified, the last option takes effect

--enable-pipewire : Mount the PipeWire socket in the sandbox

--cdi-spec-dir DIR... : Specify CDI specification directories, defaulting to /etc/cdi,/var/run/cdi; separate multiple directories with commas

--device DEVICE... : Add CDI devices, separated by commas

--device-mode MODE... : Specify device modes; passthru is currently supported. Separate multiple modes with commas

--instance NAME : Specify a container instance name to identify or reuse an instance

--debug : Start the application with gdbserver

--debug-listen ADDR [:2345] : Specify the gdbserver listen address; must be used with --debug

--debug-debuginfod URLS : Specify debuginfod URLs for debugging; must be used with --debug

--debug-symbol-dir DIR : Specify the directory from which GDB loads debug symbols; must be used with --debug

POSITIONAL ARGUMENTS

APP TEXT REQUIRED : Specify the application name

COMMAND TEXT... : Run commands in the running sandbox

EXAMPLES

Run application by name:

ll-cli run org.deepin.demo

Execute commands in the container instead of running the application:

ll-cli run org.deepin.demo bash
ll-cli run org.deepin.demo -- bash
ll-cli run org.deepin.demo -- bash -x /path/to/bash/script

SEE ALSO

ll-cli(1), ll-cli-ps(1), ll-cli-enter(1)

HISTORY

Developed in 2023 by UnionTech Software Technology Co., Ltd.