← 返回命令列表

Linux command

apptainer-run-help 命令

文本

复制后可按需替换文件名、目录或参数。

常用示例

Display the run-help for a container

apptainer run-help [container.sif]

Show help for a specific app inside a container

apptainer run-help --app [appname] [container.sif]

Show help for a Docker Hub image

apptainer run-help docker://[image:tag]

Display help from a library image

apptainer run-help library://[user/collection/image:tag]

说明

apptainer run-help displays help text embedded within an Apptainer/Singularity container. This help information is defined during container build time using the %help section in a definition file. When the --app flag is used, it displays help from the specified app's %apphelp section instead. Container authors use the %help section to document how to use their container, including expected arguments, required bind mounts, environment variables, and example commands. This provides users with container-specific usage information without needing external documentation. When called on a container without a help section, the command returns with no output. The help text is stored in the container's metadata and does not affect the container's runtime size significantly. This command is particularly useful in HPC environments where users may encounter unfamiliar containers and need quick usage guidance. It complements apptainer inspect which shows technical metadata rather than user-facing documentation.

参数

--app _string_
Show the help for a specific app defined in the container rather than the general container help. The help text comes from the app's %apphelp section.
-h, --help
Display help for the run-help command.

FAQ

What is the apptainer-run-help command used for?

apptainer run-help displays help text embedded within an Apptainer/Singularity container. This help information is defined during container build time using the %help section in a definition file. When the --app flag is used, it displays help from the specified app's %apphelp section instead. Container authors use the %help section to document how to use their container, including expected arguments, required bind mounts, environment variables, and example commands. This provides users with container-specific usage information without needing external documentation. When called on a container without a help section, the command returns with no output. The help text is stored in the container's metadata and does not affect the container's runtime size significantly. This command is particularly useful in HPC environments where users may encounter unfamiliar containers and need quick usage guidance. It complements apptainer inspect which shows technical metadata rather than user-facing documentation.

How do I run a basic apptainer-run-help example?

Run `apptainer run-help [container.sif]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does --app _string_ do in apptainer-run-help?

Show the help for a specific app defined in the container rather than the general container help. The help text comes from the app's %apphelp section.