06fbbba2e5
- use `.Os` to show "Void Linux" in the footer - use `Aq Mt` to display email addresses - use `.Lk` for the bug link - remove unnecessary use of `.Nm <name>` when already defined - add xbps-alternatives(1) to SEE ALSO where missing - bump date
83 lines
1.8 KiB
Groff
83 lines
1.8 KiB
Groff
.Dd Feb 9, 2023
|
|
.Dt XBPS-UUNSHARE 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm xbps-uunshare
|
|
.Nd XBPS utility to chroot and bind mount with Linux user namespaces
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op OPTIONS
|
|
.Ar CHROOTDIR
|
|
.Ar COMMAND
|
|
.Op ARGS
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility allows users to chroot and bind mount required pseudo-filesystems
|
|
(/dev, /proc and /sys) in the target
|
|
.Ar CHROOTDIR
|
|
to execute
|
|
.Ar COMMAND .
|
|
.Pp
|
|
The
|
|
.Nm
|
|
utility uses by default Linux namespaces to isolate IPC, PIDs and mounts to
|
|
the calling process. Thanks to
|
|
.Xr user_namespaces 7
|
|
the user does not need any privilege to create an isolated lightweight container.
|
|
.Sh OPTIONS
|
|
.Bl -tag -width -x
|
|
.It Fl b Ar src:dest
|
|
Bind mounts
|
|
.Ar src
|
|
into
|
|
.Ar CHROOTDIR/dest .
|
|
This option may be specified multiple times.
|
|
Please note that both
|
|
.Ar src
|
|
and
|
|
.Ar dest
|
|
must be absolute paths and must exist.
|
|
.It Fl -
|
|
Stop interpreting following arguments as options.
|
|
This option is useful if some of
|
|
.Ar ARGS
|
|
are options passed to
|
|
.Ar COMMAND .
|
|
.El
|
|
.Sh NOTES
|
|
The
|
|
.Nm
|
|
utility uses Linux specific features (namespaces) and it's not meant to be portable to
|
|
other Operating Systems. The following kernel options must be enabled:
|
|
.Pp
|
|
.Bl -tag -width CONFIG_NAMESPACES -compact -offset indent
|
|
.It Sy CONFIG_NAMESPACES
|
|
.It Sy CONFIG_IPC_NS
|
|
.It Sy CONFIG_USER_NS
|
|
.It Sy CONFIG_UTS_NS
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr xbps-alternatives 1 ,
|
|
.Xr xbps-checkvers 1 ,
|
|
.Xr xbps-create 1 ,
|
|
.Xr xbps-dgraph 1 ,
|
|
.Xr xbps-digest 1 ,
|
|
.Xr xbps-fbulk 1 ,
|
|
.Xr xbps-fetch 1 ,
|
|
.Xr xbps-install 1 ,
|
|
.Xr xbps-pkgdb 1 ,
|
|
.Xr xbps-query 1 ,
|
|
.Xr xbps-reconfigure 1 ,
|
|
.Xr xbps-rindex 1 ,
|
|
.Xr xbps-uchroot 1 ,
|
|
.Xr xbps.d 5
|
|
.Sh AUTHORS
|
|
.An Juan Romero Pardines Aq Mt xtraeme@gmail.com
|
|
.Sh BUGS
|
|
Probably, but I try to make this not happen. Use it under your own
|
|
responsibility and enjoy your life.
|
|
.Pp
|
|
Report bugs at
|
|
.Lk https://github.com/void-linux/xbps/issues
|