Skip to content

Commit

Permalink
crun.1.md: add lsm-profile and lsm-mount-context
Browse files Browse the repository at this point in the history
This pull request updates the man page with description for the
`--lsm-profile` and `--lsm-mount-context` options introduced in
#1578

Signed-off-by: Radostin Stoyanov <[email protected]>
  • Loading branch information
rst0git committed Oct 21, 2024
1 parent 093ed74 commit 4146129
Show file tree
Hide file tree
Showing 2 changed files with 29 additions and 1 deletion.
19 changes: 18 additions & 1 deletion crun.1
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
'\" t
.nh
.TH crun 1 "User Commands"

Expand Down Expand Up @@ -498,6 +497,19 @@ Where to write the PID of the container
Specify which CRIU manage cgroup mode should be used. Permitted values are
\fBsoft\fP, \fBignore\fP, \fBfull\fP or \fBstrict\fP\&. Default is \fBsoft\fP\&.

.PP
\fB--lsm-profile\fP=\fITYPE\fP:\fINAME\fP
Specify an LSM profile to be used during restore.
\fITYPE\fP can be either \fBapparmor\fP or \fBselinux\fP\&.

.PP
\fB--lsm-mount-context\fP=\fIVALUE\fP
Specify a new LSM mount context to be used during restore.
This option replaces an existing mount context information
with the specified value. This is useful when restoring
a container into an existing Pod and selinux labels
need to be changed during restore.


.SH Extensions to OCI
.SH \fBrun.oci.mount_context_type=context\fR
Expand Down Expand Up @@ -582,6 +594,7 @@ For example, as root:
mkdir /sys/fs/cgroup/systemd
mount cgroup -t cgroup /sys/fs/cgroup/systemd -o none,name=systemd,xattr
chown -R the_user.the_user /sys/fs/cgroup/systemd
.EE

.SH \fBrun.oci.systemd.subgroup=SUBGROUP\fR
Expand All @@ -591,6 +604,7 @@ scope, so the final cgroup will be like:

.EX
/sys/fs/cgroup/$PATH/$SUBGROUP
.EE

.PP
Expand All @@ -605,6 +619,7 @@ e.g.

.EX
/sys/fs/cgroup//system.slice/foo-352700.scope/container
.EE

.SH \fBrun.oci.delegate-cgroup=DELEGATED-CGROUP\fR
Expand All @@ -618,6 +633,7 @@ moving the container to the delegated cgroup.

.EX
/sys/fs/cgroup/$PATH/$SUBGROUP/$DELEGATED-CGROUP
.EE

.PP
Expand Down Expand Up @@ -794,6 +810,7 @@ For example, the mapping: \fBuids=@1-3-10\fR, given a configuration like
"size": 1000
}
]
.EE

.PP
Expand Down
11 changes: 11 additions & 0 deletions crun.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -390,6 +390,17 @@ Where to write the PID of the container
Specify which CRIU manage cgroup mode should be used. Permitted values are
**soft**, **ignore**, **full** or **strict**. Default is **soft**.

**--lsm-profile**=_TYPE_:_NAME_
Specify an LSM profile to be used during restore.
_TYPE_ can be either **apparmor** or **selinux**.

**--lsm-mount-context**=_VALUE_
Specify a new LSM mount context to be used during restore.
This option replaces an existing mount context information
with the specified value. This is useful when restoring
a container into an existing Pod and selinux labels
need to be changed during restore.

# Extensions to OCI

## `run.oci.mount_context_type=context`
Expand Down

0 comments on commit 4146129

Please sign in to comment.