Document the user namespace files that report the mapping of uids and gids between user namespaces. Signed-off-by: "Eric W. Biederman" <ebiederm@xxxxxxxxxxxx> --- man5/proc.5 | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 50 insertions(+), 0 deletions(-) diff --git a/man5/proc.5 b/man5/proc.5 index fb70d2b..840480d 100644 --- a/man5/proc.5 +++ b/man5/proc.5 @@ -317,6 +317,31 @@ The files in this directory are readable only by the owner of the process. .\" .TP .\" .IR /proc/[pid]/io " (since kernel 2.6.20)" .TP +.IR /proc/[pid]/gid_map " (since kernel 3.6)" +This file reports the mapping of gids from the user namespace of the process specified by +.IR pid +to the user namespace of the process that opened +.IR /proc/[pid]/gid_map . + +Each line specifies a 1 to 1 mapping of a range of contiguous gids from +the user namespace of the process specified by +.IR pid +to the user namespace of the process that opened +.IR /proc/[pid]/gid_map. + +Each line contains three numbers. The start of the range of gids in +the user namespace of the process specifed by +.IR pid. +The start of the range of gids in the user namespace of the process that +opened +.IR /proc/[pid]/gid_map. +The number of gids in the range of numbers that is mapped between to two +user namespaces. + +After the creation of a new user namespace this file may be written to +exactly once to specify the mapping of gids in the new user namespace. + +.TP .IR /proc/[pid]/limits " (since kernel 2.6.24)" This file displays the soft limit, hard limit, and units of measurement for each of the process's resource limits (see @@ -1169,6 +1194,31 @@ directory are not available if the main thread has already terminated (typically by calling .BR pthread_exit (3)). .TP +.IR /proc/[pid]/uid_map " (since kernel 3.6)" +This file reports the mapping of uids from the user namespace of the process specified by +.IR pid +to the user namespace of the process that opened +.IR /proc/[pid]/uid_map . + +Each line specifies a 1 to 1 mapping of a range of contiguous uids from +the user namespace of the process specified by +.IR pid +to the user namespace of the process that opened +.IR /proc/[pid]/uid_map. + +Each line contains three numbers. The start of the range of uids in +the user namespace of the process specifed by +.IR pid. +The start of the range of uids in the user namespace of the process that +opened +.IR /proc/[pid]/uid_map. +The number of uids in the range of numbers that is mapped between to two +user namespaces. + +After the creation of a new user namespace this file may be written to +exactly once to specify the mapping of uids in the new user namespace. + +.TP .I /proc/apm Advanced power management version and battery information when .B CONFIG_APM -- 1.7.5.4 _______________________________________________ Containers mailing list Containers@xxxxxxxxxxxxxxxxxxxxxxxxxx https://lists.linuxfoundation.org/mailman/listinfo/containers
