xbps-uchroot(8): now with a manual page.

bin/xbps-uchroot/Makefile

@@ -2,6 +2,5 @@ TOPDIR = ../..
 -include $(TOPDIR)/config.mk
 
 BIN = xbps-uchroot
-MAN =
 
 include $(TOPDIR)/mk/prog.mk

bin/xbps-uchroot/xbps-uchroot.8

@@ -0,0 +1,67 @@
+.Dd April 18, 2014
+.Os Void Linux
+.Dt xbps-uchroot 8
+.Sh NAME
+.Nm xbps-uchroot
+.Nd XBPS utility to chroot and bind mount with linux namespaces
+.Sh SYNOPSYS
+.Nm xbps-uchroot
+.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 .
+The
+.Nm
+utility uses by default Linux namespaces to isolate IPC, PIDs and mounts to
+the calling process. If running in a OpenVZ container, these namespace features
+are simply disabled.
+.Sh OPTIONS
+.Bl -tag -width -x
+.It Fl D Ar dir
+Specifies a full path to a directory that will be bind mounted at
+.Ar CHROOTDIR/xbps-packages .
+.It Fl H Ar dir
+Specifies a full path to a directory that will be bind mounted at
+.Ar CHROOTDIR/host .
+.It Fl S Ar dir
+Specifies a full path to a directory to allow shm functionality to be used
+in the target
+.Ar CHROOTDIR/dir .
+If your system uses
+.Sy /dev/shm
+use it, otherwise use
+.Sy /run/shm .
+.Sh SECURITY
+The
+.Nm
+executable must be setgid to function properly and shall only be executable by a specific
+group to avoid security issues (4750).
+.Sh NOTES
+The
+.Nm
+utility uses Linux specific features (namespaces) and it's not meant to be portable to
+other Operating Systems.
+.Sh SEE ALSO
+.Xr xbps-checkvers 8 ,
+.Xr xbps-create 8 ,
+.Xr xbps-dgraph 8 ,
+.Xr xbps-install 8 ,
+.Xr xbps-pkgdb 8 ,
+.Xr xbps-query 8 ,
+.Xr xbps-reconfigure 8 ,
+.Xr xbps-rindex 8
+.Sh AUTHORS
+.An Juan Romero Pardines <xtraeme@gmail.com>
+.Sh BUGS
+Probably, but I try to make this not happen. Use it under your own
+responsability and enjoy your life.
+.Pp
+Report bugs in https://github.com/voidlinux/xbps/issues