From Documentation
Jump to: navigation, search
m (Version Selection)
Line 60: Line 60:
=General Notes=
To test ...
<pre>ssh "module load proot; proot -V | head -n 20"</br>
o PRoot Homepage:
o PRoot Homepage:

Revision as of 18:46, 18 January 2016

Description: PRoot is a user-space implementation of chroot, mount --bind, and binfmt_misc.
SHARCNET Package information: see PROOT software page in web portal
Full list of SHARCNET supported software


PRoot is a user-space implementation of the following superuser-only operations: chroot, mount --bind, and binfmt_misc. In practical terms, on SHARCNET, PRoot enables the users to do the following within their own account without any privileged (e.g., superuser) access:

  1. a user can install and run most any Linux distributions from a directory in the user's disk space (using only normal user permissions), and,
  2. a user can run a program that needs read/write/executable permissions for a path they cannot by mapping that path to one where they can.

In practice, item (1) means the following:

  • a user can use easy-to-install programs from a specific Linux distribution,
  • a user can use tools dependent on a different (modern) GLIBC,
  • a user can avoid upgrading the Linux distribution once things work to avoid "breaking" or altering the program and how it works,
  • a user can easily run older or newer programs that what is installed on SHARCNET,
  • programs run within PRoot are largely immune to operating system and software changes made to the system.

In practice, item (2) means the following:

  • a user can use programs perform read, write, or execute operations to/from locations that cannot be read, written, or executed by that user,
    • NOTE: This is done by mapping the path associated with the inaccessible location to a path that the user can access (e.g., /home/username/somedirectory).

There are some non-onerous conditions:

  • chroot and PRoot cannot be used within a PRoot session.
  • This should only be used for programs that do not require to be run as daemons (where special privileges are required to run the daemon).
  • Superuser (i.e., root) access is all fake --everything is run in the user account with only the user account's permissions. Anything that the user account is not allowed to do, is simply not allowed.
  • To use PRoot with batch-oriented queuing systems (e.g., sqsub) a script is needed (i.e., see below) to run those programs (which must be run inside the PRoot shell session).

In general, however, PRoot will allow one to run virtually all programs that can be run without using any special permissions.

Version Selection

Version 5.1.0

module load proot/5.1.0


Using Pre-Existing Linux Distribution Images

Installing a Linux Distribution From Scratch


Cluster (Batch-oriented)

TODO: To submit a job to the serial queue use:

 TODO: sqsub -r 10m --mpp=2G -o ofile.%J ./a.out



TODO: There is no graphical usage component for this software package --although one is free to install graphical programs within the image. To use such images: ...


General Notes

To test ...

ssh "module load proot; proot -V | head -n 20"</br>


o PRoot Homepage: